如何生成APP及各平台小程序？

如果需要生成 APP 及小程序，需要开通高级版套餐（开通高级版），免费版及标准版不支持生成

APP 及小程序基于 Dcloud 提供的 uni-app 框架开发，可发布到 iOS、Android、H5，以及微信、支付宝、百度、字节跳动、QQ 等多个小程序平台。

1、生成代码包

进入后台 → 系统设置 → 基本设置 → 生成APP及小程序，先选择要使用的模板，再点击「生成代码包」，系统会自动生成并下载代码包（zip 压缩包）。

2、安装开发工具

（1）前往 https://www.dcloud.io/hbuilderx.html 下载 HBuilderX 开发工具并完成安装。

（2）运行 HBuilderX，依次点击「新建 → 项目 → uni-app → 项目名称 → Vue2」，创建项目。

（3）把第一步下载的代码包解压，将解压后的全部文件移至项目文件夹中，覆盖同名文件。

3、进行基本配置

（1）在 HBuilderX 左侧找到自己的项目，点击 manifest.json，填写基础信息：

（2）HBuilderX-manifest.json-安卓/iOS模块配置，常规选择：

配置项	说明
应用名称	显示在手机桌面上的名字，建议 4～6 个字
应用描述	如需发布到应用市场才需填写，一句话说明用途即可
版本名称、版本号	版本名称给人看（如 1.0.0），版本号给系统看（数字，如 100）。更新 App 时必须把版本号改大，否则无法覆盖安装，应用市场也不给提交
App 图标	准备一张1024×1024的png，点「App图标配置」选图，会自动生成手机需要的各种尺寸
启动页图片	点「启动界面配置」，选「自定义启动图」上传；不设置就用默认启动图
App 功能模块	默认已启用常用模块，不用手动勾。你的商品、文章、课程里都有视频，依赖默认的视频、音频模块，别去取消勾选
各平台小程序 appid	生成哪个平台的小程序，就填哪个平台的 appid（微信、支付宝、百度、字节跳动、QQ），不填无法生成对应小程序
Android/iOS权限	保持默认即可，网络等必需权限已经包含在内

提示：APP 端购买时会打开内嵌网页完成，不需要在 App 里单独配置支付；微信小程序的 JSAPI 支付需先在商户平台关联小程序 AppID；虚拟支付还需配置消息推送等，具体看「微信小程序配置教程」。

4、生成 APP

（1）点击顶部「发行」→「原生App-云打包」。云打包就是让 DCloud 的服务器帮你打包，不用自己装环境。

（2）勾选要打包的平台，可以只勾选 Android 或 iOS，也可以两个一起勾选打包。

（3）点「打包」，等云端打包完成（免费用户需要排队，高峰期会慢一些），完成后会给出安装包下载地址：Android 是 .apk，iOS 是 .ipa。

注意：iOS 包需要自己提供苹果开发者证书（申请教程），没有证书只能生成越狱包，即只能在越狱手机上装，无法上架 App Store。

5、生成小程序

（1）后台 → 系统设置 → APP/小程序，填写「微信小程序-AppID / AppSecret」

（2）在 HBuilderX开发工具 的 manifest.json 里填写对应平台小程序的 appid。

（3）点击顶部「发行」→「小程序-微信」，HBuilderX 会自动编译，并打开微信开发者工具。

（4）在微信开发者工具里点击右上角的「上传」，填好版本号和备注，代码就上传到微信公众平台了。

（5）上传后，到微信公众平台「版本管理」里提交审核，审核通过后点「发布」，小程序就正式上线了。

（6）支付宝、百度、字节跳动、QQ 小程序的操作一样，在「发行」时选对应平台，再用各自平台的开发者工具上传即可。

微信开发者工具下载地址：https://developers.weixin.qq.com/miniprogram/dev/devtools/download.html，根据系统选择 Windows / macOS 版本下载安装。

安装完成后，用微信扫码登录一次，确保工具能正常打开项目。之后在 HBuilderX 点击「发行 → 小程序-微信」，HBuilderX 会自动编译并把项目推送到微信开发者工具中，无需手动导入。

如果点击发行后没有自动打开开发者工具，可在微信开发者工具里进入「设置 → 安全设置」，开启「服务端口」，再回到 HBuilderX 重新发行即可。

6、提交审核

各平台的小程序/APP 都要审核上架后，别人才可以访问。所以要先到各大平台注册账号，把生成的代码上传，审核通过后就能正式上线。

各大平台注册地址如下：

平台	地址
微信小程序	https://mp.weixin.qq.com/
支付宝小程序	https://open.alipay.com/
百度小程序	https://smartprogram.baidu.com/developer/index.html
QQ小程序	https://q.qq.com/
字节跳动小程序	https://developer.open-douyin.com/
苹果 App Store	https://appstoreconnect.apple.com/
华为应用市场	https://developer.huawei.com/consumer/cn/appgallery
小米应用商店	https://dev.mi.com/
OPPO 开放平台	https://open.oppomobile.com/
vivo 开发者平台	https://developer.vivo.com/
腾讯应用宝	https://open.qq.com/

其他各大安卓应用市场，可自行搜索。

说明：安卓的 APK 安装包或 iOS 安装包可以不经应用市场，自己提供下载地址给用户下载安装。

7、APP 常见问题排查

（1）云打包失败或一直排队：云打包是在线打包，免费用户要排队，高峰期慢；失败时看控制台报错，常见是 manifest 信息没填、图标格式不对、功能模块冲突，改完重新打包即可。

（2）安装包装不上或覆盖安装失败：一般是签名不一致，覆盖安装必须用同一份证书，正式发布请固定用自己的证书。

（3）APP 打开白屏：检查生成代码包时的域名是否正确、网站能否访问、https 证书是否过期。

（4）应用名称/图标/启动图不生效：这些都在 manifest.json 里配置，改完必须重新打包。

（5）iOS 打包报证书错误：iOS 正式打包需要苹果开发者账号（年费 99 美元）、苹果证书和描述文件；真机测试还要把设备加到描述文件里。

（6）如何更新已上架的 APP：把 manifest.json 的版本号改高，重新打包后上传应用市场审核；安卓自发的安装包直接替换下载地址即可。

（7）APP 支付：APP 端购买会打开内嵌网页完成，调不起支付时，检查网站后台「收款设置」参数。

8、小程序常见问题排查

（1）request 合法域名怎么填：统一填 https://ssl.vfaka.com，保存后平台要几分钟才生效。

（2）小程序白屏：检查合法域名有没有配置并保存、代码包写入的域名对不对、服务器和 https 是否正常；开发者工具「调试器-网络」可以看到具体是哪个请求失败。

（3）上传提示代码包超过 2M：删掉没用的图片、静态资源，或者用分包。

（4）登录失败：检查 manifest.json 里的 appid 和微信后台是否一致、网站后台有没有填该小程序的 AppID 和 AppSecret、测试人员有没有加入「成员管理」。

（5）支付失败：微信支付（JSAPI）检查网站后台「收款设置」参数；虚拟支付则要先配置消息推送，并在「内容管理-小程序道具管理」把商品同步到微信线上道具。

（6）审核被驳回：小程序里卖虚拟商品（会员、课程、卡密等）必须走微信虚拟支付，继续用微信支付（JSAPI）会被驳回。

（7）体验版调试：在微信公众平台「成员管理」添加体验成员，上传代码后设为体验版，扫码即可测试。

（8）更多小程序配置详情可查阅下一篇：小程序平台如何配置。