正式构建第一个 App
WARNING
请注意，当前域名 https://dev.weixin.qq.com/docs/framework 文档已不维护，请前往微信文档中心 找到对应的新文档继续使用
参考上一篇文档快速体验多端应用可实现基于移动应用助手快速体验到将小程序转为 App 的效果，而按照文本操作即可通过微信开发者工具可将小程序在分钟内构建出 App 安装包并将应用程序安装至手机进行真机调试使用。
一、下载并安装微信开发者工具
下载并安装支持「多端应用模式」的开发者工具，对应的版本要求如下：
- 版本号 ≥ 1.06.2306272 的开发版开发者工具（建议使用最新的开发版开发者工具进行多端应用的开发和调试）
二、创建多端应用并绑定小程序
- 路径 1 ： 在微信开发者工具中，切换开发模式，下拉选择「多端应用模式」，若未绑定则扫码创建多端并绑定小程序即可
- 路径 2 ： 在微信开发者工具中，在菜单栏 - 工具 - 升级为多端项目，若未绑定则扫码创建多端并绑定小程序即可
- 路径 3 ： 前往 dev.weixin.qq.com 创建空间 - 创建多端应用 - 绑定小程序账号
三、将小程序项目升级为多端项目
在上述步骤中已经完成将小程序账号绑定于多端应用，此时可前往微信开发者工具将小程序模式切换至多端应用模式即可。
- 将小程序升级为多端项目后，不影响小程序项目，也不占小程序代码包体积
- 本次的升级只是新增了
project.miniapp.json和app.project.miniapp.json，以及在project.config.json中新增了projectArchitecture用于标记多端框架 - 即，把上述内容删除又可恢复至原来的小程序项目
四、运行于模拟器或真机
- 在工具栏中，选择要调试的「版本」然后选择要运行的模拟器或真机，再点击运行即可
- 补充 1 ，如需运行于模拟器，则需参考文档运行于模拟器安装模拟器
- 补充 2，如需运行于真机，则需要通过数据线将手机连接，然后参考文档运行于真机进行使用
五、wx.login 适配
- 由于在小程序项目中是通过
wx.login进行登录，以及业务上是通过openid作为用户身份的唯一id，然而wx.login在 App 模式下不可用，但小程序的业务逻辑第一步就依赖于获取到用户身份后才能进行后续其他操作。因此，需对wx.login进行适配。 - 开发者可在多端模式下使用
wx.getMiniProgramCode代替wx.login，从而实现无需修改小程序后台代码逻辑的情况下即可实现wx.login的兼容，详情可查看快速接入小程序登录服务
六、更多接口和组件的兼容处理
- 除了
wx.login需要进行兼容处理之外，还有部分的接口和组件也在多端应用模式下不支持，开发者的小程序项目中如果也用到了对应的接口或者组件，则也应该需要进行处理 - 需适配的 API 汇总
- 需适配的组件汇总
- 如果小程序项目使用了云开发，则需要参考多端应用使用云开发指引进行处理
- 地图相关能力则参考位置服务使用指南
- 流量主广告的使用则参考腾讯优量汇广告使用指南
- 小程序订阅消息则使用 App 的消息推送代替，详情可查看消息推送使用指南
- 此外，iOS 的虚拟支付则使用wx.miniapp.IAP
- 以及，iOS 的苹果登录则使用wx.appleLogin
七、构建正式版安装包
- 为方便开发者快速体验使用将小程序构建为多端应用的效果，平台默认为开发者的应用配置测试版的 Package Name（Android 平台）以及测试版的 Bundle ID（iOS 平台）
- 构建开发版的 IPA 或 APK 只可用于测试体验，不可用于上架应用市场；如开发者需构建正式版安装包用于提交应用市场进行审核，需为该多端应用配置正式的 Package Name 和 Bundle ID，相关文档如下：
- iOS Bundle ID 和 Android 包名配置完成后，即可在开发者工具中重新构建 APK 和 IPA
八、上架应用市场前的 checklist
- 上架前需完成 App 的备案，Android 的备案需要填写 Android 签名与公钥，操作文档可查看生成 Android 签名与公钥
- 而关于 iOS 的 Bundle ID、平台公钥、签名 MD5 值等，可查看APP 备案所需的 APP 特征信息填写参考规范
- 备案完全后，上架 Android 应用市场还需要软著，开发者可自行寻找第三方服务商完成软著办理
- 其他更多的常见问题可查看上架应用市场常见问题