快应用快速入门教程
这节课程的大纲如下：
- 环境搭建
- 创建项目
- 安装依赖
- 编译项目
- 安装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 自定义端口
服务启动后，会在终端显示本地服务地址和对应二维码
打开手机上的“快应用调试器”，点击“扫码安装”，扫这个二维码即可安装快应用进行预览。
预览效果
安装后效果如下：
