快应用开发工具常见问题

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