快应用开发工具常见问题

vivo developer -

快应用开发工具（下面统称为 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 版本中，予以解决。