CodeLooper项目中的开发者ID证书导出指南

前言

在Mac应用开发过程中，开发者ID证书是代码签名和发布应用的关键凭证。本文将详细介绍如何在CodeLooper项目中正确导出开发者ID应用证书，确保后续的自动化构建和签名流程能够顺利进行。

证书定位技巧

1. 全面检查钥匙串访问

许多开发者常犯的错误是只检查"登录"钥匙串，而忽略了系统钥匙串。建议：

• 同时检查"登录"和"系统"两个钥匙串
• 在左侧边栏切换查看不同钥匙串内容

2. 优化筛选条件

钥匙串访问默认显示"我的证书"类别，这可能会隐藏部分证书：

• 尝试切换到"证书"或"所有项目"视图
• 使用搜索框输入"Developer ID"或"Developer ID Application"进行精确查找

3. 证书信任状态检查

如果发现证书但显示不受信任（红色X标记）：

• 双击证书打开详情
• 展开"信任"部分
• 设置为"始终信任"或"使用系统默认值"

专业导出流程

1. 准备证书和私钥

正确的导出需要同时包含证书和私钥：

• 点击证书旁边的箭头展开
• 确认同时显示证书和私钥项

2. 多选导出

使用Command键同时选中：

• 证书主体
• 对应的私钥
• 确保两者都被高亮显示

3. 导出为P12格式

右键选择"导出2个项目..."：

• 保存为.p12格式文件
• 设置强密码（后续将作为MACOS_SIGNING_CERTIFICATE_PASSWORD使用）

4. 导出验证

使用OpenSSL验证导出内容：

openssl pkcs12 -in your-certificate.p12 -info -noout

预期输出应包含"Certificate"和"Private Key"字样。

5. Base64编码转换

为便于在CI/CD系统中使用：

base64 -i your-certificate.p12 | pbcopy

此命令将Base64编码结果复制到剪贴板。

常见问题排查

证书不可见问题

可能原因及解决方案：

• 证书已过期：在"查看"菜单中勾选"显示过期的证书"
• 存储位置错误：检查系统钥匙串而非仅登录钥匙串
• 显示问题：尝试刷新钥匙串访问（Command+R）

缺少私钥问题

典型表现及解决方法：

• 仅能导出证书没有私钥
• 需要从Apple开发者门户重新下载完整证书
• 或从包含私钥的备份恢复

证书类型混淆

注意区分：

• 正确的："Developer ID Application: [您的名称/公司]"
• 错误的："Apple Development: [您的邮箱]"或"Mac Developer: [您的名称]"

后续配置建议

成功导出后：

1. 将Base64字符串配置为CI系统的MACOS_SIGNING_CERTIFICATE_P12_BASE64变量
2. 确保MACOS_SIGNING_CERTIFICATE_PASSWORD与导出密码一致
3. 验证CI系统能够正确导入并使用证书进行签名

安全注意事项

1. P12文件包含敏感信息，应妥善保管
2. 建议使用密码管理器生成和存储证书密码
3. 定期轮换证书以提高安全性
4. 不在版本控制系统中直接存储证书文件

通过以上步骤，您应该能够顺利完成CodeLooper项目所需的开发者ID证书导出工作，为后续的自动化构建流程奠定基础。