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
)