快应用的第一篇教程

快应用快速入门教程

这节课程的大纲如下：

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都要安装哦！平台预览版是模拟快应用的运行时环境的。）

在手机上安装并打开调试器，按钮功能如下：

截图如下：

cd到你新建的项目文件夹下，执行如下命令

npm install

查看项目代码结构如下：
简单介绍一下代码结构
1. src:项目源文件夹
2. src/mainfest.json:项目配置文件
3. node_modules:项目的依赖类库
4. package.json:npm的项目配置文件

在你的项目文件夹下，执行如下命令

npm run build

注意
大部分第一执行会遇到如下报错

Error: Cannot find module '/Users/***/***/node_modules/hap-tools/webpack.config.js'

解决以上的问题。执行一次 hap update --force即可解决，再执行npm run build 进行编译。

编译成功后，工程项目会多出两个文件夹：

在手机上安装的快应用调试器，安装前面编译出来的rpk文件。

方法一：本地安装预览
1. 将你的工程中/dist目录下编译产生的rpk文件通过USB数据线或其他方式，复制到手机文件系统中。
2. 打开手机上的“快应用调试器”点击“本地安装”选择手机文件系统前面复制进来的rpk文件，即可预览到你的快应用的界面。
方法二：扫码预览

在工程目录下执行如下命令启动本地服务（默认端口12306）

npm run server

注意
如果遇到端口冲突，可以执行npm run server --port 8080 自定义端口

服务启动后，会在终端显示本地服务地址和对应二维码

打开手机上的“快应用调试器”，点击“扫码安装”，扫这个二维码即可安装快应用进行预览。

安装后效果如下：