1. 注册CocoaPods账号
1. 注删账号
# 如果有账号就不要注册了
# pod trunk register 邮箱 昵称
$ pod trunk register mark@163.com ‘mark’
# 执行了注册后，对应的邮箱会收到一邮件，邮件中会有一个链接。
# 直接拷贝这个链接，在浏览器中打开就可以了。
https://trunk.cocoapods.org/sessions/verify/xxxxx
1.2 查看账号信息
# 查看账号信息，执行指令后，会得到相应的信息，Pods中会显示你已发布的库
$ pod trunk me
# 查询到的内容
- Name: Mark
- Email: mark@163.com
- Since: December 13th, 2021 03:23
- Pods:
- HYManager-Swift
- Sessions:
- December 13th, 2021 03:23 - April 20th, 03:23. IP: 116.30.142.234
- December 13th, 2021 03:25 - April 20th, 04:17. IP: 116.30.142.234
- March 3rd, 00:26 - July 9th, 22:17. IP: 116.30.141.128
2. 创建远程仓库
2.1 github创建工程
- 在github上创建工程过程和创建普通的代码工程是相同的，但要注意两点：
- 工程要设置为
Public - License 必须要选择一个，后面配置文件需要用到，我这里选择提
MIT
- 工程要设置为
2.2 clone工程到本地
# 切换到指定位置
$ cd ~/gitee
$ git clone https://github.com/Owner/HYManager-Swift.git
# 下载完成后 在工徎目下创建一个与工程名相面的目录 HYManager-Swift
# 将静态库HYManager-Swift.framework放到新创建的HYManager-Swift目录中去
# 目录结构应该是: ~/gitee/HYManager-Swift/HYManager-Swift/HYManager-Swift.framework
3. 配置.podspec文件
3.1 创建podspec文件
# 文件要和工程名保持一致, 文件位置在项目的根目录下
# ~/gitee/HYManager-Swift
$ pod spec create HYManager-Swift
# 执行结束后，生成一个HYManager-Swift.podspec 文件
# ~/gitee/HYManager-Swift/HYManager-Swift.podspec
3.2 修改参数
# 名称 和要文件或github中的工程名保持一致
spec.name = "HYManager-Swift"
# 版本号，要与 git tag 保持一致，每次提交要递增
spec.version = "1.0.0"
# 简介要写一段文字
spec.summary = "HYManager-Swift 是XXXX用来开发App的iOS工具包"
# 详细描述的言语字要多写一点，文字只能在DESC中间
spec.description = <<-DESC
SDK是xxx用来xxxx的工具包，其中提供大量的API用于帮助用户开发设备的各项功能....尽量写长一点。
DESC
# 项目主页 在github上创建的工程
spec.homepage = "https://github.com/Owner/HYManager-Swift.git"
# 协议 MIT, 前面创建工程提到的创建github工程的协议
spec.license = "MIT"
# 作者，这个不要动，创建时会自动生成
spec.author = { "Owner" => "mark@163.com" }
# 指定运行平台，iOS 9.0以上
spec.platform = :ios, "9.0"
# 源代码位置 git里与hoepage保持一致就可以了, tag不要动，会自动获取变量
spec.source = { :git => "https://github.com/Owner/HYManager-Swift.git", :tag => "#{spec.version}" }
# SDK头文件路径(可以不写)
# spec.public_header_files = "HYManager-Swift/HYManagerSDK.framework/Headers/HYManagerSDK.h"
# 开放的头文件，从工程根目录下开始写起
spec.source_files = "HYManager-Swift/HYManagerSDK.framework/Headers/*.{h,m}"
# 排除文件
# spec.exclude_files = "Example"
# SDK的路径 写上库的位置 (自动生成没有这一项，可以不写试一下)
spec.vendored_frameworks = 'HYManager-Swift/HYManagerSDK.framework'
# 依赖系统的一些库，有就写，没有就不要写
# framework, frameworks：一个库就是用framework,多个库设置frameworks并使用,分割。
# library, libraries：同上，需要注意的是设置lib依赖库时，省略其名称的lib前缀，以及.后缀。如 spec.library = "iconv"
spec.frameworks = "Foundation", "CoreBluetooth"
# 第三方依赖 有几个就写几个，我这里没有使用过
# spec.dependency "JSONKit", "~> 1.4"
# 项目配置，注意这里的SDK不支持模拟器
# 如果多个字段就用逗号分开 { 'VALID_ARCHS' => 'x86_64 armv7 arm64', 'ENABLE_BITCODE' => 'NO' }
spec.pod_target_xcconfig = { 'VALID_ARCHS' => 'armv7 arm64' }
4. 项目提交到远程仓库
# 提交后要打标签
$ git add --all
$ git commit -m 'init framework'
$ git push
# tag要与 spec.version 字段保持一致
$ git tag -1.0.0
$ git push origin --tags
5. 校验 podspec文件
这一步可能会出错，可以通过提示和百度一步一步来解决，这里只列出我遇到的过程，方便参考。
# 校验 pod spec lint xxx.podspec
$ pod spec lint HYManager-Swift.podspec
# 如果出错 就执行下面的命令，可以查看打印信息
$ pod spec lint HYManager-Swift.podspec --verbose
# 如果只是警告可以加上 --allow-warnings 选项
$ pod spec lint HYManager-Swift.podspec --allow-warnings
在校验上我遇到了如下错误，校验不支持模拟器，可我在配置项中明明设置了不支持模拟器，不知道是什么原因。
# 校验出错信息
$ ERROR | [iOS] xcodebuild: Returned an unsuccessful exit code.
- NOTE | [iOS] xcodebuild: ld: warning: ignoring file ....
missing required architecture i386 in file /.....
clang: error: linker command failed with exit code 1 (use -v to see invocation)
# 1. 在百度上尝试了各位热心网友的方法最后找到一个成功的办法 修改 `validator.rb` 文件
# 查找到文件
$ gem which cocoapods
# 获得路径
$ /Library/Ruby/Gems/2.6.0/gems/cocoapods-1.11.2/lib/cocoapods.rb
# 打开lib目录，再进入里面的 cocoapods 目录，就可以找到文件 `validator.rb` 文件
$ cd /Library/Ruby/Gems/2.6.0/gems/cocoapods-1.11.2/lib/cocoapods
# 2. 修改 `validator.rb` 文件
# 滚动到 when: iOS 这个位置, 将头两行注释掉，增加第三行的内容`command += %w(ARCHS=x86_64)` 内容
when :ios
# command += %w(CODE_SIGN_IDENTITY=- -sdk iphonesimulator)
# command += Fourflusher::SimControl.new.destination(:oldest, 'iOS', deployment_target)
command += %w(ARCHS=x86_64) # 新增
xcconfig = consumer.pod_target_xcconfig
if xcconfig
archs = xcconfig['VALID_ARCHS']
if archs && (archs.include? 'armv7') && !(archs.include? 'i386') && (archs.include? 'x86_64')
# Prevent Xcodebuild from testing the non-existent i386 simulator if armv7 is specified without i386
command += %w(ARCHS=x86_64)
end
end
# 修改后进行保存，再次校验，错误解决，警告忽略
$ pod spec lint HYManager-Swift.podspec --allow-warnings
6. 发布
# 发布
$ pod trunk push HYManager-Swift.podspec
# 执行后出现如下结果就表示成功发布了
Updating spec repo `trunk`
🎉 Congrats
🚀 HYManager-Swift (1.0.0) successfully published
📅 March 3rd, 19:49
🌎 https://cocoapods.org/pods/HYManager-Swift
👍 Tell your friends!
7. 使用
# 和使用其它第三方库一样
platform :ios, '9.0'
target 'Your app' do
use_frameworks!
pod 'HYManager-Swift'
end
8. 更新
- SDK有新的变化后，将新生成的静态库导入到当前工程中。
- 修改 podspec中的version字段为新的版本号，如1.1.0。
- 提交到远程仓库(第4步)，注意tag要与新的版本号保持一致, 如1.1.0.
到此，一个比较简陋的Pod仓库就创建好了。
