前言
制作cocoapods私有仓库 首先是依赖库的制作,然后才是cocoapods私有仓库的制作
依赖库的制作的制作核心则是.podspec 的制作 。cocoapods私有仓库是负责管理这些.podspec 的仓库
下面以TestDemo2为例,记录依赖库的制作。
1.git仓库建立
cocoapods 是托管在github上的,这里我们使用国内的git仓库码云作为托管仓库平台
图中8个地方:
1.项目名称,也就是依赖库的名称,必填项
2.搜索路径,也就是cocoapods搜索依赖库的地址
3.项目介绍
4.项目开发语言,cocoapod对针对依赖库做检测,这个作为依据
5.git 忽略文件
6.开源许可证 ,这里使用MIT,为啥要选不懂,欢迎科普
7.依赖库类型,是否公开,我们选择不公开,github私有仓库是收费的,这里就是为啥选择码云作为仓库。
8.Readme,项目说明文档,建议勾选创建。
2.clone到本地
clone仓库到本地,完成项目文件的添加
git clone https://git.oschina.net/ZOKAI/TestDemo2.git
如下,表明仓库已完成clone
Cloning into 'TestDemo2'...
remote: Counting objects: 5, done.
remote: Compressing objects: 100% (4/4), done.
remote: Total 5 (delta 0), reused 0 (delta 0)
Unpacking objects: 100% (5/5), done.
本地目录
添加过项目文件的本地目录
git add -A && git commit -m 'add project file'
git push origin master
3 .podspec 文件
依赖库的核心就是.podspec 文件的创建
有两种方式创建podspec文件:
1.从其他地方复制过来,然后修改
2.使用命令行
我们这里使用命令行创建
pod spec create TestDemo2
里面有很多的内容,但是大多数都是我们不需要的,所以我们只需要根据项目的情况保留关键的内容
podspec 文件配置
Pod::Spec.new do |s|
s.name = "TestDemo2" #specc文件的名称
s.version = "1.0.0" #对应的版本
s.summary = "简短介绍 TestDemo2." #简短介绍
s.description = <<-DESC
测试用例,这里是详细介绍,可以不写,但是
DESC
s.homepage = "https://git.oschina.net/ZOKAI/TestDemo2.git" #注意
# s.screenshots = "www.example.com/screenshots_1.gif", "www.example.com/screenshots_2.gif"
s.license = "MIT" #开源协议
# s.license = { :type => "MIT", :file => "FILE_LICENSE" }
s.author = { "ZOKAI" => "[email protected]" } #作者,邮箱
# Or just: s.author = "ZOKAI"
# s.authors = { "ZOKAI" => "[email protected]" }
# s.social_media_url = "http://twitter.com/ZOKAI"
# s.platform = :ios
s.platform = :ios, "8.0" #平台,版本
# When using multiple platforms
# s.ios.deployment_target = "5.0"
# s.osx.deployment_target = "10.7"
# s.watchos.deployment_target = "2.0"
# s.tvos.deployment_target = "9.0"
s.source = { :git => "https://git.oschina.net/ZOKAI/TestDemo2.git", :tag => "#{s.version}" }#对应的资源文件的地址,注意后边的tag ,其实就是他的版本,pods是以git为基础管理的。
## 这里不支持ssh的地址,只支持HTTP和HTTPS,最好使用HTTPS
## 正常情况下我们会使用稳定的tag版本来访问,如果是在开发测试的时候,不需要发布release版本,直接指向git地址使用
s.source_files = "TestDemo2/TestDemo2/Class/**/*.{h,m}" #编译源文件
s.exclude_files = "Classes/Exclude" #排除文件
s.requires_arc = true #是否是arc模式
s.frameworks = "UIKit", "Foundation"#使用的framworks 这里可以是系统的framework 也可以是部分第三方中包含的frameworks ,多个以","隔开
s.dependency "SVProgressHUD", "~> 2.1.2"#使用了cocopoads第三方依赖库 ,多个以","隔开
s.module_name = 'TestDemo2' #模块名称
# s.public_header_files = "Classes/**/*.h" #公开的头文件
# s.resource = "icon.png"
# s.resources = "Resources/*.png"
# s.preserve_paths = "FilesToSave", "MoreFilesToSave"
# s.framework = "SomeFramework"
# s.library = "iconv"
# s.libraries = "iconv", "xml2"
# s.xcconfig = { "HEADER_SEARCH_PATHS" => "$(SDKROOT)/usr/include/libxml2" }
end
s.module_name = 'TestDemo2' #模块名称 这个需要特别留意,这个是最终使用pod 'xxx' 的名称
图例5是依赖库工程的组织目录
图例6是最终制作完毕的私有仓库在使用的时候的组织目录,对比可见目录结构已经打乱
图例7 是AFNetworking在使用的时候的组织目录,对比发现仍然保持有目录结构
如果需要保持组织结构 ,如AFNetworking 的组织目录 则需要在.podspec 配置。参考AFNetworking.podspec
Pod::Spec.new do |s|
s.name = 'AFNetworking'#sepc文件的名字
s.version = '2.5.4'#对应的版本
s.license = 'MIT'#开源协议
s.summary = 'A delightful iOS and OS X networking framework.'#简单的介绍
s.homepage = 'https://github.com/AFNetworking/AFNetworking'#主页
s.social_media_url = 'https://twitter.com/AFNetworking'#作者的twitter
s.authors = { 'Mattt Thompson' => '[email protected]' }#作者 和他的邮箱
s.source = { :git => 'https://github.com/AFNetworking/AFNetworking.git', :tag => s.version, :submodules => true }#对应的资源文件的地址,注意后边的tag ,其实就是他的版本,pods是以git为基础管理的。版本就是tag值了
s.requires_arc = true#是否是arc模式
s.ios.deployment_target = '6.0'#iOS对应的版本
s.osx.deployment_target = '10.8'#OX S 对应的版本
s.public_header_files = 'AFNetworking/*.h'#公共的头文件地址
s.source_files = 'AFNetworking/AFNetworking.h'#文件地址,pod会以这个地址下载需要的文件构建pods
s.subspec 'Serialization' do |ss|#对应的一些子工程
ss.source_files = 'AFNetworking/AFURL{Request,Response}Serialization.{h,m}'
ss.ios.frameworks = 'MobileCoreServices', 'CoreGraphics'
ss.osx.frameworks = 'CoreServices'
end
s.subspec 'Security' do |ss|
ss.source_files = 'AFNetworking/AFSecurityPolicy.{h,m}'
ss.frameworks = 'Security'
end
s.subspec 'Reachability' do |ss|
ss.source_files = 'AFNetworking/AFNetworkReachabilityManager.{h,m}'
ss.frameworks = 'SystemConfiguration'
end
s.subspec 'NSURLConnection' do |ss|
ss.dependency 'AFNetworking/Serialization'
ss.dependency 'AFNetworking/Reachability'
ss.dependency 'AFNetworking/Security'
ss.source_files = 'AFNetworking/AFURLConnectionOperation.{h,m}', 'AFNetworking/AFHTTPRequestOperation.{h,m}', 'AFNetworking/AFHTTPRequestOperationManager.{h,m}'
end
s.subspec 'NSURLSession' do |ss|
ss.dependency 'AFNetworking/Serialization'
ss.dependency 'AFNetworking/Reachability'
ss.dependency 'AFNetworking/Security'
ss.source_files = 'AFNetworking/AFURLSessionManager.{h,m}', 'AFNetworking/AFHTTPSessionManager.{h,m}'
end
s.subspec 'UIKit' do |ss|
ss.ios.deployment_target = '6.0'
ss.dependency 'AFNetworking/NSURLConnection'
ss.dependency 'AFNetworking/NSURLSession'
ss.ios.public_header_files = 'UIKit+AFNetworking/*.h'
ss.ios.source_files = 'UIKit+AFNetworking'
ss.osx.source_files = ''
end
end
AFNetworking是通过subspec 来保持子目录结构的,如果有需求的可以在这里特殊配置。
4.检测podspec文件
podspec文件默认有error 和warning 都不会检测通过 --allow-warnings 参数会运行warnings 可以加上 --verbose 参数查看debug信息
pod lib lint --allow-warnings
检测成功,即表明依赖库制作完毕
-> TestDemo2 (1.0.0)
TestDemo2 passed validation.
这里介绍一个情况
如图例8 ,使用RongCloudIM的时候发现,里面有.a 静态库和.framework
依旧使用
pod lib lint TestDemo2.podspec --allow-warnings --verbose
检测,会出现如下错误
- ERROR | [iOS] unknown: Encountered an unknown error (The 'Pods-App' target has transitive dependencies that include static binaries:
(/private/var/folders/2c/78rv4swj57n7pvzdy7jk3w0w0000gn/T/CocoaPods/Lint/Pods/RongCloudIM/RongCloudIM/RongIMKit.framework,
/private/var/folders/2c/78rv4swj57n7pvzdy7jk3w0w0000gn/T/CocoaPods/Lint/Pods/RongCloudIM/RongCloudIM/libopencore-amrnb.a,
and /private/var/folders/2c/78rv4swj57n7pvzdy7jk3w0w0000gn/T/CocoaPods/Lint/Pods/RongCloudIM/RongCloudIM/RongIMLib.framework)
原因就是依赖库(s.dependency)包含了.a静态库造成的,解决方法是,添加 --use-libraries 来让检测通过
pod lib lint TestDemo2.podspec --allow-warnings --verbose --use-libraries
这样在以后使用私有仓库的时候。podfile 需要做如下修改
pre_install do |installer|
def installer.verify_no_static_framework_transitive_dependencies; end
end
下一篇
制作cocoapods私有仓库(二)cococapods私有仓库制作
参考:
折腾cocoaPods, 创建自己的依赖库
'The 'Pods' target has transitive dependencies that include static binaries' when installing 'xxxx'