iOS项目中基于Bazel的自动代码签名管理方法及支持性咨询

一、Bazel对自动代码签名的支持情况 #

Bazel通过rules_apple（原apple_rules）提供iOS代码签名支持，包括自动签名相关能力，但和Xcode的自动签名逻辑不完全一致，需要结合特定规则与配置对接系统签名基础设施。local_provisioning_profile是核心规则之一，但需配合其他配置完成完整的自动签名流程。

二、实现自动代码签名的配置步骤 #

1. 引入rules_apple依赖 #

在项目的WORKSPACE文件中添加以下配置，确保引入最新版本的rules_apple：

load("@bazel_tools//tools/build_defs/repo:http.bzl", "http_archive")

http_archive(
    name = "build_bazel_rules_apple",
    sha256 = "<对应版本的SHA256值>",
    url = "https://github.com/bazelbuild/rules_apple/releases/download/<版本号>/rules_apple.<版本号>.tar.gz",
)

load("@build_bazel_rules_apple//apple:repositories.bzl", "apple_rules_dependencies")
apple_rules_dependencies()

load("@build_bazel_rules_apple//apple:setup.bzl", "apple_rules_setup")
apple_rules_setup()

2. 用local_provisioning_profile管理描述文件 #

该规则用于指定签名所需的描述文件，支持通过名称自动匹配本地已安装的文件，是实现自动签名的基础。在BUILD文件中定义：

load("@build_bazel_rules_apple//apple:apple.bzl", "local_provisioning_profile")

local_provisioning_profile(
    name = "ios_app_profile",
    # 通过描述文件名称自动匹配本地文件
    profile_name = "iOS Team Provisioning Profile: com.your.app",
    # 也可直接指定本地文件路径
    # profile = "//path/to:your_profile.mobileprovision",
)

3. 在iOS应用目标中配置自动签名 #

在ios_application规则中关联签名配置，开启自动签名选项：

load("@build_bazel_rules_apple//apple:apple.bzl", "ios_application")

ios_application(
    name = "YourApp",
    bundle_id = "com.your.app",
    families = ["iphone", "ipad"],
    infoplists = ["//path/to:Info.plist"],
    minimum_os_version = "15.0",
    provisioning_profile = ":ios_app_profile",
    # 开启自动签名，Bazel会自动匹配对应证书
    automatic_signing = True,
    # 必须指定Apple开发者团队ID
    development_team = "YOUR_TEAM_ID",
)

4. 进阶场景配置 #

• 多环境签名切换：通过构建参数结合select逻辑实现不同环境的签名配置切换：

  # 构建生产环境包
  bazel build //:YourApp --define=env=prod
  

  BUILD文件中对应配置：

  local_provisioning_profile(
      name = "prod_profile",
      profile_name = "iOS Distribution Provisioning Profile: com.your.app",
  )
  
  local_provisioning_profile(
      name = "dev_profile",
      profile_name = "iOS Team Provisioning Profile: com.your.app",
  )
  
  ios_application(
      name = "YourApp",
      # ...其他基础配置
      provisioning_profile = select({
          "//conditions:default": ":dev_profile",
          "//:prod": ":prod_profile",
      }),
      development_team = select({
          "//conditions:default": "DEV_TEAM_ID",
          "//:prod": "PROD_TEAM_ID",
      }),
  )
  

• 签名缓存清理：若遇到签名异常，可清理Bazel缓存后重新构建：

  bazel clean --expunge
  

三、注意事项 #

• Bazel自动签名依赖本地已安装的开发者证书和描述文件，需确保Mac已配置好Apple开发者账号，且对应文件已下载到本地。
• 常规开发、测试和App Store分发场景下，automatic_signing + development_team的配置即可满足需求；企业级签名等特殊场景可能需要额外配置certificate规则指定特定证书。
• 相比Xcode，Bazel的自动签名在自动创建描述文件等边缘场景支持有限，若需完全自动化创建描述文件，可配合Fastlane等工具辅助完成。

内容的提问来源于stack exchange，提问作者Krypt