命令打包 uniapp
打包 Uniapp 项目的基本流程
开发环境配置
确保已安装最新版 HBuilderX(官方 IDE)或配置好 Node.js 环境(使用 CLI 方式)。需安装对应平台的开发工具,如微信开发者工具(小程序)、Android Studio(Android 原生包)、Xcode(iOS 原生包)。
选择打包平台
在 HBuilderX 顶部菜单栏选择「发行」,根据目标平台选择:
- 小程序:生成对应平台(微信/支付宝等)的代码包,自动打开开发者工具
- App:生成原生安装包(需配置证书和签名)
- Web:生成静态网站文件(dist 目录)
原生 App 打包详细步骤
Android 平台
配置 Android 打包证书(.keystore 文件),在 HBuilderX 中填写证书别名、密码等信息。选择「发行 → 原生 App-云打包」或「本地打包」,云打包直接生成 APK/AAB 文件,本地打包需手动处理原生工程。
iOS 平台
需 Apple 开发者账号,配置证书和描述文件。选择「发行 → 原生 App-云打包」,填写 Bundle ID 和证书信息。云打包生成 IPA 文件,需通过 TestFlight 或企业证书分发。
小程序打包注意事项
微信小程序示例
打包后会在 unpackage/dist/build/mp-weixin 生成代码,需用微信开发者工具导入项目。检查 manifest.json 中的小程序 AppID 配置,确保 pages.json 路由正确。
常见问题处理
- 资源路径错误:静态资源需放在
static目录,引用时使用绝对路径 - 白屏问题:检查路由是否配置或是否存在语法错误
- 体积过大:启用「运行时压缩代码」或分包加载
命令行打包方式(CLI)
全局安装 Vue CLI 和 @vue/cli-service:
npm install -g @vue/cli @vue/cli-service
进入项目目录执行打包命令:
# 打包H5
npm run build:h5
# 打包微信小程序
npm run build:mp-weixin
# 打包App(需安装uni-app原生插件)
npm run build:app-plus
自定义打包配置
修改 vue.config.js 文件可扩展 Webpack 配置:
module.exports = {
configureWebpack: {
plugins: [...]
},
chainWebpack(config) {
// 修改loader规则
}
}
通过 manifest.json 配置各平台特有参数,如小程序网络超时时间、App 启动图等。打包后建议进行真机测试,尤其注意权限请求和原生接口兼容性。







