Electron-Builder在macOS Sonoma上应用无法启动的解决方案

问题背景

在使用Electron-Builder构建macOS应用时，开发者可能会遇到应用在macOS Sonoma系统上无法启动的问题。具体表现为尝试打开应用时出现"Launch failed"错误，错误代码153。这种情况通常发生在使用最新版本的macOS系统（如Sonoma 14.3.1）和较新版本的Electron框架时。

核心问题分析

导致应用无法启动的主要原因通常与macOS的安全机制有关，特别是以下几个方面：

1. 签名和公证问题：macOS对应用的签名和公证要求越来越严格，任何签名不完整或公证不通过都会导致应用无法运行。

2. 权限配置不当：应用的entitlements文件配置不正确，特别是当应用需要访问麦克风、摄像头或屏幕录制等敏感权限时。

3. 运行时保护机制：Hardened Runtime的配置不当可能导致应用被系统阻止运行。

解决方案

1. 更新构建工具

确保使用最新版本的electron-builder（至少v24.13.0或更高），因为新版本包含了针对macOS Sonoma系统的特定修复和改进，特别是在处理extendInfo与应用权限合并方面。

2. 完善权限配置

仔细检查entitlements文件配置，确保所有需要的权限都已正确声明。对于需要访问麦克风、摄像头或屏幕录制的应用，必须包含以下权限声明：

<key>com.apple.security.device.audio-input</key>
<true/>
<key>com.apple.security.device.camera</key>
<true/>
<key>com.apple.security.screen-recording</key>
<true/>

3. 签名和公证流程

确保完整的签名和公证流程：

1. 使用有效的开发者证书进行签名
2. 配置正确的entitlements文件
3. 完成苹果的公证流程
4. 在构建配置中启用Hardened Runtime

4. 构建配置优化

在package.json的mac配置部分，确保包含以下关键设置：

"hardenedRuntime": true,
"gatekeeperAssess": false,
"entitlements": "build/entitlements.mac.plist",
"entitlementsInherit": "build/entitlements.mac.plist"

5. 多架构支持

对于Apple Silicon和Intel芯片的兼容性，确保正确配置target.arch：

"target": {
  "target": "default",
  "arch": ["x64", "arm64"]
}

调试建议

如果应用仍然无法启动，可以尝试以下调试方法：

1. 检查控制台日志获取更详细的错误信息
2. 尝试在终端中直接运行应用可执行文件
3. 使用codesign命令验证应用签名
4. 检查公证状态

总结

Electron应用在macOS Sonoma上无法启动的问题通常与系统安全机制的增强有关。通过更新构建工具、完善权限配置、确保正确的签名和公证流程，大多数情况下可以解决这类问题。开发者应该密切关注macOS系统更新和Electron生态的工具更新，及时调整构建配置以适应新的安全要求。