大粽子

Appearance

📱 微信小程序打包指南 ​

现在你已经完成了App的打包和上线。同时，利用UniApp的跨平台特性，你也可以快速将应用打包成微信小程序。

微信小程序无需下载安装，用户可以直接在微信中使用，这是拓展用户的好途径！

🎯 理解微信小程序 ​

小程序vs App的区别 ​

特性小程序App
获取方式微信扫码或搜索应用市场下载
安装方式无需安装需要下载安装
占用空间极小（通常<10MB）较大（几十MB）
加载速度快（秒开）一般
功能完整性基础功能完整功能
推送通知有限完整
离线使用不支持支持

选择建议：

  • 新用户获取 → 优先小程序
  • 核心服务 → 同时提供App和小程序
  • 用户粘性 → 重点打造App

🎯 第一步：准备微信小程序账号 ​

申请小程序账号 ​

  1. 进入微信公众平台
  2. 点"立即注册"
  3. 选择"小程序"

填写基本信息 ​

信息说明要求
账号类型选择企业或个人企业需营业执照
电子邮箱注册邮箱必须有效
密码账号密码强密码，妥善保管
手机号验证手机用于绑定和安全认证

完成认证 ​

企业认证（推荐）：

  1. 提交营业执照
  2. 法人身份验证
  3. 支付认证费用（通常300元）

⏳ 审核时间： 1-7 个工作日

个人认证：

  1. 提交身份证
  2. 进行人脸识别
  3. 无需费用

✅ 认证完成后 获得小程序ID和密钥

🎯 第二步：配置小程序基本信息 ​

设置小程序名称 ​

  1. 登录小程序管理后台
  2. 点"小程序"
  3. 设置 → 基本设置

填写关键信息 ​

字段说明示例
小程序名称用户看到的名字"我的商城"
小程序简介一句话描述"便捷购物，优质商品"
小程序类目应用分类电商/购物
运营主体企业或个人自动填充

获取小程序ID ​

在基本设置中找到：

信息说明用途
AppID小程序唯一标识HBuilderX中配置
AppSecret小程序密钥后端API调用

⚠️ 重要： 妥善保管AppID和AppSecret！

🎯 第三步：配置服务器信息 ​

设置请求域名 ​

小程序的所有网络请求都必须是HTTPS，且域名必须在这里列表中。

  1. 小程序管理后台 → 设置 → 开发设置
  2. 点"服务器域名"
  3. 添加域名

添加API域名 ​

点"修改"，添加你的后端API地址：

https://api.yoursite.com

要求：

  • ✅ 必须是HTTPS
  • ✅ 必须有有效SSL证书
  • ✅ 可以是根域名或子域名
  • ✅ 支持端口号

添加业务域名 ​

如果小程序中有网页链接，需要配置：

https://www.yoursite.com
https://h5.yoursite.com

上传SSL证书 ​

  1. 点"配置"
  2. 上传你的SSL证书
  3. 输入证书密钥

⏳ 配置生效时间： 15 分钟

🎯 第四步：在HBuilderX中打包小程序 ​

配置manifest.json ​

  1. 打开UniApp项目的 manifest.json
  2. 点"微信小程序"标签

填写小程序配置 ​

配置项说明来源
AppID微信小程序ID微信公众平台
AppSecret小程序密钥微信公众平台（可选）

⚠️ AppSecret在前端不需要填，只在后端使用

配置小程序权限 ​

  1. 点"权限配置"
  2. 选择需要的权限

常见权限：

权限说明需要
位置信息获取用户位置配送/周边
相机拍照上传用户头像
相册选择图片商品评论
通讯录读取联系人分享邀请
地理位置后台定位一般不需要

🎯 第五步：开发和调试小程序 ​

使用微信开发者工具 ​

微信小程序不能在普通浏览器中运行，需要用官方工具：

  1. 下载微信开发者工具
  2. 安装完成
  3. 打开HBuilderX编译的小程序文件

导入小程序项目 ​

  1. 用微信开发者工具打开 HBuilderX 生成的小程序项目

    • 路径通常在：unpackage/dist/dev/mp-weixin/

  2. 输入AppID

    • 微信公众平台的小程序ID

  3. 工具会自动编译预览

调试小程序 ​

开发者工具的功能：

功能说明快捷键
编译重新编译代码Ctrl+B
预览在模拟器中预览Ctrl+P
远程调试在真机上调试扫码
Console查看日志F12
Network查看网络请求F12

在真机上测试 ​

  1. 点"预览"按钮
  2. 用微信扫码
  3. 在手机上打开小程序
  4. 测试各项功能

✅ 测试清单：

  • [ ] 首页正常加载
  • [ ] 列表显示正确
  • [ ] API请求成功
  • [ ] 登录功能正常
  • [ ] 支付流程完整
  • [ ] 网络请求正常
  • [ ] 性能满足要求

🎯 第六步：体验版本测试 ​

创建体验版本 ​

  1. 小程序管理后台 → 版本管理
  2. 点"提交审核"前，先提交"体验版本"

设置测试用户 ​

  1. 点"体验版本"
  2. 点"配置"
  3. 添加体验者

添加方式：

  • 输入微信账号
  • 用二维码邀请

让测试用户体验 ​

  1. 体验者用微信扫码或搜索
  2. 在微信中打开小程序
  3. 测试所有功能

⏳ 体验版本有效期： 180 天

收集反馈：

  • 功能是否正常
  • 界面是否友好
  • 性能是否满足
  • 是否有Bug

🎯 第七步：版本发布 ​

修复Bug，优化功能 ​

根据体验版本的反馈：

  1. 修改代码
  2. 本地测试
  3. 确认无问题

重新编译打包 ​

在HBuilderX中：

  1. 修改代码后保存
  2. 点"发行" → "小程序"
  3. 选择"微信小程序"
  4. 编译完成

提交审核 ​

  1. 小程序管理后台 → 版本管理
  2. 点"提交审核"
  3. 填写版本信息

需要填写的信息：

字段说明示例
版本号版本标记"1.0.0"
更新说明这个版本的更新内容"修复订单页面显示问题，优化搜索性能"
附件功能演示视频或截图(可选)

审核等待 ​

⏳ 审核周期： 通常 1-3 个工作日

可能的审核结果：

✅ 审核通过 - 立即发布上线

❌ 审核拒绝 - 根据反馈修改后重新提交

🎯 第八步：发布上线 ​

发布版本 ​

审核通过后：

  1. 小程序管理后台 → 版本管理
  2. 找到审核通过的版本
  3. 点"发布"

✅ 发布成功后：

  • 用户可以在微信中搜索到你的小程序
  • 用户可以添加到微信首页
  • 用户可以分享给朋友

验证上线 ​

  1. 打开微信
  2. 搜索你的小程序名称
  3. 应该能找到你的小程序
  4. 点击打开，测试功能

🎯 小程序的推广和运营 ​

获取更多用户 ​

方式1️⃣：微信菜单

在你的公众号中添加菜单链接到小程序：

json
{
  "type": "miniprogram",
  "name": "打开小程序",
  "url": "weixin://bizmall/malldetail?id=xxxxx"
}

方式2️⃣：分享和邀请

在小程序中鼓励用户分享：

vue
<button open-type="share">分享给好友</button>

方式3️⃣：二维码

  1. 小程序管理后台 → 分析
  2. 下载小程序二维码
  3. 在线下传播

方式4️⃣：附近的小程序

  1. 小程序管理后台 → 设置
  2. 配置门店位置
  3. 用户可以在"发现" → "小程序"中找到

监控运营数据 ​

小程序管理后台提供详细的数据分析：

数据说明用途
访问量用户打开次数了解受欢迎度
新增用户新用户数量评估推广效果
活跃用户月活跃用户数衡量用户粘性
跳出率用户离开的比例优化用户体验
访问时长用户平均停留时间衡量粘性

⚠️ 常见问题 ​

Q: 小程序和App我应该都做吗？ ​

A: 建议都做，原因：

  • 小程序：快速获取用户，无下载压力
  • App：留住用户，提供完整体验
  • 两者互补，提升用户覆盖面

Q: 小程序的页面显示不对怎么办？ ​

A: 常见原因和解决：

  1. 样式不兼容

    • 检查CSS是否支持小程序
    • 用HBuilderX的预处理

  2. 组件不支持

    • 小程序不支持某些H5组件
    • 用小程序官方组件替代

  3. 网络请求失败

    • 检查域名是否在服务器域名中
    • 确保HTTPS和证书有效

Q: 小程序可以收取费用吗？ ​

A: 可以，但有限制：

  • ✅ 支持微信支付
  • ✅ 可以销售虚拟商品
  • ✅ 可以定价
  • ❌ 不能游戏充值
  • ❌ 不能直播打赏（不同类目规则不同）

Q: 小程序如何接收用户消息？ ​

A: 小程序有以下消息方式：

  1. 模板消息

    • 用于订单、物流等通知
    • 用户需要主动订阅

  2. 服务通知

    • 在小程序内发送
    • 实时、可交互

  3. 微信公众号消息

    • 关联公众号后发送
    • 覆盖范围更广

Q: 小程序多久要更新一次？ ​

A: 建议：

  • 有Bug时 - 立即修复并发布
  • 有新功能时 - 定期（2-4周）更新
  • 性能优化时 - 及时发布
  • 系统更新时 - 跟随微信小程序最新特性

最少每月更新一次，保持活跃度。

📋 小程序打包发布检查清单 ​

发布前检查：

  • [ ] 小程序账号已认证
  • [ ] AppID和AppSecret已获取
  • [ ] 服务器域名已配置
  • [ ] manifest.json已配置AppID
  • [ ] 代码在微信开发者工具中运行正常
  • [ ] 所有页面显示正确
  • [ ] API请求正常
  • [ ] 支付功能测试通过
  • [ ] 没有错误日志
  • [ ] 体验版本已测试（至少2周）
  • [ ] 版本号和更新说明已填写
  • [ ] 隐私政策已配置

🎉 小程序已经发布了！ ​

现在你已经：

  1. ✅ 拥有了官方小程序
  2. ✅ 可以在微信中被用户发现
  3. ✅ 可以通过小程序获取用户

后续工作：

  1. 监控数据，不断优化
  2. 根据用户反馈改进功能
  3. 定期更新新功能和Bug修复
  4. 通过公众号、菜单推广小程序
  5. 收集用户反馈，改善体验

相关指南：

  1. App打包上线 - App发布流程
  2. PC商城部署 - PC店铺部署

祝你的小程序用户数爆增！🎉

大粽子