Electron应用申请摄像头权限时在macOS崩溃的问题求助

核心问题定位 #

崩溃的真实原因是签名后的应用包内未正确包含NSCameraUsageDescription键，系统错误提示提到的com.apple.security.device.camera需要字符串是误导——该键是Hardened Runtime的权限开关，应为布尔值，而NSCameraUsageDescription才是必填的用户权限描述字符串。开发模式正常是因为Electron对开发环境做了权限豁免，签名开启Hardened Runtime后权限校验会严格执行。

具体修复步骤 #

1. 在electron-builder配置中统一声明权限
   不要手动修改生成的Info.plist，直接在项目的package.json的build字段中配置，确保构建时自动注入正确的键：

   "build": {
     "mac": {
       "entitlements": "entitlements.mac.plist",
       "entitlementsInherit": "entitlements.mac.plist",
       "extendInfo": {
         "NSCameraUsageDescription": "This app needs access to the Camera"
       }
     }
   }
   

2. 创建正确的Hardened Runtime权限文件
   在项目根目录新建entitlements.mac.plist，内容如下：

   <?xml version="1.0" encoding="UTF-8"?>
   <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
   <plist version="1.0">
   <dict>
     <key>com.apple.security.device.camera</key>
     <true/>
     <key>hardenedRuntime</key>
     <true/>
   </dict>
   </plist>
   

3. 清理构建缓存并重新构建签名
   执行以下命令清除electron-builder的缓存和旧构建产物，避免缓存干扰：

   rm -rf node_modules/.cache/electron-builder/
   rm -rf dist/
   

   然后重新运行构建签名命令（比如npm run build）。

4. 验证最终应用包的配置
   右键生成的.app文件 → 显示包内容 → 打开Contents/Info.plist，确认其中包含NSCameraUsageDescription键；同时可以用以下命令验证entitlements：

   codesign -d --entitlements - /path/to/your/app.app
   

   输出中应包含com.apple.security.device.camera = true。

额外说明 #

• 签名前权限无反应是因为未开启Hardened Runtime时，macOS的权限校验不严格，但签名后必须同时满足NSCameraUsageDescription（用户描述）和com.apple.security.device.camera（权限开关）两个条件。
• 手动修改安装根目录的Info.plist无效，因为签名后的应用包会优先使用内部Contents目录下的配置，且签名校验会阻止外部修改的生效。

内容的提问来源于stack exchange，提问作者Felipe Lohnefink