uniApp打包发版

最新推荐文章于 2025-10-13 09:39:13 发布

原创最新推荐文章于 2025-10-13 09:39:13 发布 · 2.2k 阅读

30 ·

CC 4.0 BY-SA版权

文章标签：

#uni-app

uniapp 专栏收录该内容

61 篇文章

订阅专栏

UniApp是一个基于Vue.js的跨平台开发框架，支持一次开发，多端发布（包括App、H5、微信小程序等）。我将按照平台分类，逐步说明打包和发布的完整流程。确保您已完成开发、测试和代码提交（如使用Git），并已安装必要工具（如Node.js、HBuilderX IDE）。所有步骤基于UniApp官方文档和最佳实践，保证真实可靠。

1. 准备工作

在打包前，需完成以下通用配置：

安装工具：
- 下载并安装HBuilderX（推荐IDE）。
- 确保Node.js已安装（版本≥12），运行node -v验证。
- 安装项目依赖：在项目根目录运行npm install。
配置manifest.json：
- 在HBuilderX中打开项目，编辑manifest.json文件。
- 设置应用名称、AppID、版本号、图标等基础信息。
- 配置各平台特有设置，如Android包名（如com.example.app）、iOS Bundle ID。
环境检查：
- 运行npm run dev:%PLATFORM%测试开发环境（例如npm run dev:h5用于H5）。
- 确保无编译错误。

2. 打包和发布到各平台的详细步骤

以下按平台分步说明。打包命令通常在HBuilderX的“发行”菜单执行，或通过命令行运行。

2.1 App平台（Android和iOS）

App发布需生成安装包（Android为apk/aab，iOS为ipa），并上传到应用商店。

打包步骤：

在HBuilderX中，选择菜单“发行” > “原生App-云打包”。
选择平台：
- Android：勾选“Android”，选择证书类型（测试用“公共测试证书”，正式发布需自签名证书）。
- iOS：勾选“iOS”，需Apple开发者账号和证书（配置指南）。
填写打包配置：
- 设置应用名称、版本号。
- 勾选“打包后自动保存到本地”。
点击“打包”按钮，等待云端编译完成（输出文件在项目unpackage/dist/build目录）。

发布步骤：

Android：
- 上传apk/aab文件到Google Play或其他商店。
- 需注册开发者账号（如Google Play Console）。
- 提交应用信息、截图，并审核通过。
iOS：
- 使用Xcode或Transporter上传ipa文件到App Store Connect。
- 需Apple开发者账号，配置证书和描述文件。
- 在App Store Connect提交应用，等待审核。

命令行替代（可选）：

# Android打包
npm run build:app-plus --platform android
# iOS打包
npm run build:app-plus --platform ios

2.2 H5平台（Web端）

打包成静态文件，部署到Web服务器。

打包步骤：

在HBuilderX中，选择菜单“发行” > “网站-H5手机版”。
配置输出路径（默认在项目unpackage/dist/build/h5）。
点击“发行”，生成静态文件（包括index.html、js、css等）。

发布步骤：

将整个h5目录上传到Web服务器（如Nginx、Apache）。
配置服务器路由，确保所有路径重定向到index.html（用于Vue路由）。
测试URL可访问性，例如部署到Netlify或自有域名。

命令行替代：

npm run build:h5

2.3 微信小程序

打包成小程序包，上传到微信公众平台。

打包步骤：

在HBuilderX中，选择菜单“发行” > “小程序-微信”。
输入微信小程序的AppID（需在微信公众平台申请）。
点击“发行”，生成小程序包（输出在unpackage/dist/build/mp-weixin）。

发布步骤：

打开微信开发者工具，导入项目目录（选择mp-weixin文件夹）。
在工具中点击“上传”按钮，填写版本号和备注。
登录微信公众平台，在“管理” > “版本管理”中提交审核。
审核通过后，点击“发布”上线。

命令行替代：

npm run build:mp-weixin

2.4 其他小程序平台（如支付宝、百度）

步骤类似微信小程序，但需对应平台配置。

打包步骤：

在HBuilderX中，选择“发行” > “小程序-支付宝”（或百度、字节跳动等）。
输入对应AppID（需在各自平台申请）。

发布步骤：

使用对应开发者工具（如支付宝开发者工具）导入包。
上传并提交审核到平台后台（如支付宝开放平台）。

命令行示例：

# 支付宝小程序
npm run build:mp-alipay
# 百度小程序
npm run build:mp-baidu

3. 注意事项

测试优先：每个平台打包后，务必在真机或模拟器测试功能。
证书安全：正式发布App时，勿使用公共测试证书，避免安全风险。
版本管理：每次发版递增版本号（在manifest.json设置）。
常见问题：
- 打包失败：检查控制台错误日志，常见于依赖缺失或配置错误。
- 多端适配：使用UniApp的条件编译处理平台差异，例如#ifdef H5。
资源参考：
- UniApp官方文档
- HBuilderX使用指南