HarmonyOS鸿蒙Next IDE常见开发问题

IDE

• IDE真机无法连接问题
• DevEco Studio连接Mate50远程设备，在密码输入框中进行输入时会黑屏
• 无法找到hdc命令
• Har包如何导出ts文件
• IDE预览器中如何查看组件树结构
• DevEco 有没有指定的代码格式化的插件工具和编程规范检查的插件工具
• DevEco Studio 是否支持统计项目的总代码量
• DevEco Studio支持哪些系统和版本
• IDE上检测不到真机设备

IDE真机无法连接问题

适用于 Harmony SDK 3.1 Beta API9

问题现象

IDE无法连接真机问题或者如何连接真机问题。

解决措施

• 当前DevEco Studio识别连接设备的规则，规则参考如下为：

  • 如果只打开HarmonyOS工程，则设备选择框只展示HarmonyOS设备；如果只打开了OpenHarmony工程，则只展示OpenHarmony设备。
  • 如果同时打开了HarmonyOS和OpenHarmony工程，则设备选择框同时展示HarmonyOS设备和OpenHarmony设备。
  • 如果一个工程中，同时存在HarmonyOS Target和OpenHarmony Target，则设备选择框同时展示HarmonyOS设备和OpenHarmony设备。

特别的：如果是3.1.1.200及以后版本，会同时拉起HDC和HDCExternal，因此不会受到工程种类的显示，HarmonyOS和OpenHarmony设备都能够识别

• hdc/hdc_std工具通常保存在sdk的toolchains根目录下
• hdc list targets（HarmonyOS）/hdc_std list targets（openHarmony）这两个命令可以查询设备是否可以通过hdc连接。如果查询结果显示了设备的编号即为已经可以通过hdc查询到该设备。这就代表了你的物理线缆+驱动配置没有问题。（3.2.8.3及之后的SDK， 已经把hdc_std改名为hdc了）

DevEco Studio连接Mate50远程设备，在密码输入框中进行输入时会黑屏

适用于：HarmonyOS 3.2 Beta5 API 9

问题现象

密码输入框激活后，屏幕会出现黑屏现象。

问题原因

由于密码输入过程中，手机会屏蔽录屏功能保证信息安全。

解决措施

建议使用真机进行开发或者测试。

无法找到hdc命令

适用于：Harmony SDK 3.1 Beta API9

问题现象

使用hdc命令时，提示无法找到hdc。

可能原因

hdc环境配置问题。

解决措施

需要将sdk目录下的toolchains目录配置到系统环境变量中。路径为安装SDK时的路径

Har包如何导出ts文件

适用于：DevEco Studio 3.1 beta

问题现象

使用har包，需要导出ts文件，如何操作？

解决措施

在library中的indext.ets文件中可以配置导出内容，使用export导出相应的ts文件。

IDE预览器中如何查看组件树结构

适用于：DevEco Studio 3.1.1.101及以上版本

解决措施

在预览器Previewer中点击右上角，inspector，即可查看组件树结构。

DevEco 有没有指定的代码格式化的插件工具和编程规范检查的插件工具

适用于：Harmony SDK 3.1 Beta API 9

解决方案

• 代码格式化处理可参考：代码格式化
• 代码检查工具：codelinter； 详情使用可参考：codelinter使用指导

DevEco Studio 是否支持统计项目的总代码量

适用于：Harmony SDK 3.1 Beta API 9

DevEco Studio本身暂不支持，可以通过下载IntelliJ的代码统计插件Statistic来进行统计，下载zip包后再本地安装即可。

DevEco Studio支持哪些系统和版本

适用于： HarmonyOS 3.1Beta API 9

问题现象

DevEco Studio支持哪些系统和版本

解决措施

• Windows ：操作系统 ：Windows10 64位
  • 内存：8GB及以上
  • 硬盘：100GB及以上
  • 分辨率：1280*800像素及以上
• macOS：
  • 操作系统：macOS 10.15/11/12
  • 内存：8GB及以上
  • 硬盘：100GB及以上
  • 分辨率：1280*800像素及以上

IDE上检测不到真机设备

适用于： HarmonyOS 3.1Beta API 9

问题现象

连接真机后，IDE上没有显示，无法检测到设备

解决措施

按照如下三步排查问题：

1. 确保真机已连接到电脑上，USB连接线正确插入接口中。
2. 检查项目工程和真机的版本是否一致，例如仅开启OpenHarmony工程，只能识别OpenHarmony设备。详细DevEco Studio识别连接设备的规则请见文档：https://developer.huawei.com/consumer/cn/doc/harmonyos-faqs/faq-debugging-and-running-0000001166752005
3. 如果IDE版本在3.1.0.200版本之前，在SDK路径下的的包toolchains中是否有hdc_std.exe程序文件，并执行该文件。部分版本SDK中，该程序名称为hdc.exe,需手改修改过来。如果IDE版本在3.1.0.200及之后的版本，则不需要修改。

按照以上三步排查问题后，重启IDE即可。

1. 上诉三步操作后，重启IDE依然无法检测到设备。检查是否有多个hdc进程在运行。输入如下命令：hdc shell

   如提示报错：“[Fail] ExecuteCommand need connect-key?”，则表示有多个hdc进程在运行。关闭多余进程并重启即可，依次输入如下命令：

   • hdc kill
   • hdc start
   • hdc shell

   如若依然无法连接上设备，则关机并重启电脑。

以上四步操作后，依然无法连接设备，请将问题反馈到官方进行求助。