让自己的静态库（static framework） 支持使用 Cocoapods 方式添加
主要流程
一、创建 git 仓库
- 仓库的主要作用：
-- 存放 spec 文件；
-- 存放静态库文件，即 Framework，或者说 SDK；
-- 存放静态库依赖的资源文件，比如 bundle 文件；
二、将 git 仓库 clone 至本地
git clone https://xxx
- 进入仓库所在的文件夹；
- 创建文件夹，存放 framework，此文件夹名字就是 spec 文件
s.vendored_frameworks的静态库所在的文件夹，这个文件夹名也是 pods 到本地后，静态库所在的文件夹名； - 再创建一个文件夹，存放 bundle 文件，这个文件夹名就是
s.resource_bundle的Bundle所在的文件夹
三、SDK、Bundle、spec 文件推送至仓库
git add .
git commit -m 'sdk&bundle&spec add'
git push
// 添加一个 tag，也是 pod install 时，Podfile 文件中可使用的版本
// tag 与 spec 文件中的 s.version 一致
git tag '0.0.1'
git push --tags
- 后续 SDK 版本更新时，升级
spec文件的s.version，同时更新 tag，然后 push 到远端仓库 -
~/.cocoapods/repos/master/Specs中，会为静态库创建一个文件夹，文件夹里每个 tag 又会对应一个文件夹，里面只有一个静态库名.podspec.json文件
四、本地验证 spec 文件
pod spec lint --allow-warnings
- 失败会有 error 信息，根据信息修改后重试
五、将 spec 文件 push 到 trunk 仓库
- 如果没有 trunk 账号，请先注册
pod trunk register [email protected] 'xxx' --description='xxx' --verbose
// 查看注册信息
pod trunk me
- 注册成功后，推送 spec 至 trunk 服务器
pod trunk push xxx.podspec --allow-warnings
- 推送成功后，可以使用
pod search 'xxx'查看上传的静态库； - 如果查询失败，进入
~/Library/Caches/CocoaPods，删除search_index.json后重试
到这里没有其他问题，静态库就可以使用 pod 导入了
六、创建 demo，验证 SDK 是否可用
- 在工程目录创建 Podfile 文件
- 编辑 Podfile 文件
use_frameworks!
platform :ios, '8.0'
# 使用 '版本号' 指定 SDK 的版本
# 使用 '~> 版本号' 指定包含此版本在内的之后的版本
target 'project name' do
pod '刚上传的 SDK 名字', '~> 0.0.1'
end
Spec 文件示例
Pod::Spec.new do |s|
s.name = "静态库名字"
s.version = "0.0.1"
# 必写，否则本地验证报错
s.summary = "xxx"
# 可不写
s.description = "xxx"
s.homepage = "https://xxx.com/"
s.license = { :type => "MIT" }
s.author = { "ChingHan" => "[email protected]" }
s.source = { :git => "https://gitee.com/chinghan/xxx.git", :tag => s.version }
s.platform = :ios, '8.0'
s.requires_arc = true
# 依赖的系统库
s.frameworks = [
'AVFoundation',
'Accelerate',
'Security',
'SystemConfiguration',
'CoreMedia',
'AudioToolbox',
'CoreTelephony',
'ImageIO',
'MobileCoreServices'
]
s.libraries = 'c++', 'z'
# 自己的 Pod 包含的所有静态库文件
s.vendored_frameworks = [
'文件夹名/xxx.framework',
'文件夹名/frameworks/*'
]
# 资源文件
# 官方推荐使用 s.resource_bundle；两种方式读取 bundle 中资源的方式不同
s.resources = [
'文件夹名/xxx.bundle',
'文件夹名/resources/*'
]
# 依赖的三方 SDK
s.dependency 'AFNetworking', '~> 3.0.0'
# s.vendored_frameworks = [
# '文件夹名/xxx.framework',
# '文件夹名/frameworks/xxx.framework',
# '文件夹名/frameworks/xxx.framework',
# '文件夹名/frameworks/xxx.framework',
# ]
# s.resources = [
# '文件夹名/xxx.bundle',
# '文件夹名/resources/xxx.bundle',
# '文件夹名/resources/xxx.bundle',
# ]
end
spec文件详解:https://guides.cocoapods.org/syntax/podspec.html
采坑集锦
1、如果某些库不支持模拟器，在验证时会报错，在 podspec 文件做下过滤即可（支持哪些写哪些）：
s.pod_target_xcconfig = { 'VALID_ARCHS' => 'arm64 armv7 armv7s x86_64' }
2、验证时报错：
ERROR | [iOS] unknown: Encountered an unknown error (Could not find a ios simulator (valid values: xxx. Ensure that Xcode -> Window -> Devices has at least one ios simulator listed or otherwise add one.) during validation.
应该是版本比较低，升级到新版本即可
- 检查版本列表：
gem list --local | grep cocoapods
- 卸载不用的版本：
sudo gem uninstall cocoapods x.x.x
- 导入新的版本：
sudo gem install cocoapods -v x.x.x