Apple App Store

  • 引入于 15.8 版本，功能标志为 apple_app_store_integration。默认禁用。
  • 一般可用于 15.10 版本。功能标志 apple_app_store_integration 删除。

通过 Apple App Store 集成，您可以配置 CI/CD 流水线连接到 App Store Connect，从而为 iOS、iPadOS、macOS、tvOS 和 watchOS 构建和发布应用程序。

该集成旨在能够与 fastlane 开箱即用，但也可以与其他构建工具一起使用。

先决条件

启用此集成需要在 Apple Developer Program 中注册的 Apple ID。

配置极狐GitLab

极狐GitLab 支持在项目级别启用 Apple App Store 集成。在极狐GitLab 中完成以下步骤：

  1. 在 Apple App Store Connect 门户中，按照说明文档，为您的项目生成一个新的私钥。
  2. 在顶部栏中，选择 主菜单 > 项目 并找到您的项目。
  3. 在左侧边栏中，选择 设置 > 集成。
  4. 选择 Apple App Store。
  5. 打开 启用集成 下的 启用 开关。
  6. 提供 Apple App Store Connect 配置信息：
    • Issuer ID：Apple App Store Connect Issuer ID 可在 Apple App Store Connect 门户的用户和访问下的密钥部分找到。
    • Key ID：刚刚生成的新私钥的 Key ID。
    • Private Key：刚刚生成的私钥。注意：您只能下载此密钥一次。
  7. 选择 保存更改。

启用 Apple App Store 集成后：

  • 全局变量 $APP_STORE_CONNECT_API_KEY_ISSUER_ID、$APP_STORE_CONNECT_API_KEY_KEY_ID 和$APP_STORE_CONNECT_API_KEY_KEY 是为 CI/CD 使用而创建的。
  • $APP_STORE_CONNECT_API_KEY_KEY 包含 Base64 编码的私钥。

安全注意事项

CI/CD 变量安全

推送到您的 .gitlab-ci.yml 文件的恶意代码可能会破坏您的变量，包括 $APP_STORE_CONNECT_API_KEY_KEY，并将它们发送到第三方服务器。有关详细信息，请参阅 CI/CD 变量安全。

fastlane 示例

因为这种集成与 fastlane 开箱即用，所以将下面的代码添加到应用程序的 fastlane/Fastfile 会启用集成，并为与 Apple App Store 上传 Test Flight 或公共 App Store 版本的任何交互创建连接。 

app_store_connect_api_key(
  is_key_content_base64: true
)