快應用 使用命令行

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

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

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

安裝環(huán)境

安裝 NodeJS

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

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

手機安裝調試器

調試器是一個 Android 應用程序，下載調試器 APK 詳見資源下載

在手機上安裝并打開調試器，按鈕功能如下：

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

注意：若打開調試器無法點擊按鈕，請升級手機系統(tǒng)到最新版本或安裝平臺預覽版

安裝成功后如下圖所示：

手機安裝平臺預覽版

較新的系統(tǒng)版本中內置平臺正式版，開發(fā)調試平臺新功能可使用平臺預覽版

平臺預覽版存在以下優(yōu)缺點：

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

平臺預覽版是一個 Android 應用程序，下載平臺預覽版 APK 詳見資源下載

下載安裝成功后，在手機調試器中點擊切換運行平臺至org.hapjs.mockup，即可在平臺預覽版上安裝運行 rpk 包

安裝 toolkit

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

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

npm install -g hap-toolkit

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

hap -v

項目開發(fā)

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

創(chuàng)建項目

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

hap init <ProjectName>

其中<ProjectName>為自定義的項目名稱，如hap init demo

關于生成項目模板具體介紹，詳情請見：項目結構講解

安裝依賴

在項目根目錄下，運行如下命令安裝模塊到node_modules目錄

npm install

編譯項目

手動編譯項目

在項目的根目錄下，運行如下命令進行編譯打包，生成 rpk 包

npm run build

編譯打包成功后，項目根目錄下會生成文件夾：build、dist

• build：臨時產出，包含編譯后的頁面 js，圖片等
• dist：最終產出，包含 rpk 文件。其實是將 build 目錄下的資源打包壓縮為一個文件，后綴名為rpk，這個rpk文件就是項目編譯后的最終產出

自動編譯項目

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

npm run watch

安裝 rpk 包

編譯項目產出了 rpk 包后，請打開手機調試器

若打開調試器無法點擊按鈕，請升級手機系統(tǒng)到最新版本或安裝平臺預覽版

調試器可使用后，就可以在調試器上安裝 rpk 包了

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

1 啟動 HTTP 服務器

在終端中新建一個窗口，進入項目的根目錄運行如下命令，啟動本地服務器（默認端口為 8000）

npm run server

自定義端口（如：8080）

npm run server -- --port 8080

2 在手機上掃碼安裝

步驟如下：

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

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

注意：

• 如果手機與 PC 不在同一局域網，可以使用 USB 在線更新和本地安裝預覽運行效果，詳見文檔調試

預覽效果

安裝成功后，效果如下：

總結

了解項目的目錄結構，編譯時通過編譯工具產出rpk文件，運行時通過調試器安裝rpk文件；打通整個流程后，開發(fā)者就可以邊開發(fā)邊預覽效果了

調試項目

至此，我們初步完成通過命令行工具進行快應用開發(fā)相關工作，項目調試工作，詳情請見：調試

發(fā)布前打包

在項目發(fā)布生產前，需進行發(fā)布前打包工作

編譯打包工程

在工程的根目錄下運行

npm run build

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

生成的應用路徑為/<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 拷貝進去

發(fā)布程序包

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

npm run release

生成的應用路徑為/<ProjectName>/dist/<ProjectPackage>.release.rpk