快应用的第一篇教程

快应用快速入门教程

这节课程的大纲如下：

• 环境搭建
• 创建项目
• 安装依赖
• 编译项目
• 安装rpk包
• 预览效果

环境搭建

• 1. NodeJS安装

mac首先安装NodeJS,并且版本是6.0以上的，可以从NodeJS官网下载，官网会根据你的电脑，自动跳转到mac版，windows版本，以及Linux版本，我的电脑是mac系统，显示页面如下：

我选择了推荐的版本，双击下载点击刚才下载好的dmg文件，安装成功后，在终端检测你安装好的node的版本。

node -v

安装好nodeJS,顺带安装好NodeJS包管理工具 npm,检测npm的版本。npm 是hap，编译打包比用到命令，所以一定确定安装好。

npm -v

• 2. 快应用安装环境

到此，接下来安装快应用的相应包hap-toolKit,通过npm仓库安装，在终端执行命令如下：

npm install -g hap-toolkit

安装成功后。用命令 hap -V(必须是大写)来检测安装是否成功。

hap  -V

安装成功提示如下：

• 3. 手机安装调试器

你的手机需要安装 快应用调试器 和 平台预览版 （下载后用ADB或者直接USB传输安装到手机。注意，两个apk都要安装哦！平台预览版是模拟快应用的运行时环境的。）

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

• 扫码安装：配置HTTP服务器地址，下载rpk包，并唤起平台运行rpk包
• 本地安装：选择手机文件系统中的rpk包，并唤起平台运行rpk包
• 在线更新：重新发送HTTP请求，更新rpk包，并唤起平台运行rpk包
• 开始调试：唤起平台运行rpk包，并启动远程调试

截图如下：

创建项目

• 在终端cd到你的项目存放目录

• 执行项目初始化命令（yourProjectName 要替换成你的项目名）

  hap init yourProjectName
  

安装依赖

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 进行编译。

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

• build: 存放编译n后的页面js文件和素材
• dist: 存放编译打出包的rpk压缩文件，这个rpk就是快应用的最终执行文件了，提交市场就可以用它了（提交市场要 release版本）

安装rpk包

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

• 方法一：本地安装预览

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

• 方法二：扫码预览

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

npm run server

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

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

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

预览效果

安装后效果如下：