Specs源
CocoaPods Specs 源地址:原始仓库-github、镜像仓库-gitee
source 'https://github.com/CocoaPods/Specs.git' # 原始仓库
source 'https://gitee.com/mirrors/CocoaPods-Specs.git' # 镜像仓库(每日同步一次)
查看 CocoaPods 的 repos 与 Caches
~/.cocoapods/repos/ # repos
~/Library/Caches/CocoaPods/ # Caches
pod install --repo-update # 更新本地repo,并pod install
pod install --no-repo-update # pod install,不更新repo
pod repo update # 默认更新所有repo
pod repo update ~/.cocoapods/repos/master # 更新指定repo
pod search YYKit # 查询YYKit的相关Specs信息
工程引用
Podfile 中添加私有库的 source、pod 配置,在终端输入 pod install 构建
source 'https://github.com/zhengmiaokai/Specs.git'
pod 'JPUtils', '~> 1.0.0'
在 Podfile 中使用 post_install 自定义 pod 库的 Build Settings
post_install do |installer|
installer.pods_project.targets.each do |target|
if target.name == 'JPUtils'
target.build_configurations.each do |config|
config.build_settings['CODE_SIGN_IDENTITY'] = ""
end
end
end
end
git仓库创建
1)源码仓库
2)Specs仓库
podspec文件配置
name:私有库包名
s.name = 'JPUtils'
version:当前版本号
s.version = '1.0.1'
platform:最低支持系统
s.platform = :ios, '8.0'
source:源码git地址、标签
s.source = { :git => 'git地址', :tag => 'JPUtils_1.0.1' }
#等价于:s.source = { 'git' => 'git地址', 'tag' => 'JPUtils_1.0.1' }
requires_arc:是否为arc
s.requires_arc = true
source_files:代码源文件路劲
s.source_files = 'JPUtils/utils/required/*.{h.m}', 'JPUtils/utils/optional/*.{h.m}'
s.source_files = 'JPUtils/utils/**/*.{h.m}'
public_header_files:公共头文件路径(默认值:source_files配置的头文件)
s.public_header_files = 'JPUtils/public/header/*.h'
libraries:系统libs
s.libraries = 'sqlite3', 'stdc++'
#等价于:s.libraries = ['sqlite3', 'stdc++']
vendored_libraries:内置libs路径
s.vendored_libraries = 'JPUtils/utils/required/tool.a', 'JPUtils/utils/optional/common.a'
s.vendored_libraries = 'JPUtils/utils/**/*.a'
resources: 资源文件地址
s.resources = 'JPUtils/utils/resource.bundle'
s.resources = 'JPUtils/utils/*.bundle'
frameworks:系统frameworks
s.frameworks = ['UIKit', 'Foundation']
vendored_frameworks:内置frameworks路径
s.vendored_frameworks = 'JPUtils/utils/required/tool.framework', 'JPUtils/utils/optional/common.framework'
s.vendored_frameworks = 'JPUtils/utils/**/*.framework'
dependency:关联第三方库、组件库,s.dependency 'MKNetwork', '~> 1.0.2'(版本号在Podfile中声明,避免多个podspec出现不一致的情况)
s.dependency 'AFNetworking'
s.dependency 'MKNetwork'
VALID_ARCHS:私有库支持的处理器
s.pod_target_xcconfig = { 'VALID_ARCHS' => 'arm64e arm64 armv7s armv7' }
# arm64e:iPHone XS,iPHone XR,iPhone 11, ...
# arm64:iPhone5s,iPhone6、7、8,iPhone6、7、8 Plus,iPhone X,...
# armv7s:iPhone5, iPhone5C,iPad4,...
# armv7:iPhone 3GS,iPhone4,iPhone 4s,iPad,iPad2,iPad3,...
EXCLUDED_ARCHS:私有库不支持的处理器
s.pod_target_xcconfig = { 'EXCLUDED_ARCHS' => 'x86_64 i386' }
# 官方推荐使用EXCLUDED_ARCHS,VALID_ARCHS仍然可以使用
pod_target_xcconfig:当前私有库的Build Settings配置
s.pod_target_xcconfig = { :OTHER_LINK_FLAG => '$(inherited) -ObjC',
:CLANG_CXX_LIBRARY => "libc++",
'VALID_ARCHS[sdk=iphone*]' => 'arm64 arm64e',
'EXCLUDED_ARCHS[sdk=iphonesimulator*]' => 'arm64' }
# :OTHER_LINK_FLAG等价于'OTHER_LINK_FLAG'
# 'VALID_ARCHS[sdk=iphone*]':iPhone真机支持的处理器类型
# 'EXCLUDED_ARCHS[sdk=iphonesimulator*]':iPhone模拟器不支持的处理器类型
user_target_xcconfig:工程Target / Pods-Target的Build Settings配置
s.user_target_xcconfig = { 'EXCLUDED_ARCHS[sdk=iphonesimulator*]' => 'arm64' }
# 在多个私有库的user_target_xcconfig中,同个Key设置了不同的值会导致配置冲突
subspec :pod子模块配置
s.subspec 'catogerys' do |ss|
ss.source_files = "component/catogerys/**/*.{h,m}"
ss.dependency "JPUtils"
end
s.subspec 'controllers' do |ss|
ss.source_files = "component/controllers/**/*.{h,m}", "component/utils/**/*.{h,m}"
ss.dependency "component/catogerys"
end
备注:文件路径中 * 表示文件名通配符, ** 表示文件夹递归匹配;数组用逗号隔开(如: s.libraries = 'a', 'b' 或者 s.libraries = ['a', 'b'] )
podspec文件校验、上传
1)创建远程仓库
https://github.com/zhengmiaokai/Specs.git
2)使用远程仓库URL在repos中添加repo
pod repo add zhengmiaokai https://github.com/zhengmiaokai/Specs.git
pod repo remove zhengmiaokai # 移除repo
3)检验podspecs文件的有效性
pod spec lint ~/desktop/zhengmiaokai/JPUtils/JPUtils.podspec --use-libraries --allow-warnings --verbose --sources='私有库-git地址,CocoaPods-git地址'
pod spec lint ~/desktop/zhengmiaokai/JPUtils/JPUtils.podspec --use-libraries --allow-warnings --verbose --sources='https://github.com/CocoaPods/Specs.git,https://github.com/zhengmiaokai/Specs.git'
4)podspec文件添加到远程仓库
pod repo push zhengmiaokai ~/desktop/zhengmiaokai/JPUtils/JPUtils.podspec --use-libraries --allow-warnings --verbose --sources='私有库-git地址,CocoaPods-git地址'
pod repo push zhengmiaokai ~/desktop/zhengmiaokai/JPUtils/JPUtils.podspec --use-libraries --allow-warnings --verbose --sources='https://github.com/CocoaPods/Specs.git,https://github.com/zhengmiaokai/Specs.git'
备注:--use-libraries (使用libraries和frameworks)、--allow-warnings(忽略警告)、--verbose(定位错误)--sources='specs地址'(默认为CocoaPods,多个地址用逗号隔开)