近年來uni-app發展勢頭迅猛,只要會vue.js,就可以開發一套代碼,發佈移動應用到iOS、Android、Web(響應式)、以及各種小程式(微信/支付寶/百度/頭條/飛書/QQ/快手/釘釘/淘寶)、快應用等多個平臺。憑藉著此跨平臺的特性,吸引了大批公司和開發者的青睞,據官網顯示目前其有900萬 ...
近年來uni-app發展勢頭迅猛,只要會vue.js,就可以開發一套代碼,發佈移動應用到iOS、Android、Web(響應式)、以及各種小程式(微信/支付寶/百度/頭條/飛書/QQ/快手/釘釘/淘寶)、快應用等多個平臺。憑藉著此跨平臺的特性,吸引了大批公司和開發者的青睞,據官網顯示目前其有900萬開發者、數百萬應用、12億手機端月活用戶、數千款uni-app插件。
正如優秀的軟體設計一樣,uni-app把一些移動端常用的功能做成了獨立的服務或者插件,我們在使用的時候只需要選擇使用即可。但是在使用這些服務或者插件時一定要區分其提供的各種服務和插件的使用場景,例如其提供的【uni-starter快速開發項目模版】幾乎集成了移動端所需的所有基礎功能,使用非常方便,但是其許可協議只允許對接其uniCloud的JS開發服務端,不允許對接自己的php、java等其他後臺系統。
然而,我們的後臺是java,因此,只能自己做一個類似於【uni-starter快速開發項目模版】的快速開發項目模板。好在【uni-starter快速開發項目模板】也是將uni-app提供的一些插件組合在一起的,儘管不能直接使用uni-starter,但是我們可以使用相同的插件來實現對應的功能。參考日常移動端開發及uni-starter提供的功能,我們要實現的移動端快速開發項目模板應包含以下基本功能:
- 許可權認證,獲取token,token過期自動刷新
- 登錄註冊(用戶名密碼登錄、手機號驗證碼登錄、APP一鍵登錄、微信登錄、微信小程式登錄、微信公眾號內登錄)
- 退出登錄、賬號註銷
- 個人信息修改(修改密碼、忘記密碼、頭像更換、昵稱修改)
- App升級
- 消息推送開關(app)、清除緩存(app)
- 指紋解鎖(app)、人臉解鎖(app)
- 多語言切換
- 隱私許可權 授權彈框
- 許可權引導
一、新建uni-app項目
原則上你可以使用任何編寫vue的代碼編輯器來編寫uni-app項目代碼,但是為了使用uni-app官方提供的便捷性,這裡我們選擇使用官方開發工具HBuilderX來進行uni-app項目的開發。
1、下載HBuilderX並安裝
2、在HBuilderX中依次點擊:文件 -> 新建 -> 項目
在這裡,我們選擇Hello uni-app項目,其中有豐富的演示和介面模板,如果項目不需要可以進行刪除。填寫項目名稱,選擇Vue版本,自己根據項目情況選擇使用Vue2還是Vue3。因為我們不使用uniCloud,使用的是自己的Java後臺,所以這裡不需要啟用uniCloud。以上信息填完之後點擊創建項目,就可以在項目列表中看到我們剛剛新建的項目了。
3、配置uni-app基礎信息:雙擊manifest.json文件可以打開uniapp基礎信息配置界面,這裡不詳細描述,具體配置及說明請參考官方文檔
以上配置完成之後,基本可以在手機模擬器中查看uni-app的官方示例了。
二、安裝手機模擬器
在開發過程中,我們需要對界面進行調試預覽,這時候需要用到手機模擬器(當然也可以直接插上數據線運行到手機預覽),IOS和Android都有對應的手機模擬器,IOS手機模擬器目前只有官方版本,並且需要運行在MAC系統;Android有官方版手機模擬器也有非官方版,但是在之前使用過程中,官方版用著非常卡,需要調整優化很多參數,非常麻煩,反而非官方版,很多是針對手游做過優化的,使用很方便,這裡使用夜神模擬器為例,介紹HBuilder如何連接手機模擬器預覽調試。
1、下載安裝手機模擬器 (到官網下載,這裡不能直接放地址)
2、正常按照步驟安裝模擬器,安裝成功後,啟動並開啟“開發者選項”菜單,打開USB調試模式。
- 打開模擬器中的設置
- “開發者選項”菜單 預設不展示,需點擊最下麵的版本號5次,就會顯示“開發者選項”菜單
- 點擊“開發者選項”,開啟“USB調試”
3、配置HbuilderX連接手機模擬器
adb(Android Debug Bridge)是Android SDK中的工具,使用此工具,您可以直接操作和管理Android模擬器或真實的Android設備。要連接夜神模擬器,我們需要用到夜神模擬器安裝目錄下的nox_adb.exe文件。
- 在HbuilderX的菜單欄中依次點擊:運行 -> 運行到手機或模擬器 -> ADB路徑設置,將adb路徑修改為夜神模擬器安裝目錄下的路徑,我這裡是 D:/Program Files/Nox/bin/nox_adb.exe ,同時修改Android模擬器埠為62001。
- 配置好之後,連接到模擬器需要執行命令 ./nox_adb.exe connect 127.0.0.1:62001,我們可以在 ./nox_adb.exe文件所在的目錄建立一個.bat命令的快捷方式,放在桌面,每次使用的時候,雙機此.bat快捷方式即可。
nox_adb.bat內容:
.\nox_adb.exe connect 127.0.0.1:62001
- 運行了nox_adb.bat命令之後,就可以通過HbuilderX將我們前面新建的uni-app項目運行到手機模擬器中預覽了。依次點擊 運行 -> 運行到手機或模擬器 -> 運行到Android App基座。
- 此時彈出框會顯示我們已連接的模擬器,點擊運行,HBuilderX就可以自動打包app發佈到模擬器中運行,並可以在HBuilderX控制台查看運行日誌。
- 點擊運行之後,在夜神模擬器中就可以看到uni-app自動安裝並打開,我們就可以在裡面預覽調試我們的移動應用了。
此篇介紹了為何需要自己搭建uni-app快速開發框架、快速開發框架需要包含哪些基本功能、以及如何從零搭建uni-app的開發和測試環境。後續將根據需要的基本功能,介紹每個功能的詳細搭建過程和步驟。
源碼地址:
Gitee: https://gitee.com/wmz1930/GitEgg
GitHub: https://github.com/wmz1930/GitEgg