一步一步上传framework到CocoaPods

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. 更新

1. SDK有新的变化后，将新生成的静态库导入到当前工程中。
2. 修改 podspec中的version字段为新的版本号，如1.1.0。
3. 提交到远程仓库(第4步)，注意tag要与新的版本号保持一致, 如1.1.0.

到此，一个比较简陋的Pod仓库就创建好了。