一、环境搭建
安装NodeJS
需安装6.0以上版本的NodeJS,请从NodeJS官网下载
安装toolkit工具
通过npm仓库安装,在命令行中执行以下命令:
npm install -g hap-toolkit
检查是否安装成功
hap -V
二、创建项目
安装toolkit工具后,可通过全局hap命令创建一个项目模板,如下所示:
hap init MyProject
这个项目已经包含了项目配置与示例页面的初始代码,项目根目录主要结构如下:
├── sign rpk包签名模块
│ └── debug 调试环境
│ ├── certificate.pem 证书文件
│ └── private.pem 私钥文件
├── src 项目源文件夹
│ ├── Common 公用的资源和组件文件
│ │ └── logo.png 应用图标
│ ├── Demo 页面目录
│ | └── index.ux 页面文件,可自定义页面名称
│ ├── app.ux APP文件,可引入公共脚本,暴露公共数据和方法等
│ └── manifest.json 项目配置文件,配置应用图标、页面路由等
└── package.json 定义项目需要的各种模块及配置信息
安装依赖
在项目根目录下,运行如下命令安装模块到node_modules目录
npm install
编译项目
npm run build
自动编译项目
如果希望每次修改源代码文件后,都自动编译项目,请使用如下命令:
npm run watch
三、安装rpk包
需要同时安装两个快应用软件
1.快应用调试器
扫码安装
2.快应用预览版
扫码安装
3.启动HTTP服务器
在终端中新建一个窗口,进入项目的根目录运行如下命令,启动本地服务器(默认端口为12306)
npm run server
打开调试器 --> 点击"扫码安装",扫描终端窗口中的二维码即可完成配置(若扫描不成功,可在浏览器中打开页面:http://localhost:,扫描页面中的二维码)
编译时通过编译工具产出rpk文件,运行时通过调试器安装rpk文件;
官方文档:https://doc.quickapp.cn/
社区论坛:https://bbs.quickapp.cn/
Ps:在一些‘node’版本上面,运行完npm install
后再运行npm run build
时可能会报Cannot find module .../webpack.config.js
异常,这是由于高版本的npm
在npm install
时,会校验并删除了node_modules
下部分文件夹(包含hap-toolkit)导致报错。而hap update --force
会重新复制hap-toolkit
文件夹到node_modules
中,再次运行npm run build
就不会在报相同错误了
End