uni-app
项目支持 uni cli
和 HBuilderX cli
两种脚手架工具:
uni cli
:面向非HBuilderX的用户(如习惯使用vscode/webstorm的开发者),提供创建项目、编译发行等能力;在App平台,仅支持生成离线打包的wgt资源包,不支持云端打包生成apk/ipa;若需云端打包,依然需要安装HBuilderX,使用HBuilderX cli
;HBuilderX cli
:面向HBuilderX用户的自动化工具,提供uni-app
项目的持续集成能力;支持通过HBuilderX cli
进行web打包、小程序打包、App云端打包、部署uniCloud等;但注意HBuilderX暂不支持linux平台。另外注意HBuilderX cli
不基于npm,它是HBuilderX安装目录下的cli.exe
。提供有完整的cli
脚手架,可以通过 vue-cli
创建、运行、发行 uni-app
项目。
若你使用vue2版本,需要使用 npm 或者 yarn 全局安装 @vue/cli
。
npm install -g @vue/cli
若使用vue3版本,则无需安装。
vue2/vue3创建工程的方式不同。
使用 vue2 创建工程
使用 正式版
(对应 HBuilderX 最新正式版)
vue create -p dcloudio/uni-preset-vue my-project
使用 alpha版
(对应 HBuilderX 最新 alpha 版)
vue create -p dcloudio/uni-preset-vue#alpha my-alpha-project
此时,会提示选择项目模板,初次体验建议选择 hello uni-app
项目模板,如下所示:
上图中,如果选择自定义模板,需要填写 uni-app 模板地址,这个地址其实就是托管在云端的仓库地址。以 GitHub 为例,地址格式为 userName/repositoryName
,如 dcloudio/uni-template-picture
就是下载图片模板。
更多支持的下载方式,请参考这个插件的说明:download-git-repo (opens new window)
使用 vue3 创建工程
npx degit dcloudio/uni-preset-vue#vite my-vue3-project
npx degit dcloudio/uni-preset-vue#vite-ts my-vue3-project
Vue3版本暂不支持选择模板,仅支持创建默认模板。
国内特殊情况
模板项目存放于 Github,由于国内网络环境问题,可能下载失败。针对此问题可以尝试如下措施:
修改依赖为指定版本@cliversion
可以使用 @dcloudio/uvm (opens new window) 管理编译器的版本:
最新正式版
npx @dcloudio/uvm
最新 alpha 版
npx @dcloudio/uvm alpha
正式版指定版本
npx @dcloudio/uvm 3.2.12.20211029
alpha 版指定版本
npx @dcloudio/uvm 3.2.14.20211112-alpha
# npm
npm run build:app-plus
npm run dev:app-plus
# vue3项目
npm run build:app
npm run dev:app
# yarn
yarn build:app-plus
yarn dev:app-plus
# vue3项目
yarn build:app
yarn dev:app
# 监听文件变化且启用压缩
yarn build:app-plus --watch
# vue3项目
yarn build:app -w
Tips:
app-plus
;vue3发布到App平台时,平台参数为app
;uni cli
在App平台,仅支持生成离线打包的wgt资源包,不支持云端打包生成apk/ipa;若需云端打包,依然需要安装HBuilderX,使用HBuilderX cli
。# npm
npm run build:h5
npm run dev:h5
# yarn
yarn build:h5
yarn dev:h5
# 监听文件变化且启用压缩
yarn build:h5 --watch
# vue3项目
yarn build:h5 -w
# npm
npm run build:mp-weixin
npm run dev:mp-weixin
# yarn
yarn build:mp-weixin
yarn dev:mp-weixin
# 监听文件变化且启用压缩
yarn build:mp-weixin -watch
# vue3项目
yarn build:mp-weixin -w
# npm
npm run build:mp-alipay
npm run dev:mp-alipay
# yarn
yarn build:mp-alipay
yarn dev:mp-alipay
# 监听文件变化且启用压缩
yarn build:mp-alipay -watch
# vue3项目
yarn build:mp-alipay -w
# npm
npm run build:mp-baidu
npm run dev:mp-baidu
# yarn
yarn build:mp-baidu
yarn dev:mp-baidu
# 监听文件变化且启用压缩
yarn build:mp-baidu -watch
# vue3项目
yarn build:mp-baidu -w
# npm
npm run build:mp-toutiao
npm run dev:mp-toutiao
# yarn
yarn build:mp-toutiao
yarn dev:mp-toutiao
# 监听文件变化且启用压缩
yarn build:mp-toutiao -watch
# vue3项目
yarn build:mp-toutiao -w
# npm
npm run build:mp-lark
npm run dev:mp-lark
# yarn
yarn build:mp-lark
yarn dev:mp-lark
# 监听文件变化且启用压缩
yarn build:mp-lark -watch
# vue3项目
yarn build:mp-lark -w
# npm
npm run build:mp-qq
npm run dev:mp-qq
# yarn
yarn build:mp-qq
yarn dev:mp-qq
# 监听文件变化且启用压缩
yarn build:mp-qq -watch
# vue3项目
yarn build:mp-qq -w
# npm
npm run build:mp-kuaishou
npm run dev:mp-kuaishou
# yarn
yarn build:mp-kuaishou
yarn dev:mp-kuaishou
# 监听文件变化且启用压缩
yarn build:mp-kuaishou -watch
# vue3项目
yarn build:mp-kuaishou -w
# npm
npm run build:quickapp-webview
npm run dev:quickapp-webview
# yarn
yarn build:quickapp-webview
yarn dev:quickapp-webview
# 监听文件变化且启用压缩
yarn build:quickapp-webview -watch
# vue3项目
yarn build:quickapp-webview -w
# npm
npm run build:quickapp-webview-union
npm run dev:quickapp-webview-union
# yarn
yarn build:quickapp-webview-union
yarn dev:quickapp-webview-union
# 监听文件变化且启用压缩
yarn build:quickapp-webview-union -watch
# vue3项目
yarn build:quickapp-webview-union -w
# npm
npm run build:quickapp-webview-huawei
npm run dev:quickapp-webview-huawei
# yarn
yarn build:quickapp-webview-huawei
yarn dev:quickapp-webview-huawei
# 监听文件变化且启用压缩
yarn build:quickapp-webview-huawei -watch
# vue3项目
yarn build:quickapp-webview-huawei -w
# npm
npm run build:mp-360
npm run dev:mp-360
# yarn
yarn build:mp-360
yarn dev:mp-360
# 监听文件变化且启用压缩
yarn build:mp-360 --watch
可以自定义更多条件编译平台,比如钉钉小程序,参考package.json 文档。
开发者可以通过 cli 命令行指示 HBuilderX 进行启动、打包、登录等操作,详情参考:https://hx.dcloud.net.cn/cli/README (opens new window)