macos 上用 xcode 管理第三方依赖的核心是内置 swift package manager(spm),无需额外工具、不改动项目结构,通过菜单栏、项目导航器或 target 的 general 标签页三种入口添加包,输入 github 地址或搜索库名即可;版本策略支持 up to next major、up to next minor 和自定义 range。
在 macos 上用 xcode 管理第三方依赖,核心就是用内置的 swift package manager(spm)。它不需要额外安装工具,也不改项目结构,点几下就能加库、选版本、删包,比 cocoapods 更轻量稳定。
添加依赖:三种入口都能进
不用打开终端或改配置文件,Xcode 提供了直观入口:
- 菜单栏 → File → Swift Packages → Add Package Dependency…
- 项目导航器中,右键点击项目名 → Add Package Dependency…
- 选中你的 App target → General 标签页 → Frameworks, Libraries, and Embedded Content 区域 → 点 “+” → Add Other… → Add Package Dependency…
输入 GitHub 地址(比如 https://github.com/Alamofire/Alamofire)或直接搜库名,Xcode 会自动拉取仓库信息并识别可用版本。
选版本:关键在语义化规则
添加时必须指定版本策略,直接影响后续更新行为和兼容性:
-
Up to Next Major:如填
5.8.0,允许升级到5.x.x,但不会跳到6.0.0(避免破坏性变更) -
Up to Next Minor:如填
5.8.0,只允许升到5.9.x,更保守 -
Range:手动输入区间,例如
5.7.0.. - Exact:锁定死版本,适合生产环境关键依赖
- 也可选分支(
main)、提交哈希(abc1234)或未打 tag 的开发版
建议新项目优先用 Up to Next Minor,兼顾更新与稳定性;上线前可切为 Exact 并提交 Package.resolved 文件。
macOS 微信消息自动化工具。通过 GUI 自动化实现:发送消息给指定联系人、读取聊天内容、监控新消息。适用于需要自动化微信操作的场景,如定时发送、批量回复、消息备份等。依赖 peekaboo 进行屏幕截图和 UI 交互。仅支持 macOS。开源地址:https://github.com/chairmanmia...
使用与验证:导入后直接调用
添加成功后,Xcode 自动把包链接到 target。在 Swift 文件顶部加 import Alamofire(以 Alamofire 为例),然后写代码:
AF.request("https://httpbin.org/get").response { response in
print(response)
}
能正常编译运行,说明集成完成。如果报 No such module,检查是否已勾选对应 target 的依赖项(在 Project → Target → General → Frameworks 部分确认)。
日常维护:删、改、更新都在线操作
所有管理动作都在同一个界面完成:
- 删依赖:在 Project Navigator → Swift Packages 下选中包,点左下角 − 按钮,确认即可
- 改版本:双击依赖行,重新选择规则或输入新版本,点 Next 生效
- 批量更新:菜单栏 → File → Swift Packages → Update to Latest Package Versions(按你设定的规则拉最新兼容版)
- 清缓存排错:菜单栏 → File → Swift Packages → Reset Package Caches(解决拉不到、校验失败等问题)
所有变更都会实时写入 Package.resolved,该文件应纳入 Git 提交,确保团队成员使用完全一致的依赖版本。










