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

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

20
回复
1584
查看
  [复制链接]

146

主题

263

帖子

2240

积分

 楼主| 2018-9-21 21:28:07 显示全部楼层 |阅读模式
本帖最后由 管理员 于 2018-9-21 23:25 编辑

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



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.相关下载

开发工具:MAC版下载    windows版下载


快应用开发工具用户许可协议下载

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




回复

使用道具 举报

0

主题

2

帖子

5

积分

2018-9-22 13:42:33 显示全部楼层
本帖最后由 李光春 于 2018-9-22 14:00 编辑

期待已久!
回复

使用道具 举报

1

主题

3

帖子

20

积分

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

使用道具 举报

0

主题

6

帖子

25

积分

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请求

复制代码
回复

使用道具 举报

11

主题

31

帖子

380

积分

2018-9-27 09:47:56 显示全部楼层
本帖最后由 ZeroTheLost 于 2018-9-27 09:49 编辑
QiCode 发表于 2018-9-26 17:46
运行在手机端只代开了“快应用调试器”,并没有打开对应的快应用,以下是log
...

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

使用道具 举报

11

主题

31

帖子

380

积分

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,手机端显示安装成功,但是并没用直接调起快应用,点击开始测试也没有任何反应
回复

使用道具 举报

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