如何搭建快应用项目

最近公司有一个快应用项目，随之学习了一下快应用

快应用是什么？

快应用是九大手机厂商（小米、华为、OPPO、vivo、魅族、金立、中兴、努比亚、联想、一加）基于硬件平台共同推出的新型应用生态，用户无需下载安装，即点即用，享受原生应用的性能体验。

快应用官网：https://www.quickapp.cn/

快应用文档教程：https://doc.quickapp.cn/

一、项目搭建

1、安装环境

安装 NodeJS

需安装8.0以上版本的 NodeJS (建议使用 10.0+ 以上)，请从NodeJS 官网下载

请注意：[email protected] 及其以后的版本不再支持 NodeJS v8.0 以下的版本)

手机安装调试器

调试器是一个 Android 应用程序，下载调试器 APK 详见资源下载

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

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

注意：若打开调试器无法点击按钮，请升级手机系统到最新版本或安装平台预览版

安装toolkit

hap-toolkit 为开发编译工具

npm install -g hap-toolkit

2、创建项目

hap init

3、安装依赖

npm install

4、编译项目

npm run build

5、自动编译项目

npm run watch

6、安装rpk包

编译项目产出了 rpk 包后，请打开手机调试器

若打开调试器无法点击按钮，请升级手机系统到最新版本或安装平台预览版

调试器可使用后，就可以在调试器上安装 rpk 包了

可以通过 WIFI 在线更新方式安装 rpk 包，此方式要确保手机与 PC 在同一局域网，步骤如下：

1 启动 HTTP 服务器

在终端中新建一个窗口，进入项目的根目录运行如下命令，启动本地服务器（默认端口为 8000）

npm run server

自定义端口（如：8080）

npm run server -- --port 8080

7、在手机上扫码安装

手机和PC 需要在同一局域网

出现的预览效果如下

以上完成整个项目的搭建，以下为上线前需做签名处理

8、增加release 签名

通过 openssl 命令等工具生成签名文件private.pem、certificate.pem，例如：

openssl req -newkey rsa:2048 -nodes -keyout private.pem -x509 -days 3650 -out certificate.pem

在工程的 sign 目录下创建 release 目录，将私钥文件 private.pem 和证书文件 certificate.pem 拷贝进去

9、发布程序包

发布程序包前需要增加release签名，然后在工程的根目录下运行

npm run release

生成的应用路径为/dist/.release.rpk

如果需要临时使用 debug 签名，可以使用

npm run release -- --debug

注意: debug 签名由于是公开的，安全性无法保证，一定不要使用 debug 签名签发正式上线的应用