在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.17.0 于 2026 年 7 月发布，是目前 GitHub 官方 releases 页面显示的最新稳定版本 。
- 官方资源：
- CocoaPods 官网（https://cocoapods.org）提供基础介绍与文档。
- GitHub 发布页（https://github.com/CocoaPods/CocoaPods/releases）可查看完整版本历史与更新日志。
- 版本兼容性：CocoaPods 1.17.0 需要 Ruby 2.7.4 或更高版本，macOS 系统自带 Ruby 版本过低时需通过 Homebrew 或版本管理器升级 。
配置 Podfile
- 进入项目目录：
.xcodeproj同级的目录。 - 初始化：执行
pod init，会生成一个 Podfile。 - 编辑 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重试。
