Electron Forge 打包应用上传Mac App Store常见问题解析

在使用Electron Forge构建并上传Mac应用至App Store时，开发者常会遇到"Asset validation failed (90259) Bad Bundle Executable"错误。本文将深入分析这一问题的成因及解决方案。

问题现象

当开发者使用Electron Forge 7.3.0构建Mac应用，并尝试通过Transporter工具上传至App Store时，系统会报错提示"无效的CFBundleExecutable键值"。尽管应用在本地安装运行正常，但无法通过苹果的验证流程。

根本原因分析

该问题通常由以下两个核心因素导致：

1. 签名配置不当：应用未正确使用Apple Distribution证书进行签名，或未启用沙盒环境运行权限。

2. 文件权限问题：应用包内的某些目录缺少可执行权限，导致验证失败。

解决方案详解

1. 正确的签名配置

确保在Electron Forge配置中正确设置签名参数：

• 使用"Apple Distribution"证书进行应用签名
• 使用"3rd Party Mac Developer Installer"证书进行安装包签名
• 确保启用沙盒环境运行权限

签名配置示例：

{
  "osxSign": {
    "identity": "Apple Distribution证书名称",
    "hardenedRuntime": true,
    "entitlements": "entitlements.plist",
    "entitlements-inherit": "entitlements.plist"
  }
}

2. 文件权限检查

构建完成后，应检查应用包内所有目录和文件的权限设置：

• 确保主要可执行文件具有执行权限
• 检查Resources目录下的所有文件权限
• 验证Frameworks目录中的动态库权限

可通过以下命令检查权限：

ls -lR /path/to/YourApp.app

3. 构建流程优化

建议采用以下构建流程：

1. 清理构建目录
2. 执行完整构建
3. 验证签名有效性
4. 检查文件权限
5. 最后进行上传

经验总结

在实际开发中，签名问题往往不会直接报错，而是表现为静默失败。因此建议：

• 在构建后立即验证签名状态
• 使用命令行工具检查签名有效性
• 在本地测试环境中模拟App Store的验证流程

通过以上方法，开发者可以有效解决Electron应用上传至Mac App Store时的验证问题，确保应用顺利上架。