uniapp命令行编译
uniapp 命令行编译方法
uniapp 支持通过命令行工具进行项目编译,适用于自动化构建或集成到 CI/CD 流程中。以下是常用的命令行编译方式:
安装依赖
确保已安装 Node.js 和 HBuilderX 命令行工具(cli)。全局安装 @dcloudio/uni-cli:
npm install -g @dcloudio/uni-cli
编译到不同平台
-
H5 平台
npm run build:h5 # 或使用自定义配置 uni build --platform h5 -
微信小程序
npm run build:mp-weixin # 或 uni build --platform mp-weixin -
App 平台
npm run build:app-plus # 或 uni build --platform app-plus
自定义配置参数
通过 -- 传递额外参数:
uni build --platform h5 --mode production --dest ./output
--mode:指定环境(如 development/production)。--dest:自定义输出目录。
环境变量注入
在项目根目录创建 .env 文件,通过 --mode 指定环境:
# .env.production
VUE_APP_API_BASE=https://api.example.com
编译时注入变量:
uni build --platform h5 --mode production
自动化脚本示例
在 package.json 中添加脚本:
{
"scripts": {
"build:weapp": "uni build --platform mp-weixin --mode production",
"build:h5": "uni build --platform h5 --dest ./dist/h5"
}
}
运行脚本:
npm run build:weapp
注意事项
- 确保项目已安装必要依赖(如
@dcloudio/uni-ui)。 - App 平台编译需依赖 HBuilderX,需配置
cli路径。 - 小程序平台编译后需手动上传或通过 CI 工具处理。







