Uniapp多端打包与上架全流程指南（H5/小程序/App）

Uniapp作为跨平台开发框架，支持将项目打包为H5网站、微信小程序及原生App（iOS/Android）。本文详细梳理三大平台的打包流程与上架要点，帮助开发者高效完成多端部署。

H5平台打包上线

配置manifest.json

• 打开项目根目录下的 manifest.json，切换至**“H5配置”**选项卡
• 运行基础路径：根目录填 /，子目录填 /m/
• 路由模式：可选 history（需后端支持）或默认 hash 模式
• 其他配置：网站标题、favicon图标等

执行打包命令

• HBuilderX操作：点击顶部菜单栏**“发行” → “网站-H5手机版”**，填写域名后点击“发行”
• 命令行操作：

npm run build:h5 -- --dest h5-dist

部署到服务器

• 将生成的 unpackage/dist/build/h5（HBuilderX）或 h5-dist（CLI）文件夹上传至Web服务器（如Nginx、Apache）
• 确保服务器配置正确，通过域名访问应用

微信小程序打包上线

配置manifest.json

• 打开 manifest.json，切换至**“微信小程序配置”**选项卡
• 填写AppID：从微信公众平台获取
• 配置权限：地理位置、用户信息等

运行到微信开发者工具

• HBuilderX操作：点击**“运行” → “运行到小程序模拟器” → “微信开发者工具”**
• 首次运行：在微信开发者工具中指定代码目录（ unpackage/dist/dev/mp-weixin），并开启“服务端口”

上传代码并提交审核

• HBuilderX操作：点击**“发行” → “小程序-微信”**，生成生产环境代码
• 微信开发者工具操作：点击右上角**“上传”**，填写版本号和备注
• 微信公众平台操作：登录后进入**“管理” → “版本管理”**，提交审核并发布

App（iOS/Android）打包上线

准备工作

• DCloud开发者账号：完成实名认证
• Android证书：
  • 使用 keytool 生成 .keystore 文件，或在HBuilderX中一键生成
  • 妥善保管证书和密码（更新应用时需使用同一证书）
• iOS证书：
  • 需付费Apple Developer Program账号（$99/年）
  • 登录Apple Developer网站，创建 App ID、 Distribution Certificate（.p12文件）和 Provisioning Profile（.mobileprovision文件）

配置manifest.json

• 打开 manifest.json，切换至**“App基础配置”**选项卡
• 填写应用标识：从DCloud云端获取AppID
• 填写版本信息：版本号（VersionName）和版本码（VersionCode，更新时需递增）
• 配置图标和模块：上传所有尺寸图标，勾选所需原生模块（如地图、支付）

云打包

• HBuilderX操作：点击**“发行” → “原生App-云打包”**
  • Android打包：选择自有证书，上传 .keystore 文件，选择CPU类型（如 armeabi-v7a、 arm64-v8a）
  • iOS打包：选择正式版，上传 .p12 和 .mobileprovision 文件，输入证书密码

应用商店上架

• Android上架：
  • 注册主流应用商店（如华为、小米、OPPO）开发者账号
  • 登录开发者后台，创建应用并填写信息（名称、简介、截图、隐私政策）
  • 上传 .apk 文件，提交审核
• iOS上架：
  • 使用 Transporter 或 Xcode 工具登录App Store Connect
  • 创建App并填写元数据（名称、描述、截图、关键词）
  • 上传 .ipa 文件，选择构建版本，填写审核信息后提交
  • 审核通过后选择手动或自动发布

关键注意事项

1. 权限处理：在原生App的配置文件中声明权限（Android的 AndroidManifest.xml，iOS的 Info.plist）
2. 版本兼容：确保Uniapp SDK与原生系统版本兼容（如Android最低支持API 21，iOS最低支持10.0）
3. 性能优化：混合开发时减少JS与原生通信频率，WebView开启硬件加速
4. 调试工具：使用HBuilderX的“真机运行”查看日志，结合原生工具（Android Studio的Logcat、Xcode的Console）调试