多端应用 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」

上述路径分别为:

1.2 开发者自定义的 Bundle ID

多端应用的 Bundle ID 来源于微信开放平台移动应用配置 iOS 开发信息,而在微信开放平台移动应用处支持配置正式 Bundle ID 和测试 Bundle ID

开发者若想为多端应用配置自定义的 Bundle ID,则需前往微信开放平台完成开发者资质认证,并且创建移动应用账号,配置 iOS 开发信息,以及提交审核。在多端应用控制台将多端应用与移动应用绑定,待移动应用审核通过。

如开发者想修改已配置的 Bundle ID,前往微信开放平台移动应用修改即可,审核通过后将会及时同步于多端应用

操作详情可查看下方的「操作步骤」

1.3 默认的测试版 Bundle ID 与 开发者自定义的正式版 Bundle ID 区别

使用默认测试版 Bundle ID 构建的 IPA 只可用于测试体验,不可用于上架应用市场

使用开发者自定义正式版 Bundle ID 构建的 IPA 可用于提交至应用市场进行审核和上架

补充:开发者自定义的测试版 Bundle ID 尚不支持在微信开发者工具中构建 IPA

二、操作步骤

2.1 在 Apple Developer 平台定义 Bundle ID

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

2.2 微信开放平台配置移动应用开发信息

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

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

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

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

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

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

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

2.4 配置后呈现效果

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

2.5 修改 Bundle ID

多端应用控制台与微信开发者工具仅支持查看 Bundle ID

如需修改 Bundle ID,可前往微信开放平台操作并重新提交移动应用审核,审核通过后,Bundle ID 等开发信息将同步到多端应用控制台与微信开发者工具(若未同步,请重启浏览器或工具)

三、其他补充

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