CocoaPods是Swift和Objective-C项目的包依赖管理器，CocoaPods可以帮助您优雅地扩展项目。

• 官方社区
• CocoaPods使用ruby构建，CocoaPods 1.11将最低ruby版本提高到2.6，同时增加了对ruby 3.0的支持。macOS系统更新ruby

---

卸载 CocoaPods

• 终端执行如下指令

sudo gem uninstall cocoapods

• 查看已安装与 CocoaPods 相关插件

sudo gem list --local | grep cocoapods

• 逐个卸载相关插件

sudo gem uninstall cocoapods-core
sudo gem uninstall cocoapods-deintegrate
sudo gem uninstall cocoapods-downloader
sudo gem uninstall cocoapods-plugins
sudo gem uninstall cocoapods-search
sudo gem uninstall cocoapods-trunk
sudo gem uninstall cocoapods-try

---

安装 CocoaPods

• 终端执行如下指令

sudo gem install -n /usr/local/bin cocoapods

• 查看版本号

pod --version

• 更新本地 .cocoapods/repos

pod repo update --verbose

替换镜像源

• 移除rubygems默认源

sudo gem sources --remove https://rubygems.org/

• 添加tuna镜像源

sudo gem sources --add https://mirrors.tuna.tsinghua.edu.cn/rubygems

• 添加ruby-china镜像源

sudo gem sources --add https://gems.ruby-china.com

如果遇到 SSL 证书问题，请修改 ~/.gemrc 文件，增加 ssl_verify_mode: 0 配置。以ruby-china为例：

---
:sources:
- https://gems.ruby-china.com
:ssl_verify_mode: 0

• 查看镜像源

gem sources -l

---

推送组件至远程仓库(cocoapods.org)

• 制作framework注意事项

  • 是否仅构建活动架构，设置为No，即不仅只编译当前所选架构。

  • Build Active Architecture Only
    

    

    Build Active Architecture Only.png

  • 移除重复架构，即移除模拟器中生成的arm64架构。

  • Excluded Architecture
    

    

    Excluded Architecture.png

  • 设置framework为静态库类型

  • Mach-O Type
    

    

    Mach-O Type.png

  • 设置framework为分发而构建，对于Swift，这支持库的演变和模块接口文件的生成，即提供给他人使用时，Xcode中Swift版本向下兼容。

  • Build Libraries for Distribution
    

    

    Build Libraries for Distribution.png

  • 是否启用死代码剥离，即编译选项优化，对于制作framework，
    应该设置为No, 不启用代码剥离。

  • Dead Code Stripping
    

    

    Dead Code Stripping.png

• cd 至 HandyScanner.podspec 文件根目录

  1. 本地校验HandyScanner.podspec 文件内容规范性

  pod lib lint --verbose --allow-warnings --skip-import-validation
  

  2. 联网校验远程组件仓库tag版本与本地待发布版本tag一致性

  pod spec lint --verbose --allow-warnings --skip-import-validation
  

  3. 注册账户，可以追加一些描述信息

  pod trunk register + 邮箱 + 用户名 + 可选指令
Trunk帐户没有密码，只有每台计算机的token令牌

  pod trunk register orta@cocoapods.org 'Orta Therox' --description='macbook air'
  

  4. 点击上述邮件中链接，随后执行如下指令进行校验

  pod trunk me
  

  5. 发布/更新组件，至远程仓库(cocoapods.org)

  pod trunk push HandyScanner.podspec --verbose --allow-warnings --skip-import-validation
  

  推送成功，上述邮件随后会下发通知

  6. 从远程仓库(cocoapods.org)删除已发布组件

  pod trunk delete HandyScanner 0.0.1
  

---

.podspec 文件，常用键值对及相关规则

Pod::Spec.new do |spec|

  spec.name         = "HandyScanner"
  spec.version      = "0.3.2"
  spec.license      = "MIT"

  spec.summary      = "A lightweight scanning component based on system API in Swift5"
  spec.description  = <<-DESC
             No memory leaks, Support scaling, Support light sense to automatically turn on the flash, Support auto zoom, Support custom UI.
                      DESC

  spec.author       = { "Charlie" => "13204117850@163.com" }
  spec.homepage     = "https://github.com/a51095/HandyScanner"
  spec.source       = { :git => "https://github.com/a51095/HandyScanner.git", :tag => spec.version }

  spec.requires_arc = true

  spec.swift_version = "5.0"
  spec.platform      = :ios, "11.0"
  spec.ios.deployment_target = "11.0"

  spec.static_framework = true
  spec.ios.vendored_frameworks  = 'lib/HandyScannerSDK.framework'
  spec.source_files  = "lib/HandyScannerSDK.framework/**/*"
  spec.public_header_files = 'lib/HandyScannerSDK.framework/Headers/HandyScannerSDK-Swift.h'


  # ======================================================
  # spec.ios.exclude_files = 'lib/xxxx.dec' (忽略的文件)
  # spec.source_files  = 'lib/HandyScannerSDK.framework/**/*'(资源文件)
  # spec.public_header_files = 'lib/HandyScannerSDK.framework/Headers/HandyScannerSDK-Swift.h'（Objective-C暴露头文件）
  # ======================================================

  #???????
  # * 匹配所有类型文件
  # *.{h,m} 匹配所有以 .h 和 .m 结尾的文件
  # ** 匹配所有子目录
  #???????

end

---

本地缓存

• 查看本地缓存列表

pod cache list

• 清除指定缓存（eg：Alamofire）

pod cache clean  Alamofire

• 清除所有缓存

pod cache clean  --all

• 清除所有pod管理项（eg：.xcworkspace，Podfile.lock，Pods）

pod clean

---

常见问题

- ERROR | [iOS] xcodebuild: Returned an unsuccessful exit code.

• 若工程中依赖私有静态库，则需要 追加 --skip-import-validation指令

  --skip-import-validation
  

---

[!] CocoaPods could not find compatible versions for pod "HandyScanner"

• 新版本发布后，且收到邮件提醒，但install 没有下载成功，
  尝试键入如下指令修复问题

  pod cache clean  HandyScanner
  pod install --repo-update
  

---

[!] CDN: trunk Repo update failed - n error(s):

• CocoaPods 1.8将 CDN 切换为默认规范回购源，并带来了一些增强功能！
• 新版的 CocoaPods 不允许使用pod repo add直接添加master回购源，清华大学开源软件镜像 提供了解决方案

cd ~/.cocoapods/repos 
pod repo remove master
git clone https://mirrors.tuna.tsinghua.edu.cn/git/CocoaPods/Specs.git master

• 然后在目标工程的Podfile中加上

source 'https://mirrors.tuna.tsinghua.edu.cn/git/CocoaPods/Specs.git'