一步一步上传framework到CocoaPods

1. 注册CocoaPods账号

1. 注删账号

# 如果有账号就不要注册了
# pod trunk register 邮箱  昵称
$ pod trunk register [email protected] ‘mark’

# 执行了注册后，对应的邮箱会收到一邮件，邮件中会有一个链接。 
# 直接拷贝这个链接，在浏览器中打开就可以了。
https://trunk.cocoapods.org/sessions/verify/xxxxx

1.2 查看账号信息

# 查看账号信息，执行指令后，会得到相应的信息，Pods中会显示你已发布的库
$  pod trunk me

# 查询到的内容
 - Name:     Mark
  - Email:    [email protected]
  - 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" => "[email protected]" }

# 指定运行平台，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仓库就创建好了。

一步一步上传framework到CocoaPods

1. 注册CocoaPods账号

1. 注删账号

1.2 查看账号信息

2. 创建远程仓库

2.1 github创建工程

2.2 clone工程到本地

3. 配置.podspec文件

3.1 创建podspec文件

3.2 修改参数

4. 项目提交到远程仓库

5. 校验 podspec文件

6. 发布

7. 使用

8. 更新

你可能感兴趣的:(一步一步上传framework到CocoaPods)