uni-app
是一個使用 Vue.js 開發跨平台應用的前端框架,開發者編寫一套代碼,可編譯到iOS、Android、H5、小程序等多個平台。

一套代碼,運行多個平台
uni-app
實現了一套代碼,同時運行到多個平台;如下圖所示,一套代碼,同時運行到iOS模擬器、Android模擬器、H5、微信開發者工具、支付寶小程序Studio、百度開發者工具、字節跳動開發者工具(底部7個終端選項卡代表7個終端模擬器):
運行效果圖如下:
開始之前,開發者需先下載安裝如下工具:
- HBuilderX:官方IDE下載地址
HBuilderX是通用的前端開發工具,但為uni-app
做了特別強化。
下載App開發版,可開箱即用;如下載標准版,在運行或發行uni-app
時,會提示安裝uni-app
插件,插件下載完成后方可使用。
如使用cli
方式創建項目,可直接下載標准版,因為uni-app編譯插件被安裝到項目下了。
通過vue-cli命令行
除了可視化界面,也可以使用 cli
腳手架,可以通過 vue-cli
創建 uni-app
項目。
注意:vue-cli 版本必須是3.x
注意:cli
版本更新快於HBuilderX正式版。HBuilderX正式版所包含的uni-app編譯器一般是在cli
版發布一段時間並穩定后才會更新到HBuilderX正式版。cli
版適合喜歡鼓搗的嘗鮮者,其好處是可以及時獲取新功能,壞處是穩定性不如HBuilderX正式版,但因為開源,所以也歡迎開發者一起完善。
環境安裝
全局安裝vue-cli
npm install -g @vue/cli
創建uni-app
vue create -p dcloudio/uni-preset-vue my-project
此時,會提示選擇項目模板,初次體驗建議選擇 hello uni-app
項目模板,如下所示:

自定義模板
選擇自定義模板時,需要填寫 uni-app 模板地址,這個地址其實就是托管在雲端的倉庫地址。以 GitHub 為例,地址格式為 userName/repositoryName
,如 dcloudio/uni-template-picture
就是下載圖片模板。
更多支持的下載方式,請參考這個插件的說明:download-git-repo
運行並發布uni-app
npm run dev:%PLATFORM%
npm run build:%PLATFORM%
%PLATFORM%
可取值如下:
值 | 平台 |
---|---|
h5 | H5 |
mp-alipay | 支付寶小程序 |
mp-baidu | 百度小程序 |
mp-weixin | 微信小程序 |
mp-toutiao | 頭條小程序 |