请选择 进入手机版 | 继续访问电脑版
 找回密码
 立即注册
搜索

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

22
回复
17846
查看
  [复制链接]

477

主题

777

帖子

6595

积分

 楼主| 2018-9-21 21:28:07 显示全部楼层 |阅读模式
本帖最后由 管理员 于 2019-3-28 10:31 编辑
快应用开发工具使用说明文档

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
1.png
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
2.png
iv 如果手机没有安装快应用环境,会自动帮手机安装上相应的环境。请在手机操作,允许安装。安装完成后,需要给快应用引擎授权,如图1.2.2 所示。授权完成后,在IDE上点击继续调试,如图1.2.3
图1.2.2
3.png
图1.2.3
4.png
v 然后IDE会自动运行相关命令(npm run watch 和 npm run server),并打开chrome浏览器的调试页面,如图1.2.4所示。 如果对页面有修改,只需要保存您的文件即可, 调试器会自动帮你刷新页面。如果调试过程中遇到问题,请参考开发者工具常见问题
图1.2.4
5.png
vi 使用 lightening debug 并不会每次都执行npm install 以加速调试, 如果想保证每次调试之前都安装依赖,可以在调试面板选择 quick debug,然后按F5进行调试, 如图1.2.5所示
图1.2.5
6.png
vii 如果不想进行调试,只想运行看看效果, 请选择Run Application , 然后按下F5进行调试。如图1.2.6所示
图1.2.6
7.png

2. 用开发者工具调试现有的快应用工程
i 使用打开功能打开工程的文件夹, 如图2.1.1所示
图2.1.1
8.png
ii 如果之前没有用IDE进行过开发和调试, 需要把IDE的环境配置到工程目录里头。请在快应用面板上点击更新工程按钮, 如图 2.1.2所示
图2.1.2
9.png

3. 如果手机之前安装了快应用环境, 需要先升级调试器和快应用引擎
i 打开快应用面板,点击安装快应用apk,强制升级,如图3.1.1所示
图3.1.1
10.png
ii 然后打开快应用工程,按F5调试即可。流程跟快速开发里面的调试流程一样

4. 发布快应用
4.1 生成证书
发布快应用之前, 需要生成证书。 请点击快应用面板的生成证书, 然后按提示输入所需信息。如图4.1.1所示
图4.1.1
11.png
4.2 生成发布用RPK
点击发布rpk包按钮,生成成功的话会弹出对应的文件夹。如图4.2.1所示
图4.2.1
12.png

5 手机开启USB DEBUG
i 开启手机MTP传输,类似下图 5.1.1
图5.1.1
13.png
ii开启手机MTP传输,可能需要用户授权,点击允许授权按钮即可。
iii 在开发者面板里面开启开发者选项,类似下图 5.1.2
图5.1.2
14.png
iv 开发者面板里头开启USB调试,类似下图 5.1.3
图5.1.3
15.png

6.相关下载
https://www.quickapp.cn/docCenter/post/97
官方客服微信:kuaiyingyongguanKF
回复

使用道具 举报

0

主题

2

帖子

5

积分

2018-9-22 13:42:33 显示全部楼层
本帖最后由 李光春 于 2018-9-22 14:00 编辑 期待已久!
回复

使用道具 举报

1

主题

3

帖子

20

积分

2018-9-22 16:45:36 来自手机 显示全部楼层
前排占个座,
回复

使用道具 举报

0

主题

11

帖子

50

积分

2018-9-25 14:30:08 显示全部楼层
都用跨平台框架了,打包个Linux版不难吧
回复

使用道具 举报

5

主题

12

帖子

85

积分

2018-9-25 15:44:31 显示全部楼层
太好啦~~~终于有了
回复

使用道具 举报

0

主题

6

帖子

30

积分

2018-9-26 17:16:08 显示全部楼层
使用oppo手机测试,界面全空白···
回复

使用道具 举报

0

主题

6

帖子

30

积分

2018-9-26 17:46:45 显示全部楼层
运行在手机端只代开了“快应用调试器”,并没有打开对应的快应用,以下是log
  1. 打开调试中...
  2. > Quick-ArtSignPro@1.0.0 server /Users/Abelhu/Desktop/Android/Quick-ArtSignPro
  3. > hap server
  4. [INFO] ### App Server ### 完成创建adb调试器。您可以通过usb线连入手机调试
  5. [INFO] ### App Server ### 服务器地址: http://localhost:12306, http://192.168.1.115:12306
  6. [INFO] ### App Server ### 请确保手机与App Server处于相同网段
  7. 生成HTTP服务器的二维码: http://192.168.1.115:12306
  8. 打开调试页面: http://192.168.1.115:12306
  9. ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
  10. █ ▄▄▄▄▄ ██▄▄ ▀▄██▄█ ▄▄▄▄▄ █
  11. █ █ █ █▀▄ █▀ ▀ █ █ █ █
  12. █ █▄▄▄█ █▄▀ █▄█▄█▀█ █▄▄▄█ █
  13. █▄▄▄▄▄▄▄█▄▀▄█ █ █▄█▄▄▄▄▄▄▄█
  14. █ ▀▀█ ▄ █▄ █▄▄█ ▀██ ▀▀██
  15. █ ▄▀█▄▄▀▄▄▀ ▄█ ▀█▄▄▀ █▄ █
  16. █ █ ▄ ▄▄ ▀▄ █ ▀ ▀▄▄▄████▀▄█
  17. █ █▀ █▄▄█▄▄ ▀▄▄▀▄▀▄█▄▀▄▀▄ █
  18. █▄█▄█▄█▄▄▀█▀▀▀▄▀▀ ▄▄▄ █ ███
  19. █ ▄▄▄▄▄ █ ▄ ▄ █ █▄█ ▄██▄█
  20. █ █ █ ██▄▄▀▀▄█▄▄▄ ▄ ▄▀▀█
  21. █ █▄▄▄█ █▀█ ▀▀▄█▀▀▄▀▀▀█▄█ █
  22. █▄▄▄▄▄▄▄█▄█▄▄██▄▄▄█▄██▄██▄█
  23. [INFO] ### App Server ### 手机设备(f70ecf3f)被连入
  24. 开启实时更新服务器
  25. > Quick-ArtSignPro@1.0.0 watch /Users/Abelhu/Desktop/Android/Quick-ArtSignPro
  26. > hap watch
  27. [INFO] 配置环境:{"NODE_PLATFORM":"na","NODE_PHASE":"dv"}
  28. Webpack is watching the files…
  29. [LOG] ### App Loader ### build目录构建完成
  30. [LOG] ### App Loader ### dist目录签名并生成rpk文件:com.qicode.sign.quick.debug.rpk
  31. [INFO] Build Time Cost: 2.063s
  32. Hash: 84051941349165f58032
  33. Time: 2063ms
  34. [LOG] ### App Loader ### 请求手机自动刷新
  35. [LOG] ### App Server ### 发送HTTP请求到手机: http://127.0.0.1:39517/update 成功
  36. ### App Server ### 发送HTTP请求到手机: http://192.168.1.124:39517/update 失败: read ECONNRESET
  37. [INFO] ### App Server ### 记录从设备(f70ecf3f)进入的HTTP请求
复制代码
回复

使用道具 举报

12

主题

43

帖子

445

积分

2018-9-27 09:47:56 显示全部楼层
本帖最后由 ZeroTheLost 于 2018-9-27 09:49 编辑
QiCode 发表于 2018-9-26 17:46 运行在手机端只代开了“快应用调试器”,并没有打开对应的快应用,以下是log ...
请问手机是不是之前安装过快应用的app? 如果是的话需要更新一下, 目前IDE用的快应用app有点特殊. 可以用下面的方法更新手机app: 此外如果是不是IDE新建的工程, 需要点击更新工程 选项
回复

使用道具 举报

12

主题

43

帖子

445

积分

2018-9-27 09:52:12 显示全部楼层
临风听暮蝉 发表于 2018-9-25 14:30 都用跨平台框架了,打包个Linux版不难吧
了解到了, 我们努力一下
回复

使用道具 举报

0

主题

6

帖子

30

积分

2018-9-27 10:51:33 显示全部楼层
ZeroTheLost 发表于 2018-9-27 09:47 请问手机是不是之前安装过快应用的app? 如果是的话需要更新一下, 目前IDE用的快应用app有点特殊. 可以用下 ...
尝试了用IDE安装2款APP,也尝试了IDE更新功能,IDE仍然未能打开chrome,手机端显示安装成功,但是并没用直接调起快应用,点击开始测试也没有任何反应
回复

使用道具 举报

您需要登录后才可以回帖 登录 | 立即注册