快應(yīng)用 使用命令行

了解命令行使用整體流程：環(huán)境安裝、運(yùn)行時(shí)預(yù)覽效果，掌握基本概念：項(xiàng)目產(chǎn)出rpk文件

通過本節(jié)，你將學(xué)會(huì):

• 安裝環(huán)境
• 安裝 toolkit
• 項(xiàng)目開發(fā)
• 調(diào)試項(xiàng)目
• 發(fā)布前打包

安裝環(huán)境

安裝 NodeJS

需安裝8.0以上版本的 NodeJS (建議使用 10.0+ 以上)，請從NodeJS 官網(wǎng)下載

請注意：hap-toolkit@0.3 及其以后的版本不再支持 NodeJS v8.0 以下的版本)

手機(jī)安裝調(diào)試器

調(diào)試器是一個(gè) Android 應(yīng)用程序，下載調(diào)試器 APK 詳見資源下載

在手機(jī)上安裝并打開調(diào)試器，按鈕功能如下：

• 掃碼安裝：配置 HTTP 服務(wù)器地址，下載 rpk 包，并喚起平臺(tái)運(yùn)行 rpk 包
• 本地安裝：選擇手機(jī)文件系統(tǒng)中的 rpk 包，并喚起平臺(tái)運(yùn)行 rpk 包
• 在線更新：重新發(fā)送 HTTP 請求，更新 rpk 包，并喚起平臺(tái)運(yùn)行 rpk 包
• 開始調(diào)試：喚起平臺(tái)運(yùn)行 rpk 包，并啟動(dòng)遠(yuǎn)程調(diào)試

注意：若打開調(diào)試器無法點(diǎn)擊按鈕，請升級(jí)手機(jī)系統(tǒng)到最新版本或安裝平臺(tái)預(yù)覽版

安裝成功后如下圖所示：

手機(jī)安裝平臺(tái)預(yù)覽版

較新的系統(tǒng)版本中內(nèi)置平臺(tái)正式版，開發(fā)調(diào)試平臺(tái)新功能可使用平臺(tái)預(yù)覽版

平臺(tái)預(yù)覽版存在以下優(yōu)缺點(diǎn)：

• 優(yōu)點(diǎn)：迭代速度快，可立即體驗(yàn)平臺(tái)新功能
• 缺點(diǎn)：實(shí)現(xiàn)與真實(shí)的運(yùn)行環(huán)境存在差異，對廠商服務(wù)和第三方服務(wù)的支持存在缺陷

平臺(tái)預(yù)覽版是一個(gè) Android 應(yīng)用程序，下載平臺(tái)預(yù)覽版 APK 詳見資源下載

下載安裝成功后，在手機(jī)調(diào)試器中點(diǎn)擊切換運(yùn)行平臺(tái)至org.hapjs.mockup，即可在平臺(tái)預(yù)覽版上安裝運(yùn)行 rpk 包

安裝 toolkit

hap-toolkit 為開發(fā)編譯工具

通過 npm 倉庫安裝，在命令行中執(zhí)行以下命令：

npm install -g hap-toolkit

在命令行中執(zhí)行 hap -v 會(huì)輸出版本信息表示 hap-toolkit 安裝成功，如下命令所示：

hap -v

項(xiàng)目開發(fā)

開發(fā)環(huán)境搭建完成，以及 hap-toolkit 工具完成，我們就可以進(jìn)行項(xiàng)目開發(fā)

創(chuàng)建項(xiàng)目

安裝 toolkit 工具后，可通過全局hap命令創(chuàng)建一個(gè)項(xiàng)目模板，如下所示:

hap init <ProjectName>

其中<ProjectName>為自定義的項(xiàng)目名稱，如hap init demo

關(guān)于生成項(xiàng)目模板具體介紹，詳情請見：項(xiàng)目結(jié)構(gòu)講解

安裝依賴

在項(xiàng)目根目錄下，運(yùn)行如下命令安裝模塊到node_modules目錄

npm install

編譯項(xiàng)目

手動(dòng)編譯項(xiàng)目

在項(xiàng)目的根目錄下，運(yùn)行如下命令進(jìn)行編譯打包，生成 rpk 包

npm run build

編譯打包成功后，項(xiàng)目根目錄下會(huì)生成文件夾：build、dist

• build：臨時(shí)產(chǎn)出，包含編譯后的頁面 js，圖片等
• dist：最終產(chǎn)出，包含 rpk 文件。其實(shí)是將 build 目錄下的資源打包壓縮為一個(gè)文件，后綴名為rpk，這個(gè)rpk文件就是項(xiàng)目編譯后的最終產(chǎn)出

自動(dòng)編譯項(xiàng)目

如果希望每次修改源代碼文件后，都自動(dòng)編譯項(xiàng)目，請使用如下命令：

npm run watch

安裝 rpk 包

編譯項(xiàng)目產(chǎn)出了 rpk 包后，請打開手機(jī)調(diào)試器

若打開調(diào)試器無法點(diǎn)擊按鈕，請升級(jí)手機(jī)系統(tǒng)到最新版本或安裝平臺(tái)預(yù)覽版

調(diào)試器可使用后，就可以在調(diào)試器上安裝 rpk 包了

可以通過 WIFI 在線更新方式安裝 rpk 包，此方式要確保手機(jī)與 PC 在同一局域網(wǎng)，步驟如下：

1 啟動(dòng) HTTP 服務(wù)器

在終端中新建一個(gè)窗口，進(jìn)入項(xiàng)目的根目錄運(yùn)行如下命令，啟動(dòng)本地服務(wù)器（默認(rèn)端口為 8000）

npm run server

自定義端口（如：8080）

npm run server -- --port 8080

2 在手機(jī)上掃碼安裝

步驟如下：

• 手機(jī)打開快應(yīng)用調(diào)試器 --> 關(guān)閉"開啟USB調(diào)試"
• 點(diǎn)擊"掃碼安裝"，掃描終端窗口中的二維碼即可完成配置（若掃描不成功，可在瀏覽器中打開頁面：http://localhost:<your port>，掃描頁面中的二維碼）
• 點(diǎn)擊在線更新喚起平臺(tái)運(yùn)行 rpk 包

若提示安裝失敗，請檢查執(zhí)行 npm run server 的終端窗口是否正常運(yùn)行，手機(jī)和 PC 是否可以通過 IP 相互訪問

注意：

• 如果手機(jī)與 PC 不在同一局域網(wǎng)，可以使用 USB 在線更新和本地安裝預(yù)覽運(yùn)行效果，詳見文檔調(diào)試

預(yù)覽效果

安裝成功后，效果如下：

總結(jié)

了解項(xiàng)目的目錄結(jié)構(gòu)，編譯時(shí)通過編譯工具產(chǎn)出rpk文件，運(yùn)行時(shí)通過調(diào)試器安裝rpk文件；打通整個(gè)流程后，開發(fā)者就可以邊開發(fā)邊預(yù)覽效果了

調(diào)試項(xiàng)目

至此，我們初步完成通過命令行工具進(jìn)行快應(yīng)用開發(fā)相關(guān)工作，項(xiàng)目調(diào)試工作，詳情請見：調(diào)試

發(fā)布前打包

在項(xiàng)目發(fā)布生產(chǎn)前，需進(jìn)行發(fā)布前打包工作

編譯打包工程

在工程的根目錄下運(yùn)行

npm run build

編譯后的工程目錄在/<ProjectName>/build

生成的應(yīng)用路徑為/<ProjectName>/dist/<ProjectPackage>.rpk

增加 release 簽名

通過 openssl 命令等工具生成簽名文件private.pem、certificate.pem，例如：

openssl req -newkey rsa:2048 -nodes -keyout private.pem -x509 -days 3650 -out certificate.pem

在工程的 sign 目錄下創(chuàng)建 release 目錄，將私鑰文件 private.pem 和證書文件 certificate.pem 拷貝進(jìn)去

發(fā)布程序包

發(fā)布程序包前需要增加release簽名，然后在工程的根目錄下運(yùn)行

npm run release

生成的應(yīng)用路徑為/<ProjectName>/dist/<ProjectPackage>.release.rpk