> 本文整理自平台文档 docs/wujies/5.x/frontends/app/mp.mdx,用于站点内容演示。
(https://console.wujies.cn/remote-apps/cms-assets/doc-4c86703620b4-cover.svg)
小程序和 H5、App 共用同一套 uni-app 页面。每个平台一个构建目标,产物导入对应开发者工具后上传。
支持平台
package.json 里已经预置了这些构建脚本:
| 平台 | 开发 | 构建 |
|---|---|---|
| 微信 | npm run dev:mp-weixin | npm run build:mp-weixin |
| 支付宝 | npm run dev:mp-alipay | npm run build:mp-alipay |
| 抖音 | npm run dev:mp-toutiao | npm run build:mp-toutiao |
| 百度 | npm run dev:mp-baidu | npm run build:mp-baidu |
| 快手 | npm run dev:mp-kuaishou | npm run build:mp-kuaishou |
npm run dev:mp-qq | npm run build:mp-qq | |
| 京东 | npm run dev:mp-jd | npm run build:mp-jd |
| 飞书 | npm run dev:mp-lark | npm run build:mp-lark |
> 小红书(mp-xhs)的依赖已装,但 package.json 还没预置脚本;需要时自行加 > "dev:mp-xhs": "uni -p mp-xhs" / "build:mp-xhs": "uni build -p mp-xhs",或直接用 uni -p mp-xhs。
微信小程序:从构建到上传
### 1. 构建
npm run build:mp-weixin
产物在 dist/build/mp-weixin/。
### 2. 导入开发者工具
微信开发者工具 → 导入项目 → 选择 dist/build/mp-weixin/。
### 3. 配置 AppID
src/manifest.json的mp-weixin.appid;- 或开发者工具里临时填写测试号。
### 4. 配置服务器域名
微信公众平台 → 开发管理 → 服务器域名:
request合法域名:你的 API 域名;uploadFile/downloadFile:上传下载域名;socket:WebSocket 域名(如果用了)。
必须是 HTTPS + 已备案域名,不能用 IP、不能带端口。
### 5. 上传与审核
开发者工具「上传」→ 微信公众平台提交审核 → 发布。
src="/images/docs/mp-home.png" caption="微信小程序首页(截图占位)" hint="建议 390 × 844,截小程序首页与 tabBar。" aspect="9 / 19.5" />
小程序与 H5 的差异
| 能力 | H5 | 小程序 |
|---|---|---|
| 登录 | 账号密码 / 邮箱验证码 / 手机验证码 | 同一套页面与 /auth/login,靠 grantType 区分 |
| 支付 | 后端下单接口给的支付方式列表 | 同左 |
| 分享 | 链接 | onShareAppMessage / 分享卡片 |
| 域名 | 无限制 | 必须配置合法域名 |
| 包体积 | 无硬限制 | 主包 2MB、总包 20MB(微信) |
> 微信小程序授权登录(uni.login 拿 code 换 token)与原生支付(uni.requestPayment)仓库里都还没接: > src/pages/login.vue 只有上面那三种方式,src/pages_mall/pages/order/pay.vue 也只是把 payType > 提交给后端,没有调起各端 SDK,也没有传 openid。要用微信登录 / 支付,需要前端补条件编译调用、 > 后端补对应的 grantType 与商户参数(sys_client 的 grantType 也要放开)。
常见问题
| 现象 | 原因 |
|---|---|
| 开发者工具能跑,真机不行 | 合法域名没配、证书不受信任 |
请求失败 url not in domain list | 服务器域名未配置或用了 IP |
| 登录失败 | src/config.js 的 clientID 与后端 sys_client 不匹配,或该客户端的 grantType 没放开你用的登录方式 |
| 包体积超限 | 主包放了太多页面,改分包 / 图片走 CDN |
| 支付调不起 | 当前仓库没接 uni.requestPayment;接入后再查 openid、商户号、回调地址、签名是否一致 |
本文导览
(https://console.wujies.cn/remote-apps/cms-assets/doc-4c86703620b4-guide.svg)


评论区需要浏览器启用 JavaScript 才能加载。