【官方IDE】快应用开发工具使用说明文档

管理员

快应用开发工具使用说明文档

---

0. 描述

如果是新建快应用项目，请看1； 如果是开发已有的快应用工程，请看 2 和 3

---

1. 快速入门

1.1 新建快应用工程

i 按钮栏的 + 号(也可以【文件】→【创建快应用工程】菜单打开 创建快应用工程页面；或者通过快捷键打开显示所有命令窗口（mac：fn+F1，Windows：ctrl+shift+p)，然后输入 "hap: Set up a new hap project"，并执行该命令）， 然后会如图1.1所示

图1.1

ii 然后按页面提示操作，选择路径，指定工程存放的目录。输入项目名称和rpk包名，rpk包名格式如："org.xxx.demo / com.xxx.demo"。

iii 选择创建工程的类型，目前版本只支持创建快应用工程。

iv 点击完成，IDE会自动打开新创建的工程。

1.2 快速调试

i 准备一台手机，并打开快应用工程

ii 将手机用USB连接上电脑，并确保手机已经再开发者模式里面打开了MTP文件传输和USB调试。手机连接请参考第5点 手机USB DEBUG。

iii 按下F5( mac下需要同时按下fn键，如果有设置的话) (或者按按钮面板上的三角按钮，如图1.2.1所示，或者在调试面板安绿色的小三角)

图1.2.1

iv 如果手机没有安装快应用环境，会自动帮手机安装上相应的环境。请在手机操作，允许安装。安装完成后，需要给快应用引擎授权，如图1.2.2 所示。授权完成后，在IDE上点击继续调试，如图1.2.3

图1.2.2

图1.2.3

v 然后IDE会自动运行相关命令(npm run watch 和 npm run server)，并打开chrome浏览器的调试页面，如图1.2.4所示。 如果对页面有修改，只需要保存您的文件即可， 调试器会自动帮你刷新页面。如果调试过程中遇到问题，请参考开发者工具常见问题。

图1.2.4

vi 使用 lightening debug 并不会每次都执行npm install 以加速调试， 如果想保证每次调试之前都安装依赖，可以在调试面板选择 quick debug，然后按F5进行调试， 如图1.2.5所示

图1.2.5

vii 如果不想进行调试，只想运行看看效果, 请选择Run Application , 然后按下F5进行调试。如图1.2.6所示

图1.2.6

---

2. 用开发者工具调试现有的快应用工程

i 使用打开功能打开工程的文件夹, 如图2.1.1所示

图2.1.1

ii 如果之前没有用IDE进行过开发和调试， 需要把IDE的环境配置到工程目录里头。请在快应用面板上点击更新工程按钮, 如图 2.1.2所示

图2.1.2

---

3. 如果手机之前安装了快应用环境, 需要先升级调试器和快应用引擎

i 打开快应用面板，点击安装快应用apk，强制升级，如图3.1.1所示

图3.1.1

ii 然后打开快应用工程，按F5调试即可。流程跟快速开发里面的调试流程一样

---

4. 发布快应用

4.1 生成证书

发布快应用之前, 需要生成证书。 请点击快应用面板的生成证书, 然后按提示输入所需信息。如图4.1.1所示

图4.1.1

4.2 生成发布用RPK

点击发布rpk包按钮，生成成功的话会弹出对应的文件夹。如图4.2.1所示

图4.2.1

---

5 手机开启USB DEBUG

i 开启手机MTP传输，类似下图 5.1.1

图5.1.1

ii开启手机MTP传输，可能需要用户授权，点击允许授权按钮即可。

iii 在开发者面板里面开启开发者选项，类似下图 5.1.2

图5.1.2

iv 开发者面板里头开启USB调试，类似下图 5.1.3

图5.1.3

---

6.相关下载

https://www.quickapp.cn/docCenter/post/97

---

李光春

期待已久！

orion-c

前排占个座，

临风听暮蝉

都用跨平台框架了，打包个Ｌｉｎｕｘ版不难吧

citsos

太好啦~~~终于有了

QiCode

使用oppo手机测试，界面全空白···

QiCode

运行在手机端只代开了“快应用调试器”，并没有打开对应的快应用，以下是log

1. 打开调试中...
3. > Quick-ArtSignPro@1.0.0 server /Users/Abelhu/Desktop/Android/Quick-ArtSignPro
4. > hap server
7. [INFO] ### App Server ### 完成创建adb调试器。您可以通过usb线连入手机调试
9. [INFO] ### App Server ### 服务器地址: http://localhost:12306, http://192.168.1.115:12306
11. [INFO] ### App Server ### 请确保手机与App Server处于相同网段
14. 生成HTTP服务器的二维码: http://192.168.1.115:12306
16. 打开调试页面: http://192.168.1.115:12306
17. ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
18. █ ▄▄▄▄▄ ██▄▄ ▀▄██▄█ ▄▄▄▄▄ █
19. █ █ █ █▀▄ █▀ ▀ █ █ █ █
20. █ █▄▄▄█ █▄▀ █▄█▄█▀█ █▄▄▄█ █
21. █▄▄▄▄▄▄▄█▄▀▄█ █ █▄█▄▄▄▄▄▄▄█
22. █ ▀▀█ ▄ █▄ █▄▄█ ▀██ ▀▀██
23. █ ▄▀█▄▄▀▄▄▀ ▄█ ▀█▄▄▀ █▄ █
24. █ █ ▄ ▄▄ ▀▄ █ ▀ ▀▄▄▄████▀▄█
25. █ █▀ █▄▄█▄▄ ▀▄▄▀▄▀▄█▄▀▄▀▄ █
26. █▄█▄█▄█▄▄▀█▀▀▀▄▀▀ ▄▄▄ █ ███
27. █ ▄▄▄▄▄ █ ▄ ▄ █ █▄█ ▄██▄█
28. █ █ █ ██▄▄▀▀▄█▄▄▄ ▄ ▄▀▀█
29. █ █▄▄▄█ █▀█ ▀▀▄█▀▀▄▀▀▀█▄█ █
30. █▄▄▄▄▄▄▄█▄█▄▄██▄▄▄█▄██▄██▄█
33. [INFO] ### App Server ### 手机设备(f70ecf3f)被连入
35. 开启实时更新服务器
37. > Quick-ArtSignPro@1.0.0 watch /Users/Abelhu/Desktop/Android/Quick-ArtSignPro
38. > hap watch
41. [INFO] 配置环境：{"NODE_PLATFORM":"na","NODE_PHASE":"dv"}
44. Webpack is watching the files…
47. [LOG] ### App Loader ### build目录构建完成
49. [LOG] ### App Loader ### dist目录签名并生成rpk文件：com.qicode.sign.quick.debug.rpk
51. [INFO] Build Time Cost: 2.063s
53. Hash: 84051941349165f58032
54. Time: 2063ms
56. [LOG] ### App Loader ### 请求手机自动刷新
58. [LOG] ### App Server ### 发送HTTP请求到手机: http://127.0.0.1:39517/update 成功
59. ### App Server ### 发送HTTP请求到手机: http://192.168.1.124:39517/update 失败: read ECONNRESET
62. [INFO] ### App Server ### 记录从设备(f70ecf3f)进入的HTTP请求

复制代码

ZeroTheLost

QiCode 发表于 2018-9-26 17:46 运行在手机端只代开了“快应用调试器”，并没有打开对应的快应用，以下是log ...

请问手机是不是之前安装过快应用的app? 如果是的话需要更新一下, 目前IDE用的快应用app有点特殊. 可以用下面的方法更新手机app: 此外如果是不是IDE新建的工程, 需要点击更新工程 选项

ZeroTheLost

临风听暮蝉 发表于 2018-9-25 14:30 都用跨平台框架了，打包个Ｌｉｎｕｘ版不难吧

了解到了, 我们努力一下

QiCode

ZeroTheLost 发表于 2018-9-27 09:47 请问手机是不是之前安装过快应用的app? 如果是的话需要更新一下, 目前IDE用的快应用app有点特殊. 可以用下 ...

尝试了用IDE安装2款APP，也尝试了IDE更新功能，IDE仍然未能打开chrome，手机端显示安装成功，但是并没用直接调起快应用，点击开始测试也没有任何反应