Briefcase项目在macOS应用打包中的Notarization问题分析与解决

在macOS应用开发中，使用Briefcase工具进行打包时，开发者可能会遇到Notarization(公证)失败的问题。本文将深入分析这一问题，并提供有效的解决方案。

问题现象

当使用Briefcase 0.3.20版本打包macOS应用时，部分开发者会遇到Notarization失败的情况。具体表现为：

1. 公证过程返回"Invalid"状态
2. 尝试将公证结果附加到应用包时失败
3. 错误提示"Record not found"和"Could not find base64 encoded ticket"

问题根源

经过深入分析，发现问题与以下因素相关：

1. Python版本差异：Python 3.10和3.11环境下会出现问题，而3.12和3.13则工作正常
2. 支持包版本：Briefcase使用的底层支持包存在版本兼容性问题
3. 文件属性：某些支持包版本中的文件包含扩展属性，可能导致公证失败

解决方案

针对这一问题，开发者可以采取以下两种解决方案：

方案一：升级Python环境

将开发环境升级至Python 3.12或3.13版本，这些版本使用的支持包已经修复了相关问题。

方案二：手动指定支持包版本

在项目的配置文件中，为macOS平台添加特定版本的支持包配置：

[tool.briefcase.app.你的应用名.macOS]
support_revision = "版本号"

版本号根据Python版本选择：

• Python 3.9: "15"
• Python 3.10: "11"
• Python 3.11: "6"

技术背景

macOS应用公证是苹果引入的安全机制，要求所有开发者签名的应用必须经过苹果服务器的验证。Briefcase工具自动化了这一过程，包括：

1. 应用签名
2. 提交公证请求
3. 等待公证结果
4. 将公证结果附加到应用包

当支持包中存在不兼容的文件属性时，虽然签名过程可能成功，但公证服务器会拒绝请求，导致最终附加公证结果失败。

最佳实践

为避免类似问题，建议开发者：

1. 保持Briefcase工具和依赖项的最新版本
2. 定期检查项目配置中的支持包版本
3. 在开发环境中使用较新的Python版本
4. 关注Briefcase项目的更新日志，特别是与公证相关的改进

Briefcase团队已经在新版本中修复了这一问题，开发者可以放心使用最新版本进行macOS应用的打包和公证。