多端应用使用云开发

在多端框架使用云开发等云能力的方法,以及相关的注意事项。

一、初始化改造

在「多端应用」中使用云开发时,需要在 cloud.init 时显式指定云开发环境所在的微信 AppID:

wx.cloud.init({
  appid: 'wx1234567890', // 创建云开发环境的 AppID(小程序、公众号),不是多端应用 AppID
  envid: 'env-id-example', // 云开发环境名称
})

二、多端登录模式使用

当「多端应用」中采用以下登录方式成功登录后,可以无缝使用云开发,和在微信小程序内使用无异。

  1. 唤起微信小程序登录open in new window
  2. 移动应用微信登录open in new window:此方式需要在「微信开发者工具-云开发-更多-环境共享-添加共享」给 移动应用 APPID 共享环境。
  3. 其他方式登录:如果使用其他方式登录,如手机号登录,需要在登录后去绑定微信open in new window,绑定成功后以其他方式登录,会自动关联移动应用微信账号,等同于使用移动应用微信登录open in new window

在环境共享时,「多端应用」中填写的 APPID 应为 移动应用 APPID(需是绑定多端应用的),如下所示

当使用实例模式初始化时,示例代码如下:

App({
  async onLaunch() {
    this.cloud = new wx.cloud.Cloud({
      appid: 'wx1234567890', // 此应为移动应用 APPID
      resourceAppid: 'wx987654321', // 云开发环境所归属的资源小程序、公众号或第三方平台 APPID
      resourceEnv: 'env-id-example', // 云开发环境ID
    })
    await this.cloud.init()
  }
})
wx.weixinAppLogin({
    success (res) {
      // 成功登录后会自动初始云开发,登录之前云开发只能用未登录模式。
    }
})

登录前、登录失败情况下,使用云开发参考以下「未登录模式」

三、未登录模式使用

默认情况下,在多端框架内是无法正常使用云开发的,包括云函数、数据库等。这是因为多端环境中缺失微信登录态信息的(即 cloud.getWXContext 内无 OPENID)。为此,我们提供了云开发的未登录模式,开发者可以进行以下配置,在多端环境中以未登录态模式使用云开发。

3.1 开启环境级别开关

为了允许未登录模式用户访问云环境资源,需要在「微信开发者工具-云开发-设置-权限设置-未登录用户访问云资源权限设置」打开相应云环境的开关。

3.2 配置云函数安全规则

调用云函数时,由于未登录模式的限制,还需要配置云函数的安全规则open in new window。参考安全规则如下(云函数 function1 支持未登录模式调用):

{
  // * 为通配符,表示对所有函数适用
  "*": {
    // invoke 表示调用权限控制
    // auth 包含鉴权信息,如果是未登录模式,则 auth == null
    "invoke": "auth != null"
  },
  // 函数名,该规则优先级会高于通配符
  "function1": {
    // 表示允许所有来源调用,包括未登录用户
    "invoke": true
  }
}

3.3 配置数据库安全规则

访问数据库时,由于未登录模式的限制,还需要配置数据库安全规则open in new window。参考安全规则如下(所有用户可读,仅登录后创建者可写):

{
  "read": true,
  "write": "auth != null && doc._openid == auth.openid"
}

3.4 uploadFile 、cloudId 和其他接口

未登录模式下,不支持 wx.cloud.uploadFile 以及 cloudId 等需要登录态的接口。如有上传文件需求,建议使用“多端登录模式”,或者通过腾讯云对象存储等形式直接上传到存储桶中。cloudId 访问云存储建议改以 https url 形式访问。