升级为多端项目

WARNING

请注意,当前域名 https://dev.weixin.qq.com/docs/framework 文档已不维护,请前往微信文档中心open in new window 找到对应的新文档继续使用

小程序项目升级为多端项目后,不会影响原有小程序项目工程;升级为多端项目的前置条件、操作步骤以及升级后的项目结构变动可查看下方介绍。

一、前置条件

1、开发者工具版本要求

下载并安装支持「多端应用模式」的开发者工具,对应的版本要求如下:

补充说明:建议使用最新的开发版开发者工具进行多端应用的开发和调试

2、小程序账号绑定要求

  • 需将小程序绑定于多端应用后,方可将该小程序项目升级为多端项目
  • 创建多端应用以及将小程序绑定于多端应用中,操作指南可查看:多端应用管理open in new window

二、操作步骤

将小程序账号绑定于多端应用后,即可前往微信开发者工具将小程序项目升级为多端项目,操作步骤如下:

  • 使用绑定于多端应用的小程序账号创建项目
  • 点击「升级为多端项目」,稍等片刻,即可完成项目升级
  • 升级为多端项目后自动切换至「多端应用模式」,开发者可在该模式下进行多端应用的开发与调试
  • 当小程序尚未绑定多端应用时,点击「升级多端项目」出现下方提示,此时点击「去绑定」即可快速跳转至开发平台进行账号绑定
  • 如该多端已经已开通身份管理服务,为方便开发者一键完成「多端身份管理配置」,开发者可在升级多端项目时勾选该配置

三、升级后变动

升级为多端项目后,原生小程序项目的变动如下:

变动1:project.config.json

  • project.config.json 文件的 setting 新增了一个字段 condition

    • 默认值为 true,表示启用条件编译;若为 false,则表示不启用条件编译
    • 说明:开发者工具支持条件编译,多端应用的代码不占用小程序代码包体积
  • project.config.json 文件新增了一个字段 projectArchitecture

    • 默认值为 multiPlatform,表示多端项目

变动2:project.miniapp.json

  • 新增了 project.miniapp.json 文件,用于多端项目工程的配置
  • 具体配置可点击查看详情

其他说明:如遇到问题可前往社区open in new window反馈,或者联系小助手open in new window加入官方技术交流群进行反馈