CasADi项目中的macOS软件签名与公证流程详解

在macOS平台上发布软件时，开发者需要遵循苹果严格的安全规范。本文将以CasADi项目为例，详细介绍macOS应用的代码签名(Code Signing)和公证(Notarization)的完整技术流程。

一、代码签名基础

代码签名是苹果生态系统中确保软件来源可信的重要机制。开发者需要完成以下步骤：

1. 生成密钥和证书请求
   使用OpenSSL生成2048位RSA私钥和证书签名请求(CSR)：

   openssl req -new -newkey rsa:2048 -nodes -keyout private.key -out request.csr
   

2. 创建开发者ID证书
   在苹果开发者账户中申请"Developer ID Application"类型证书，下载获得的.cer文件。

3. 证书格式转换
   将DER格式的证书转换为PEM格式：

   openssl x509 -in developer.cer -inform der -out certificate.pem
   

4. 创建PKCS#12文件
   将私钥和证书打包为.p12文件（必须设置密码）：

   openssl pkcs12 -export -inkey private.key -in certificate.pem -out certificate.p12
   

二、签名密钥链配置

正确配置钥匙串是签名过程的关键：

# 创建临时钥匙串
security create-keychain -p password signing.keychain

# 解锁并设为默认钥匙串
security unlock-keychain -p password ~/Library/Keychains/signing.keychain-db
security default-keychain -s ~/Library/Keychains/signing.keychain-db

# 设置分区列表
security set-key-partition-list -S apple-tool:,apple: -s -k password ~/Library/Keychains/signing.keychain-db

# 导入证书和私钥
security import developer.cer -k signing.keychain -T /usr/bin/codesign
security import certificate.p12 -k ~/Library/Keychains/signing.keychain-db -P "p12密码" -T /usr/bin/codesign

# 验证身份
security find-identity -v

三、公证流程详解

公证是苹果要求的额外安全验证步骤，需要注意：

1. 双重公证要求
   如果使用自定义安装程序，需要分两个阶段公证：

   • 首先公证安装包内的所有内容
   • 然后公证整个安装程序本身

2. 公证状态检查
   提交公证后，可以使用以下命令查询状态：

   xcrun notarytool info [UUID] --apple-id 账号 --team-id 团队ID --password 密码
   

3. 验证签名和公证
   完成公证后，应验证签名和公证状态：

   # 验证代码签名
   codesign --verify --deep --verbose 文件路径
   
   # 检查公证状态
   spctl -a -vv -t install 文件路径
   

四、持续集成配置

在CI环境中（如GitHub Actions），需要：

1. 将.p12文件Base64编码后存储为环境变量
2. 配置以下必要参数：
   • APPLE_ID：苹果开发者账号邮箱
   • APPLE_TEAM_ID：开发者团队ID
   • DEVELOPMENT_CERTIFICATE_DATA：Base64编码的证书数据

五、最佳实践建议

1. 始终为.p12文件设置密码，避免命令行工具兼容性问题
2. 在测试环境中充分验证签名和公证流程
3. 保留完整的公证日志以备审查
4. 考虑使用自动化工具简化重复性操作

通过以上流程，开发者可以确保CasADi等macOS应用符合苹果的安全要求，为用户提供安全可靠的软件分发体验。