构建并发布 macOS 应用

本指南提供了一个逐步的教程，介绍了如何将 Flutter 应用发布到 App Store。

在开始发布应用的过程之前，请确保您的应用符合 Apple 的 App Review Guidelines。

为了将您的应用发布到 App Store，您首先必须注册 Apple Developer Program。您可以在 Apple 的 选择会员资格指南中了解更多关于各种会员选项的信息。

在 App Store Connect（以前称为 iTunes Connect）上管理您的应用生命周期。您定义您的应用名称和描述，添加屏幕截图，设置定价，并管理发布到 App Store 和 TestFlight 的版本。

注册您的应用涉及两个步骤：注册唯一的 Bundle ID，以及在 App Store Connect 上创建应用记录。

有关 App Store Connect 的详细概述，请参阅 App Store Connect 指南。

每个 macOS 应用程序都与一个 Bundle ID 相关联，该 Bundle ID 是在 Apple 注册的唯一标识符。要注册您应用的 Bundle ID，请按照以下步骤操作

1. 打开您的开发者帐户的 App IDs 页面。
2. 单击 + 以创建新的 Bundle ID。
3. 输入应用名称，选择 Explicit App ID，并输入一个 ID。
4. 选择您的应用使用的服务，然后单击 Continue。
5. 在下一页，确认详细信息并单击 Register 以注册您的 Bundle ID。

在 App Store Connect 上注册您的应用

1. 在您的浏览器中打开 App Store Connect。
2. 在 App Store Connect 登录页面，单击 My Apps。
3. 单击“我的应用”页面的左上角 +，然后选择 New App。
4. 在出现的表单中填写您的应用详细信息。在“平台”部分，确保选中 macOS。由于 Flutter 目前不支持 tvOS，请不要选中该复选框。单击 Create。
5. 导航到您应用的应用程序详细信息，并从侧边栏选择 App Information。
6. 在“常规信息”部分，选择您在上一步中注册的 Bundle ID。

有关详细概述，请参阅 将应用添加到您的帐户。

本步骤涵盖了查看 Xcode 工作区中最重要设置。有关详细的步骤和描述，请参阅 准备应用分发。

导航到 Xcode 中的目标设置

1. 在 Xcode 中，打开您应用 macos 文件夹中的 Runner.xcworkspace。
2. 要查看您的应用设置，请在 Xcode 项目导航器中选择 Runner 项目。然后在主视图侧边栏中，选择 Runner 目标。
3. 选择 General 选项卡。

验证最重要的设置。

在 Identity 部分

应用类别

您的应用将在 Mac App Store 上列出的应用类别。不能为“无”。

Bundle Identifier

您在 App Store Connect 上注册的 App ID。

在 Deployment info 部分

部署目标

您的应用支持的最低 macOS 版本。要检查 Flutter 支持部署到哪些版本的 macOS，请查看 Flutter 的 支持的部署平台。

在 Signing & Capabilities 部分

自动管理签名

Xcode 是否应自动管理应用签名和配置。默认设置为 true，对于大多数应用来说应该足够了。对于更复杂的场景，请参阅 代码签名指南。

团队

选择与您的注册 Apple Developer 帐户关联的团队。如果需要，选择 Add Account...，然后更新此设置。

您的项目设置的 General 选项卡应如下所示

有关应用签名的详细概述，请参阅 创建、导出和删除签名证书。

产品标识符的配置集中在 macos/Runner/Configs/AppInfo.xcconfig 中。对于应用名称，设置 PRODUCT_NAME，对于版权信息设置 PRODUCT_COPYRIGHT，最后设置 PRODUCT_BUNDLE_IDENTIFIER 用于应用的 Bundle Identifier。

应用的默认版本号是 1.0.0。要更新它，请导航到 pubspec.yaml 文件并更新以下行：

version: 1.0.0+1

版本号由三个用点分隔的数字组成，例如上面的示例中的 1.0.0，后跟一个可选的构建号，例如上面的示例中的 1，用 + 分隔。

版本号和构建号都可以通过指定 --build-name 和 --build-number 来在 Flutter 的构建中覆盖。

在 macOS 中，build-name 使用 CFBundleShortVersionString，而 build-number 使用 CFBundleVersion。请在 Apple Developer 网站上阅读有关 iOS 版本控制的更多信息：Core Foundation Keys。

创建新的 Flutter 应用时，会创建一个占位符图标集。本步骤涵盖使用您的应用图标替换这些占位符图标

1. 查看 macOS 应用图标 指南。
2. 在 Xcode 项目导航器中，选择 Runner 文件夹中的 Assets.xcassets。使用您自己的应用图标更新占位符图标。
3. 通过使用 flutter run -d macos 运行您的应用来验证图标是否已替换。

本步骤涵盖使用 Xcode 创建构建归档文件并将您的构建上传到 App Store Connect。

在开发过程中，您一直在使用 debug 构建进行构建、调试和测试。当您准备将您的应用发布给用户在 App Store 或 TestFlight 上使用时，您需要准备一个 release 构建。此时，您可能需要考虑 混淆您的 Dart 代码 以使其更难以进行逆向工程。混淆您的代码涉及在构建命令中添加几个标志。

在 Xcode 中，配置应用版本和构建

1. 打开您应用 macos 文件夹中的 Runner.xcworkspace。要从命令行执行此操作，请从您的应用程序项目的基本目录运行以下命令。

   open macos/Runner.xcworkspace
   

   content_copy
2. 在 Xcode 项目导航器中选择 Runner，然后在设置视图侧边栏中选择 Runner 目标。
3. 在“身份”部分，更新 Version 为您希望发布的面向用户的版本号。
4. 在“身份”部分，更新 Build 标识符为用于在 App Store Connect 上跟踪此构建的唯一构建号。每次上传都需要一个唯一的构建号。

最后，创建构建归档文件并将其上传到 App Store Connect

1. 创建您应用程序的 release 归档文件。从您的应用程序项目的基本目录运行以下命令。

   flutter build macos
   

   content_copy
2. 打开 Xcode 并选择 Product > Archive 以打开上一步创建的归档文件。
3. 单击 Validate App 按钮。如果报告了任何问题，请解决它们并生成另一个构建。您可以在上传归档文件之前重用相同的构建 ID。
4. 在归档文件成功验证后，单击 Distribute App。您可以在 App Store Connect 上应用的详细信息页面的“活动”选项卡中跟踪您的构建状态。

您应该在 30 分钟内收到一封电子邮件，通知您您的构建已通过验证，并且可以发布给 TestFlight 上的测试人员。此时，您可以选择是否发布到 TestFlight，或者继续将您的应用发布到 App Store。

有关更多详细信息，请参阅 将应用上传到 App Store Connect。

本步骤涵盖使用 Flutter 构建命令和在 Flutter 项目目录中的终端中执行的 Codemagic CLI 工具 创建构建归档文件并将您的构建上传到 App Store Connect。

1. 安装 Codemagic CLI 工具

   bash

   pip3 install codemagic-cli-tools
   

   content_copy

2. 您需要生成一个具有应用管理器访问权限的 App Store Connect API Key，以自动执行与 App Store Connect 的操作。为了使后续命令更简洁，请从新的密钥设置以下环境变量：issuer id、key id 和 API 密钥文件。

   bash

   export APP_STORE_CONNECT_ISSUER_ID=aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee
   export APP_STORE_CONNECT_KEY_IDENTIFIER=ABC1234567
   export APP_STORE_CONNECT_PRIVATE_KEY=`cat /path/to/api/key/AuthKey_XXXYYYZZZ.p8`
   

   content_copy

3. 您需要导出或创建一个 Mac 应用分发和 Mac 安装程序分发证书才能执行代码签名和打包构建归档文件。

   如果您有现有的 证书，则可以通过对每个证书执行以下命令来导出私钥

   bash

   openssl pkcs12 -in <certificate_name>.p12 -nodes -nocerts | openssl rsa -out cert_key
   

   content_copy

   或者，您可以通过执行以下命令来创建新的私钥

   bash

   ssh-keygen -t rsa -b 2048 -m PEM -f cert_key -q -N ""
   

   content_copy

   稍后，CLI 工具可以自动创建一个新的 Mac 应用分发和 Mac 安装程序分发证书。您可以对每个新证书使用相同的私钥。

4. 从 App Store Connect 获取代码签名文件

   bash

   app-store-connect fetch-signing-files YOUR.APP.BUNDLE_ID \
       --platform MAC_OS \
       --type MAC_APP_STORE \
       --certificate-key=@file:/path/to/cert_key \
       --create
   

   content_copy

   其中 cert_key 是您导出的 Mac 应用分发证书私钥或自动生成新证书的新私钥。

5. 如果您没有 Mac 安装程序分发证书，则可以通过执行以下操作创建新证书

   bash

   app-store-connect certificates create \
       --type MAC_INSTALLER_DISTRIBUTION \
       --certificate-key=@file:/path/to/cert_key \
       --save
   

   content_copy

   使用您之前创建的私钥的 cert_key。

6. 获取 Mac 安装程序分发证书

   bash

   app-store-connect certificates list \
       --type MAC_INSTALLER_DISTRIBUTION \
       --certificate-key=@file:/path/to/cert_key \
       --save
   

   content_copy

7. 设置一个用于代码签名的临时 Keychain

   bash

   keychain initialize
   

   content_copy

8. 现在将获取的证书添加到您的 Keychain

   bash

   keychain add-certificates
   

   content_copy

9. 更新 Xcode 项目设置以使用获取的代码签名配置文件

   bash

   xcode-project use-profiles
   

   content_copy

10. 安装 Flutter 依赖项

    bash

    flutter packages pub get
    

    content_copy

11. 安装 CocoaPods 依赖项

    bash

    find . -name "Podfile" -execdir pod install \;
    

    content_copy

12. 构建 Flutter macOS 项目

    bash

    flutter build macos --release
    

    content_copy

13. 打包应用

    bash

    APP_NAME=$(find $(pwd) -name "*.app")
    PACKAGE_NAME=$(basename "$APP_NAME" .app).pkg
    xcrun productbuild --component "$APP_NAME" /Applications/ unsigned.pkg
    
    INSTALLER_CERT_NAME=$(keychain list-certificates \
              | jq '[.[]
                | select(.common_name
                | contains("Mac Developer Installer"))
                | .common_name][0]' \
              | xargs)
    xcrun productsign --sign "$INSTALLER_CERT_NAME" unsigned.pkg "$PACKAGE_NAME"
    rm -f unsigned.pkg
    

    content_copy

14. 将打包的应用发布到 App Store Connect

    bash

    app-store-connect publish \
        --path "$PACKAGE_NAME"
    

    content_copy

15. 如前所述，请务必将您的登录钥匙串设置为默认值，以避免应用程序的身份验证问题。

    bash

    keychain use-login
    

    content_copy

TestFlight 允许开发者将他们的应用程序推送给内部和外部测试人员。此可选步骤涵盖在 TestFlight 上发布您的构建版本。

1. 导航到 App Store Connect 上您应用程序的应用程序详情页面的 TestFlight 选项卡。
2. 在侧边栏中选择 内部测试。
3. 选择要发布给测试人员的构建版本，然后点击 保存。
4. 添加任何内部测试人员的电子邮件地址。您可以在 App Store Connect 的 用户和角色 页面添加其他内部用户，该页面可通过页面顶部的下拉菜单访问。

请参阅 分发指南，为分发到指定 Mac 计算机做好准备。

当您准备好将您的应用程序发布到世界时，请按照以下步骤提交您的应用程序进行审核并发布到 App Store

1. 在 App Store Connect 上您应用程序的应用程序详情页面的侧边栏中选择 定价和可用性，并填写所需信息。
2. 从侧边栏中选择状态。如果这是此应用程序的首次发布，其状态为 1.0 准备提交。填写所有必填字段。
3. 点击 提交审核。

Apple 会在应用程序审核流程完成后通知您。您的应用程序将根据您在 版本发布 部分中指定的说明进行发布。

有关更多详细信息，请参阅 通过 App Store 分发应用程序。

分发您的应用程序 指南提供了有关将应用程序发布到 App Store 的流程的详细概述。

要了解如何以开源方式打包和分发您的 Flutter macOS 桌面应用程序，而无需使用付费的 Apple 开发者帐户，请查看逐步的 macOS 打包指南。