Published on

如何将 Electron 项目上架 Apple Store

Authors
  • Name
    Twitter

将 Electron 应用上架到 Apple Store 需要经过几个关键步骤。本指南将帮助你了解整个过程，从准备工作到最终提交审核。

1. 准备工作

1.1 注册 Apple Developer 账号

  • 访问 Apple Developer 网站
  • 注册一个 Apple Developer 账号（个人或组织）
  • 支付年费（目前是 $99/年）

1.2 获取必要证书和标识符

  1. 创建 App ID：

    • 登录 Apple Developer 控制台
    • 导航到 "Certificates, Identifiers & Profiles"
    • 创建一个新的 App ID，格式通常为 "com.yourcompany.yourapp"

  2. 创建生产证书：

    • 在同一页面，创建一个 "Mac App Distribution" 证书
    • 下载并安装证书到你的 Mac 上

  3. 创建 Mac Provisioning Profile：

    • 选择刚才创建的 App ID
    • 选择生产证书
    • 下载并安装 Provisioning Profile

2. 调整 Electron 应用

2.1 符合 Apple 指南

2.2 配置应用以使用 App Sandbox

  1. 创建一个 entitlements.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.app-sandbox</key>
    <true/>
    <!-- 根据需要添加其他权限 -->
  </dict>
</plist>
  1. 在 electron-builder 配置中引用这个文件

3. 打包和签名

3.1 配置 electron-builder

在 package.json 中添加以下配置：

{
  "build": {
    "appId": "com.yourcompany.yourapp",
    "mac": {
      "category": "public.app-category.productivity",
      "hardenedRuntime": true,
      "gatekeeperAssess": false,
      "entitlements": "build/entitlements.mac.plist",
      "entitlementsInherit": "build/entitlements.mac.plist",
      "provisioningProfile": "path/to/yourprofile.provisionprofile"
    },
    "mas": {
      "entitlements": "build/entitlements.mas.plist",
      "entitlementsInherit": "build/entitlements.mas.inherit.plist",
      "provisioningProfile": "path/to/yourprofile.provisionprofile"
    }
  }
}

3.2 运行打包命令

electron-builder --mac mas

这将生成一个针对 Mac App Store 的 .app 包。

4. 使用 Xcode 提交应用

  1. 打开 Xcode
  2. 选择 "Open Developer Tool" > "Application Loader"
  3. 选择你的 .app 文件并上传

5. 在 App Store Connect 中配置应用

  1. 登录 App Store Connect
  2. 创建一个新的应用
  3. 填写所有必要的信息：
    • 应用名称
    • 描述
    • 截图
    • 分类
    • 价格和可用性
    • 版本信息

6. 提交审核

  1. 在 App Store Connect 中，选择你的应用
  2. 点击 "提交以供审核"
  3. 回答所有必要的问题
  4. 确认并提交

7. 等待审核结果

  • 审核过程通常需要几天到几周
  • 保持关注你的邮箱，以防 Apple 需要额外信息

8. 处理反馈

  • 如果被拒绝，仔细阅读拒绝原因
  • 根据反馈修改应用
  • 重新提交审核

注意事项

  1. 沙盒化：确保你的应用完全兼容 App Sandbox
  2. 更新：后续更新也需要经过审核流程
  3. 版本控制：使用语义化版本控制，每次提交新版本时增加版本号
  4. 测试：在提交之前，彻底测试你的应用
  5. 文档：准备好详细的文档，以防审核人员需要额外信息

通过遵循这个指南，你应该能够成功地将你的 Electron 应用上架到 Apple Store。记住，这个过程可能需要多次尝试，保持耐心和积极态度很重要。如果遇到特定问题，不要犹豫向 Apple 开发者支持寻求帮助。