快應用快速入門教程
這節課程的大綱如下：
- 環境搭建
- 創建項目
- 安裝依賴
- 編譯項目
- 安裝rpk包
- 預覽效果
環境搭建
- NodeJS安裝
mac首先安裝NodeJS,并且版本是6.0以上的，可以從NodeJS官網下載，官網會根據你的電腦，自動跳轉到mac版，windows版本，以及Linux版本，我的電腦是mac系統，顯示頁面如下：
我選擇了推薦的版本，雙擊下載點擊剛才下載好的dmg文件，安裝成功后，在終端檢測你安裝好的node的版本。
node -v
安裝好nodeJS,順帶安裝好NodeJS包管理工具 npm,檢測npm的版本。npm 是hap，編譯打包比用到命令，所以一定確定安裝好。
npm -v
- 快應用安裝環境
到此，接下來安裝快應用的相應包hap-toolKit,通過npm倉庫安裝，在終端執行命令如下：
npm install -g hap-toolkit
安裝成功后。用命令 hap -V(必須是大寫)來檢測安裝是否成功。
hap -V
安裝成功提示如下：
- 手機安裝調試器
你的手機需要安裝 快應用調試器 和 平臺預覽版 （下載后用ADB或者直接USB傳輸安裝到手機。注意，兩個apk都要安裝哦！平臺預覽版是模擬快應用的運行時環境的。）
在手機上安裝并打開調試器，按鈕功能如下：
- 掃碼安裝：配置HTTP服務器地址，下載rpk包，并喚起平臺運行rpk包
- 本地安裝：選擇手機文件系統中的rpk包，并喚起平臺運行rpk包
- 在線更新：重新發送HTTP請求，更新rpk包，并喚起平臺運行rpk包
- 開始調試：喚起平臺運行rpk包，并啟動遠程調試
截圖如下：
創建項目
在終端cd到你的項目存放目錄
-
執行項目初始化命令（yourProjectName 要替換成你的項目名）
hap init yourProjectName
安裝依賴
cd到你新建的項目文件夾下，執行如下命令
npm install
編譯項目
-
查看項目代碼結構如下：
-
簡單介紹一下代碼結構
- src:項目源文件夾
- src/mainfest.json:項目配置文件
- node_modules:項目的依賴類庫
- package.json:npm的項目配置文件
在你的項目文件夾下，執行如下命令
npm run build
注意
大部分第一執行會遇到如下報錯
Error: Cannot find module '/Users/***/***/node_modules/hap-tools/webpack.config.js'
解決以上的問題。執行一次 hap update --force即可解決，再執行npm run build 進行編譯。
編譯成功后，工程項目會多出兩個文件夾：
- build: 存放編譯n后的頁面js文件和素材
- dist: 存放編譯打出包的rpk壓縮文件，這個rpk就是快應用的最終執行文件了，提交市場就可以用它了（提交市場要 release版本）
安裝rpk包
在手機上安裝的快應用調試器，安裝前面編譯出來的rpk文件。
-
方法一：本地安裝預覽
- 將你的工程中/dist目錄下編譯產生的rpk文件通過USB數據線或其他方式，復制到手機文件系統中。
- 打開手機上的“快應用調試器”點擊“本地安裝”選擇手機文件系統前面復制進來的rpk文件，即可預覽到你的快應用的界面。
方法二：掃碼預覽
在工程目錄下執行如下命令啟動本地服務（默認端口12306）
npm run server
注意
如果遇到端口沖突，可以執行npm run server --port 8080 自定義端口
服務啟動后，會在終端顯示本地服務地址和對應二維碼
打開手機上的“快應用調試器”，點擊“掃碼安裝”，掃這個二維碼即可安裝快應用進行預覽。
預覽效果
安裝后效果如下：
