CocoaPods

在Intel macos 12.7.6中安装cocoapos

1.安装macports

访问阿里云开源镜像站的 MacPorts 页面：
https://mirrors.aliyun.com/macports/

macports-distfiles-MacPorts安装包下载-开源镜像站-阿里云，下载MacPorts-2.12.6-12-Monterey.pkg，下载后点击安装，安装过程会比较慢。

安装完成后配置文件位置在 /opt/local/etc/macports/sources.conf

MacPorts 的可执行文件通常位于/opt/local/bin和/opt/local/sbin

执行更新端口树 sudo port selfupdate，也会比较慢。

2.安装ruby

搜索可用的ruby版本： port list | grep ^ruby

安装ruby34：sudo port install ruby34

设置默认的ruby版本：sudo port select --set ruby ruby34

刷新shell环境：source ~/.zshrc # 如果使用的是 bash，则执行：source ~/.bash_profile

3.安装cocoapods

sudo gem install -n /usr/local/bin cocoapods 显示 Successfully installed cocoapods-1.17.0
pod --version 显示 1.17.0

CocoaPods 版本

‌CocoaPods 最新版本是 1.17.0‌，可通过官方 GitHub 发布页面查看更新详情 。‌‌‌

📦 版本信息与官方渠道

1. ‌最新版本‌：1.17.0 于 2026 年 7 月发布，是目前 GitHub 官方 releases 页面显示的最新稳定版本 。‌‌‌
2. ‌官方资源‌：
   • CocoaPods 官网（https://cocoapods.org）提供基础介绍与文档。
   • GitHub 发布页（https://github.com/CocoaPods/CocoaPods/releases）可查看完整版本历史与更新日志。‌‌‌
3. ‌版本兼容性‌：CocoaPods 1.17.0 需要 Ruby 2.7.4 或更高版本，macOS 系统自带 Ruby 版本过低时需通过 Homebrew 或版本管理器升级 。‌‌‌

配置 Podfile

1. ‌进入项目目录‌：.xcodeproj同级的目录。
2. ‌初始化‌：执行pod init，会生成一个 Podfile。
3. ‌编辑 Podfile‌：用编辑器打开，按需添加依赖。

几个关键点：

• ‌platform‌：写的是最低部署版本，要和项目实际支持版本一致，写高了低版本设备直接跑不了。
• ‌use_frameworks!‌：用动态库方式集成。如果遇到和静态库的冲突，可以写成use_frameworks! :linkage => :static来强制静态链接。
• ‌版本写法‌：pod '库名'永远拿最新版，风险高；pod '库名', '1.0.0'锁死精确版本；pod '库名', '~> 1.0'允许 1.x 系列更新，最常用。‌‌

📦 安装依赖

执行安装前，‌先彻底关闭 Xcode‌，否则容易出问题。‌‌

pod install

首次执行可能卡在更新仓库，国内环境可以用：

pod install --verbose --no-repo-update

安装成功后，项目目录里会多出.xcworkspace文件。‌之后都用它打开工程‌，别再开原来的.xcodeproj。‌‌

✅ 日常使用与更新

• ‌添加新库‌：编辑 Podfile 加一行，再执行pod install。
• ‌更新某个库‌：pod update 库名。
• ‌更新全部‌：pod update，或先pod repo update再更新。
• ‌查找库‌：pod search 库名，搜不到时执行pod setup，再删掉~/Library/Caches/CocoaPods/search_index.json重试。‌‌