Electron应用提交至Mac App Store全流程指南
项目地址: https://gitcode.com/gh_mirrors/ele/electron 作为一款跨平台桌面应用开发框架，Electron允许开发者使用Web技术构建原生应用。本文将详细介绍如何将Electron应用打包并提交至Mac App Store的全过程，包括签名流程、提交步骤以及MAS构建的特殊限制。
一、准备工作
在开始之前，请确保您已具备以下条件：
-
开发环境要求：
- 安装Xcode 11或更高版本
- 安装@electron/osx-sign模块（用于应用签名）
-
开发者账户：
- 注册Apple Developer账户
- 加入Apple Developer Program（年费$99）
二、应用签名详解
2.1 获取证书
通过Xcode获取签名证书是最简便的方式：
- 打开Xcode → 偏好设置 → Accounts
- 登录Apple账号
- 选择团队 → 管理证书
- 添加以下两种证书：
- Apple Development：用于开发和测试
- Apple Distribution：用于提交至App Store
注意：使用"Apple Distribution"证书签名的应用无法直接运行，必须通过App Store下载后才能使用。
2.2 证书类型说明
| 证书类型 | 用途 | 适用场景 |
|---|---|---|
| Apple Development | 开发测试 | 本地调试 |
| Apple Distribution | 正式发布 | App Store分发 |
| Developer ID Application | 非App Store分发 | 直接下载安装 |
| Developer ID Installer | 安装包签名 | 较少使用 |
2.3 准备配置文件(Provisioning Profile)
测试签名应用前需要创建配置文件：
- 在Apple Developer网站创建App ID
- 注册测试设备（通过系统信息获取Device ID）
- 创建开发配置文件并下载到本地
三、应用签名实战
3.1 开发环境签名
使用以下代码进行开发签名：
const { signAsync } = require('@electron/osx-sign')
signAsync({
app: '/path/to/your.app',
identity: 'Apple Development',
provisioningProfile: '/path/to/your.provisionprofile'
})
3.2 发布签名
提交至App Store的签名方式：
const { signAsync } = require('@electron/osx-sign')
signAsync({
app: 'path/to/your.app',
identity: 'Apple Distribution'
})
四、App Sandbox配置
所有提交至Mac App Store的应用都必须启用App Sandbox。使用@electron/osx-sign时，它会自动添加必要的权限配置。
如需手动配置，需要在entitlements.plist中包含：
<key>com.apple.security.app-sandbox</key>
<true/>
<key>com.apple.security.application-groups</key>
<array>
<string>TEAM_ID.your.bundle.id</string>
</array>
五、提交至Mac App Store
5.1 上传流程
- 使用Apple Transporter工具上传签名后的应用
- 确保已在App Store Connect创建应用记录
5.2 审核提交
上传完成后，在App Store Connect中提交审核申请。
六、MAS构建的特殊限制
由于App Sandbox的限制，MAS构建有以下特点：
-
禁用模块：
- crashReporter
- autoUpdater
-
功能变更：
- 视频捕捉可能失效
- 部分辅助功能不可用
- 无法感知DNS变更
-
资源访问限制：
- 文件系统访问受限
- 网络权限需额外配置
七、常见权限配置
7.1 网络权限
<!-- 出站连接 -->
<key>com.apple.security.network.client</key>
<true/>
<!-- 入站连接 -->
<key>com.apple.security.network.server</key>
<true/>
7.2 文件对话框权限
<!-- 打开对话框 -->
<key>com.apple.security.files.user-selected.read-only</key>
<true/>
<!-- 保存对话框 -->
<key>com.apple.security.files.user-selected.read-write</key>
<true/>
八、加密算法说明
Electron使用了多种标准加密算法，包括AES、HMAC、ECDSA等，完整列表可参考相关加密标准文档。
通过本文的详细指导，开发者可以顺利完成Electron应用从签名到提交App Store的全流程。需要注意的是，Apple的审核标准可能会变化，建议在提交前仔细阅读最新的App Store审核指南。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
