相关：
1- 发布组件库到私有索引库spec
- 前提： 先执行
pod search <名字>，查看在cocoapods官网上，是否已有同名的第三方库，避免后面麻烦；
一、创建仓库
- 仓库名为组件名字;
- Readme文件不用勾选；
- 访问级别：private、public；
两者不同，代表索引库的开放权限：
private：SDK私有，需要授权才能pod集成；
public：所有人都可以pod集成；
创建好后，先放置一边；
二、创建本地组件代码库
先进入(cd)到想放组件的文件夹下；
- 1- 创建索引项目
pod lib create <组件名>
//如： pod lib create MySDK
- 2- 执行后，会出现一系列的选择，按照步骤进行选择就OK；
What is your email?
What platform do you want to use?? [ iOS / macOS ] //选择平台：iOS
What language do you want to use?? [ Swift / ObjC ] //选择语言：ObjC
Would you like to include a demo application with your library? [ Yes / No ] //是否自动生成一个demo：Yes
Which testing frameworks will you use? [ Specta / Kiwi / None ] //None
Would you like to do view based testing? [ Yes / No ] //No
What is your class prefix? //生成类的前缀
- 3- 最终生成一个组件项目，会自动打开项目；在项目的目录下，其中有个
Example的目录，打开就可以看到目录结构；
工程目录.png
三、在组件项目中添加组件
- 在这个项目中，
Classes和Assets文件夹就是放组件文件的地方； - ReplaceMe.m这个文件，是生成项目时，自动生成的，可以删除；
- 在
Classes放入组件的文件，Assets组件放资源文件；
项目目录.png
四、pod组件到项目中
-
cd Example，到Example目录，有Podfile文件的地方； - 执行
pod install; - 执行完毕后，在项目目录可以看到组件已pod到工程中；
pod目录.png
五、索引文件XXX..podspec
打开工程的XXX..podspec文件，根据需要修改；
Pod::Spec.new do |s|
s.name = 'MySDK' //SDK名字
s.version = '0.1.0' //版本号，和GitHub上的tag要保持一致
s.summary = 'A short description of MySDK.' //简介
s.description = <<-DESC
TODO: Add long description of the pod here. //描述，可以是个链接URL
DESC
s.homepage = 'https://github.com/[GitHub名字]/MySDK'
# s.screenshots = 'www.example.com/screenshots_1', 'www.example.com/screenshots_2'
s.license = { :type => 'MIT', :file => 'LICENSE' } //开源默认证书
s.author = { 'XXX' => 'XXX@qq.com' } //作者
s.source = { :git => 'https://github.com/[GitHub名字]/MySDK.git', :tag => s.version.to_s } //项目地址和tag
# s.social_media_url = 'https://twitter.com/<TWITTER_USERNAME>'
s.ios.deployment_target = '9.0'
# s.source_files = 'MySDK/Classes/**/*' //pod库的源文件
s.vendored_frameworks = "MySDK/Classes/*.framework" //pod库中framework的路径
# s.resource_bundles = {
# 'MySDK' => ['MySDK/Assets/*.png']
# }
s.resource = "MySDK/Assets/*.bundle" //指定的资源直接复制到客户端目录
s.pod_target_xcconfig = { 'VALID_ARCHS[sdk=iphonesimulator*]' => '' }
# s.public_header_files = 'Pod/Classes/**/*.h' //pod库暴露给用户工程的头文件
#s.frameworks = 'UIKit', 'MapKit' //依赖的系统库
s.dependency 'AFNetworking', '~> 4.0.1' //依赖的第三方库
end
六、提交到远程仓库
在工程根目录下执行，即在XXX.podspec所在的文件夹
git add .
git commit -m "第一次添加组件"
git remote add origin <GitHub仓库地址>
git push origin master
git tag <版本号> （和XXX.podspec里的一致，如：0.1.0）
git push --tags
七、验证cocoapods索引文件
在工程根目录下执行，即在XXX.podspec所在的文件夹；
- 1- 进行检验
pod spec lint --verbose --allow-warnings
//或
pod spec lint --skip-import-validation --allow-warnings --use-libraries
pod spec lint --verbose --use-libraries --allow-warnings --sources='git@私有库地址.git,https://github.com/CocoaPods/Specs.git'
- 2- 校验成功：
XXX.podspec passed validation.
- 3- 校验失败
会标出错误的说明，可以根据说明进行处理；
[!] The spec did not pass validation, due to 1 error.
失败信息
失败结果
八、发布
在工程根目录下执行，即在XXX.podspec所在的文件夹；
- 1- 先查看是否注册trunk；
pod trunk me
已注册
- 2- 如果没有注册，则先注册
pod trunk register <邮箱xxx@qq.com> "<名字>" --verbose
注册完成后，会发送一个确认邮件，里面有链接，点击后，确认；
注册完毕后.
- 3- 发布SDK (在工程
根目录下，有XXX.podspec的目录)
pod trunk push xxx.podspec
//或
pod trunk push xxx.podspec --allow-warnings //允许警告
//或
pod trunk push xxx.podspec --allow-warnings --skip-import-validation //跳过验证pod是否导入
- 4- 发布成功
Updating spec repo `trunk`
Validating podspec
-> MySDK (0.1.0)
Updating spec repo `trunk`
--------------------------------------------------------------------------------
🎉 Congrats
🚀 MySDK (0.1.0) successfully published
📅 January 26th, 00:41
🌎 https://cocoapods.org/pods/MySDK
👍 Tell your friends!
--------------------------------------------------------------------------------
九、验证
- 将组件发布cocoapods成功后，可以使用
search命令搜索；
pod search <库名字>
- 查找成功
-> MySDK (0.1.0)
A short description of MySDK.
pod 'MySDK', '~> 0.1.0'
- Homepage: https://github.com/[GitHub名字]/MySDK //对应XXX.podspec配置的
- Source: https://github.com/[GitHub名字]/MySDK.git
- Versions: 0.1.0 [trunk repo]
- 查找失败，会出现
红色一行字，提示找不到 - 原因：
1- 发布成功后，需要隔一段时间，可能是还在审核中；
2- 可能第二天早上执行以下，就可以找到了；
[!] Unable to find a pod with name, author, summary, or description matching `MySDK `
可以尝试以下方式:
//进入搜索CocoaPods缓存目录
cd ~/Library/Caches/CocoaPods
//查看缓存文件search_index.json
ls
//删除搜索缓存文件
rm -f search_index.json
有时候pod search找不到的情况下，可能直接使用pod install就安装成功了，得到意想不到的结果；
pod 'MySDK' //podfile中添加
pod install //执行安装
更新已发布的库
// 1-先修改XXX.podspec里面的tag
s.version = '0.1.0'
// 2- 更新改动到远程仓库
git push origin master
// 3- 打tag，和XXX.podspec里面的tag一致；
git tag <版本号>
git push --tags
//4- 校验
pod spec lint --allow-warnings --skip-import-validation --use-libraries
//5- 发布
pod trunk push xxx.podspec --allow-warnings --skip-import-validation
执行pod trunk push xxxx遇到的问题
1- 原因：原因是身份认证失效
invalid
Authentication token is invalid or unverified. Either verify it with the email that was sent or register a new session.
解决方案：重新验证身份
pod trunk register 'xxx@qq.com' 'yourname' --description='描述~'
//然后到邮箱点击验证的链接；
//重新执行：pod trunk push xxxx
相关资料：
--verbose //显示详情信息
--use-libraries //组件有依赖，迭代组件版本的时候,需要加上--use-libraries
--allow-warnings //允许警告
--skip-import-validation //跳过校验pod是否可以导入
pod spec lint --verbose
pod spec lint --use-libraries
pod spec lint --allow-warnings
两种校验方式的区别：
- 两者和s. source填入的内容是相关的；
pod lib lint //校验本地
pod spec lint //校验本地和远程github，只有校验成功了，才能将
