快應用入門
專案搭建
安裝Nodejs
- 需安裝6.0以上版本的nodejs,請從NodeJS官網下載,推薦v6.11.3 LTS
- 注意: 不要使用8.0.*版本.這個版本內部ZipStream實現與node-archive包不相容,會引起報錯,注意!!!不是8.0.*以上版本不行,例如我Nodejs版本為v8.2.1也是能正常開發,不要看到自己Node版本大於8.0以上就重灌
安裝hap-toolkit
通過npm倉庫安裝,在命令列中執行以下命令:
npm install -g hap-toolkit
複製程式碼
在命令列中執行hap -V會輸出版本資訊表示hap-toolkit安裝成功,如下命令所示:
hap -V
0.0.26
複製程式碼
建立第一個快應用專案
- 在你要建立專案的路徑輸入命令列 hap init ,點選兩次回車,當前路徑就建立了你專案的資料夾
hap init MyQuickApp //建立一個名為MyQuickApp的專案,這裡點選兩次回車
cd MyQuickApp //建立成功,進入專案根目錄
npm install //安裝依賴,當前操作要在專案根目錄執行
npm run build //編譯打包專案,專案根目錄下會生成資料夾:build、dist
複製程式碼
- build:臨時產出,包含編譯後的頁面js,圖片等
- dist:最終產出,包含rpk檔案。其實是將build目錄下的資源打包壓縮為一個檔案,字尾名為rpk,這個rpk檔案就是專案編譯後的最終產出
- 這個專案已經包含了專案配置與簡單頁面的初始程式碼,專案根目錄結構如下:
├── node_modules
├── sign rpk包簽名模組
│ └── debug 除錯環境
│ ├── certificate.pem 證書檔案
│ └── private.pem 私鑰檔案
├── src
│ ├── Common 公用的資原始檔和元件檔案
│ │ └── logo.png manifest.json中配置的icon
│ ├── Demo 頁面目錄
│ | └── index.ux 頁面檔案,檔名不必與父資料夾相同
│ ├── app.ux APP檔案(用於包括公用資源)
│ └── manifest.json 專案配置檔案(如:應用描述、介面申明、頁面路由等)
└── package.json 定義專案需要的各種模組及配置資訊,npm install根據這個配置檔案,自動下載所需的執行和開發環境
複製程式碼
- src:專案原始檔夾
- node_modules:專案的依賴類庫
- sign:簽名模組,當前僅有debug簽名,如果內測上線,請新增release資料夾,增加線上簽名;簽名生成方法請參考文件:編譯工具的openssl
- 手機安裝偵錯程式
偵錯程式APK是一個Android應用程式,請從站點地址下載
- 掃碼安裝:配置HTTP伺服器地址,下載rpk包,並喚起平臺執行rpk包
- 本地安裝:選擇手機檔案系統中的rpk包,並喚起平臺執行rpk包
- 線上更新:重新傳送HTTP請求,更新rpk包,並喚起平臺執行rpk包
- 開始除錯:喚起平臺執行rpk包,並啟動遠端除錯工具
注意:若無法正常使用偵錯程式,請升級手機系統到最新版本或安裝平臺預覽版
我華為榮耀更新最新版本也是不行,所以直接下載平臺流量版
手機安裝平臺預覽版
平臺預覽版APK是一個Android應用程式,請從站點地址下載
安裝完成後除錯應用就能使用了
- 在平臺上執行rpk包
- 編譯打包後會在dist資料夾生成rpk包
- 匯入到Android裝置
- 在快應用偵錯程式選擇本地安裝,選擇rpk包進行安裝即可,這樣就完成第一個快應用
5.遇到的問題,慢慢研究
- 快應用除錯不能直接使用
- 不能通過掃描安裝rpk包