快应用开发工具常见问题

快应用 Jul 16, 2019

快应用开发工具(下面统称为 IDE),专为快应用开发设计的开发工具;它,简单易用、灵活扩展、全面支持联盟标准规范;并支持 USB 调试、Web 预览、一键上传等功能。以下是所知的,快应用开发工具常见问题,将会统一在此维护更新,从而便于亲爱的开发者轻松查看。

手机通过数据线连接电脑,而 IDE 未提示设备已连接

  1. 打开手机设置找到关于手机,向下滑动找到软件版本号,连续多次点击软件版本号直到提示“您已处于开发者模式”。

  2. 打开手机设置找到开发者选项,向下滑动找到USB 调试并打开该选项。

  3. 重新插拔手机,手机上会弹出授权对话框,勾选“始终允许使用这台计算机进行调试”,点击确定按钮。

点击 IDE 顶部Debug 调试按钮开始调试,手机端快应用却没有运行起来

  1. 确认手机设备已经连接,IDE 右侧预览界面头部手机图标处于点亮状态;
  2. 点击 IDE 顶部hap``更新手机环境菜单,并在手机上按提示完成快应用预览版快应用调试器的安装;
  3. 打开手机设置找到权限管理,将快应用预览版存储关联启动后台弹出界面权限打开;
  4. 打开手机快应用调试器并将开启 USB 调试开关开启,此时会弹出授权对话框,点击始终允许按钮;
  5. 重新点击Debug 调试按钮开始调试

编译失败 Module not found: Error: Can`t resolve ‘xxx’ in ‘xxxx/extensions/hap-debugger/node_modules.asar/xxx’

  1. 打开终端,Windows 下可使用 git bash 终端;
  2. 输入 cd xxxx/extensions/hap-debugger ,(路径为错误信息 in 后面提示的路径,进入 hap-debugger 目录即可);
  3. 输入 sudo npm i xxx,(xxx 为错误信息 can`t resolve ‘xxx’ 提示的模块),安装对应的模块;
  4. 安装完成后可能还会有其他模块无法解析,请重复执行 sudo npm i xxx 安装,直到编译成功。

使用 IDE 编辑代码时,.ux 文件中有很多画线提示

解决方法一:

此类提示属于 eslint 检测的问题提示,开发者可在工程目录下的.eslintrc.json文件中自行配置 eslint 的检测规则来消除不需要的提示。

解决方法二:

点击 IDE 顶部查看``命令面板菜单,并输入 hap-ESlint,在搜索结果中点击hap-ESlint: Disable ESlint关闭 eslint 检测。

编辑代码 Script 部分自动补全及悬浮提示不生效

  1. 打开 IDE 首选项 => 设置,选择工作区设置,找到扩展 vetur configuration 中的 Extract Hap Types 并勾选 enable to import the latest types
  2. 退出并重新启动 IDE;
  3. 打开工程中的任意一个 .ux 文件;
  4. 查看工程目录下 node_modules 是否生成类似 @service.account.d.ts 的文件,存在则表示:自动补全及悬浮提示可以正常使用了;

IDE 预览跟手机端效果不一致

由于纯原生渲染与 Web 渲染存在的差异性,导致部分预览效果不一致。我们建议以手机端效果为准。

备注说明:对于 IDE 预览,有在持续与真机对齐;倘若您有发现有差异的部分,还请给予反馈,感谢

如何解决 Window 一打开 IDE,CPU 就被占用 100% 问题

如果查看活动资源占用,有发现名为 rg.exe 进程占用,可以前往菜单 => 首选项 => 设置,在里面搜索 search.followSymlinks,然后去掉勾选,重启下即可解决。

备注说明:将在 20 年 6 月中下旬发布的 3.1 版本中,予以解决。

vivo developer

快应用引擎、工具开发者、快应用生态拓展达人(vivo)。

Great! You've successfully subscribed.
Great! Next, complete checkout for full access.
Welcome back! You've successfully signed in.
Success! Your account is fully activated, you now have access to all content.