绑定移动应用

一、移动应用介绍

多端应用的 Bundle ID 和包名来源于移动应用,即需要将移动应用与多端应用绑定,才可实现自定义配置 Bundle ID 和 包名,否则只能用官方分配的测试版 Bundle ID 和 包名构建 App。

此外,微信能力的实现依赖于 openSDK,而 openSDK 的使用则依赖于移动应用账号。

简单来说,基于小程序多端框架开发的 App 如果要去正式上架以及使用微信能力(微信登录、微信分享、微信支付等)则必须创建移动应用账号且与多端应用账号进行绑定。

如果已有移动应用账号,则可参考下方文档进行绑定即可,如果还没有移动应用账号则需要先创建与审核,而创建移动应用账号之前则需要先完成微信开放平台账号的注册与认证。详情可查看创建移动应用

二、操作指引

首先需浏览器打开微信开发者平台open in new window,使用微信扫码登录进入多端控制台。如还没有多端应用账号,请查看多端应用管理创建。

2.1 绑定移动应用账号

若该多端应用尚未绑定移动应用账号,在开发者工具中构建多端资源包将默认以平台分配的测试版 Bundle ID 和 测试版 Package Name 进行构建,多端应用项目成员可正常进行体验和调试。

如果开发者要构建自己的多端应用安装包安装到手机上进行体验,且该应用有使用微信登录等开放能力,则需先完成移动应用账号绑定,否则会出现「由于应用包名签名信息校验不通过」的报错。

此外,App 正式上架前,开发者需在此处绑定移动应用账号以获取正式的 Bundle ID 和 Package Name。

2.1.1 立即绑定移动应用账号

进入多端应用详情页,前往「移动应用信息」,点击「立即绑定移动应用账号」,即可按照实际情况选择合适的方式进行绑定。

如当前用户为微信开放平台管理员,且已有审核通过的移动应用账号,则可直接绑定。

如当前用户非微信开放平台管理员,或需绑定其他移动应用,可通过填写微信开放平台账号密码以及移动应用 AppID 绑定移动应用账号。

注意:多端应用符合以下任意条件则可绑定移动应用:

  1. 非个人主体类型的微信开放平台需已完成开发者资质认证(可在「微信开放平台 - 账号中心 - 开发者资质」查看)。
  2. 移动应用账号要与移动应用所绑定的小程序为同一主体或关联主体(可在「微信开放平台 - 账号中心 - 基础资料 - 关联主体」进行操作)。
  3. 移动应用账号已审核通过。
  4. 移动应用所绑定的小程序与移动应用绑在同一个微信开放平台账号下。

2.1.2 创建移动应用账号

关于微信开放平台移动应用账号注册指引可查看创建移动应用

为方便多端的开发者更便捷创建移动应用账号,平台推出「复用多端应用快速创建移动应用」的功能,查看详细指引

2.2 更换/解绑移动应用账号

进入多端应用详情页,前往「移动应用信息」,点击「更换绑定」或「解除绑定」即更换/解绑移动应用账号。

三、注意事项

绑移动应用账号的目的是为了从移动应用那里同步 iOSBundle Id 信息和 Android 的包名信息,所以不要以为只要移动应用账号绑定成功了,多端应用这边就可以使用微信能力相关的 JSAPI 了,而是要确认清楚你的移动应用账号的 iOSBundle Id 信息 和 Android 的包名信息是否已经同时配置好了。

经常有开发者出现只配置了 iOSBundle Id 或者只配置了 Android 的包名的情况。如果只配置了一端的信息,另一端是不可用的。即并非同样的代码在 iOS 能用就在 Android 一定能用,反之亦然,一定要确保 Android 和 iOS 的配置都是正确的。

绑定好移动应用账号之后,可以登录多端应用控制台看下 Android 和 iOS 的信息是否都有了,如果某项是空的,那就是移动应用那边没有配置好。