iOS 项目 Jenkins 持续集成环境搭建与常见问题排查
在 macOS 环境下为 iOS 项目搭建 Jenkins 持续集成服务时，经常会遇到一些系统级配置问题。以下是实际搭建过程中遇到的典型坑点及解决方案，希望能帮到正在折腾的同学。
1. 安装与环境准备
Jenkins 的 macOS 安装包可以直接从官方镜像站获取，例如：
- http://ftp-chi.osuosl.org/pub/jenkins/osx/jenkins-1.576.pkg
- 或者访问官网 jenkins-ci.org，选择 Mac OS X 版本下载。
macOS 默认已预装 Java 环境，直接运行 pkg 文件即可完成安装。
2. 证书找不到 (Check dependencies failed)
如果在构建过程中提示无法找到证书，通常是因为 Jenkins 运行的用户（通常是 jenkins）没有继承当前登录用户的钥匙链和证书信息。
解决方法： 将当前登录用户的钥匙链目录复制到 Jenkins 的用户目录下。
- 定位源目录：
/Users/<你的登录用户名>/Library/keychains- 重点包含
/mobileDevice相关配置。
- 重点包含
- 目标目录：
/Users/Shared/Jenkins/Library- 注意
Library是隐藏文件夹，可通过 Finder 的'前往'->'前往文件夹'功能定位。
- 注意
- 操作完成后，双击打开
/Users/Shared/Jenkins/Library/keychains/login.keychain，在钥匙链访问程序中解锁该登录项。
3. 参数列表过长 (Argument list too long)
报错 resurive header extension failed 或类似提示，往往是因为 Xcode 的环境变量配置不一致导致的。
原因分析： Xcode Preferences 中的 Locations -> Source Trees 如果设置了自定义路径，Jenkins 构建环境可能无法识别这些环境变量。
处理步骤： 进入 Jenkins 管理界面：
- 系统管理 -> 系统设置 -> Environment Variables
- 添加与本地 Xcode 一致的环境变量，确保构建脚本能正确解析路径。
4. 代码签名失败 (codesign failed with exit code 1)
编译 iPhone App 时若遇到 Command /usr/bin/codesign failed with exit code 1，请检查开发者密钥的权限设置。
排查建议：
- 打开 Keychain Access（钥匙链访问）。
- 找到对应的开发者 Key，右键选择 Get Info。
- 切换到 Access Control 标签页。
- 确保勾选了 "Allow all applications to access this item"。
- 保存后重新尝试编译。
以上几点涵盖了大部分基础配置问题。自动化流程跑通后，开发效率会有明显提升，后续遇到更深层的问题再补充记录。
