# 多端应用 Bundle ID 配置

Bundle ID (Bundle Identifier) 是 iOS 应用程序的唯一标识符,字符串形式,由 Apple 分配,用于识别应用商店中的应用程序。每个 iOS 应用都必须有一个唯一的 Bundle ID。因此,基于多端框架开发 iOS 应用也需为多端应用配置 Bundle ID。

本文内容主要包含基础概念说明以及配置多端应用的 Bundle ID 详细指引

# 一、基础概念

# 1.1 测试版 Bundle ID

多端应用的 Bundle ID 来源于微信开放平台移动应用配置 iOS 开发信息,然而在开发者尚未将多端应用与移动应用进行绑定时,平台为了方便开发者的构建与测试,将默认为每个多端应用分配com.tencent.devtoolssaaademo.db作为「默认的测试版 Bundle ID」

开发者工具中构建 IPA 或将在「运行于真机」时将以此「默认的测试版 Bundle ID」构建,开发者可在下方查看「默认的测试版 Bundle ID」

上述路径分别为:

  • 微信开发者平台 - 多端应用 - 详情 - 移动应用信息;
  • 微信开发者工具 - 多端应用模式 - 构建 - 打包生成 IPA

# 1.2 多端应用的 Bundle ID

  • 如果多端应用绑定了移动应用账号,那么多端应用的 Bundle ID 同步于微信开放平台移动应用,因此,在多端应用绑定了移动应用账号的情况下,如果开发者需自定义 iOS 应用的 Bundle ID,需前往「微信开放平台-管理中心-移动应用」进行修改并提交审核,待审核通过即可同步到多端应用。
  • 如果多端应用未绑定移动应用账号,那么多端应用的Bundle ID 可在多端应用的控制台直接修改即可

# 规则说明

  • 「复用移动应用账号」的包名和 bundle id 信息与「自定义配置」这两种方式是互斥的,不能同时使用,但是可以随时更换
  • 例如,如果开发者选择了「复用移动应用账号」,如果需要选择「自定义配置」,那么需要将移动应用账号解绑了(但是,解绑的瞬间会影响已构建的安装包的使用,需要马上就将 bundle id 配置回去)
  • 如果开发者选择了「自定义配置」,如果需要选择「复用移动应用账号」,那么只需要将移动应用账号绑定即可,绑定后就会将移动应用账号」的 bundle id 信息覆盖已经配置的 bundle id 信息(即,如果移动应用的 bundle id 信息和已配置的 bundle id 信息不一致的话,更换了之后也会影响已构建的安装包的使用,开发者需注意)

即,APP 运行启动的时候会检验构建安装包的时候后台配置的 bundle id 信息与当前配置的 bundle id 信息是否一致,如果不一致,则会启动失败。因此,开发者在进行 bundle id 变更的时候务必要知晓相关风险。

补充说明

  • 使用默认测试版 Bundle ID 构建的 IPA 只可用于测试体验,不可用于上架应用市场
  • 使用开发者自定义正式版 Bundle ID 构建的 IPA 可用于提交至应用市场进行审核和上架

# 二、操作步骤

# 2.1 前置步骤:在 Apple Developer 平台定义 Bundle ID

使用 Apple 开发者账号登录 Developer 控制台,前往「证书、标识符和描述文件」进入「标识符」页面,开始定义 Bundle ID,具体请参考此文档

# 2.2、自定义 bundle id 的操作步骤

  • 点击「修改」,选择「自定义配置」
  • 然后,填入在步骤 2.1 自定义的 bundle id 信息,点击确定即可

注意

  • iOS bundle ID 和 Android 包名不可以同时为空
  • 且 bundle ID 不可在使用官方分配的测试版 bundle ID "com.tencent.devtoolssaaademo.db"

# 2.3 bundle id 同步于移动应用的操作步骤

前往微信开放平台创建移动应用账号,并配置 iOS 开发信息

特别说明:此时填入的 Bundle ID 不可填平台默认分配的 com.tencent.devtoolssaaademo.db,需填入 2.1 步骤中自定义的 Bundle ID

详细的移动应用创建指引可查看复用多端应用快速创建移动应用直接创建移动应用

# 2.3.1 在多端应用控制台绑定移动应用

参考 2.3 创建并配置移动应用后,待移动应用审核通过后,即可前往 微信开发者平台,将移动应用与多端应用进行绑定。

操作路径为:多端应用 - 详情 - 移动应用配置 - 立即绑定移动应用账号

补充:在微信开发者平台绑定移动应用的详细指引可查看:绑定移动应用账号

# 2.3.2 配置后呈现效果

完成 Bundle ID 的配置后,多端应用控制台与微信开发者工具的呈现效果如下图所示:

# 2.3.3 配置后呈现效果

  • 移动应用绑定于多端应用后,开发者配置的 Bundle ID 等开发信息将从微信开放平台同步到开发者工具,此时构建的 IPA 是基于开发者配置的正式版 Bundle ID,构建 IPA 的详细指引可查看:打包生成 IPA