HarmonyOS 鸿蒙Next OpenHarmony IDE常见开发问题

HarmonyOS 鸿蒙Next OpenHarmony IDE常见开发问题

IDE

如何进行截屏操作

适用于OpenHarmony 3.2 Beta5 API 9

问题现象

对设备截屏操作，并显示在PC端。

解决措施

打开Log窗口，切换到Hilog便签，点击截屏按钮。

如何通过命令行重启设备

适用于OpenHarmony 3.2 Beta5 API 9

问题现象

手机已通过数据线连接电脑，需要使用命令行重启设备。

解决措施

执行命令：hdc shell reboot

IDE真机无法连接问题

适用于OpenHarmony 3.2 Beta5 API 9

问题现象

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

解决措施

当前DevEco Studio识别连接设备的规则：

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

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

hdc/hdc_std工具通常保存在sdk的toolchains根目录下

这两个命令可以查询设备是否可以通过hdc连接。如果查询结果显示了设备的编号即为已经可以通过hdc查询到该设备。这就代表了你的物理线缆+驱动配置没有问题。（3.2.8.3及之后的SDK， 已经把hdc_std改名为hdc了）

IDE默认创建的empty ability工程出现parent class is not constructor异常

适用于OpenHarmony 3.2 Beta5 API 9

问题现象

IDE默认创建的empty ability工程跑不起来出现parent class is not constructor异常。

解决措施

旧版本的IDE更新SDK后会导致Ability包不存在，需要更新IDE。

参考链接

• IDE下载地址

如何修改工程module名字

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

解决措施

工程的module需要在根目录的build-profile.json5中的modules属性下配置，配置名为name。

如何安装应用更新覆盖

适用于

问题现象

现在ROM上安装应用都是卸载后删除，需求更新覆盖。当前这种存储的信息都丢了，得重新操作一遍。有没有办法提供覆盖安装方式？

解决措施

输入命令：hdc install -r PAGECKAGE_NAME.hap。

如何设置原型机息屏时间

适用于

问题现象

应用想设置息屏时间为固定值。

解决措施

输入命令：hdc shell power-shell timeout -o 1000

DevEco Studio中无法使用ctrl+shift+F快捷键开启全文搜索

适用于

问题现象

在DevEco Studio中使用ctrl+shift+F快捷键开启全文搜索，无响应。

问题原因

全文搜索快捷键与输入法快捷键冲突。

解决方案

关闭输入法快捷键或者更改输入法快捷键。

例如：关闭微软拼音快捷键。

使用DevEco Studio安装应用时，报错：The hdc_std version of the SDK does not match the hdcd version of the device

适用于：OpenHarmony SDK 3.2.5.6版本，API9 Stage模型

问题现象

DevEco Studio点击run按钮后，报错：The hdc_std version of the SDK does not match the hdcd version of the device。

问题原因

SDK中hdc工具版本和设备系统hdc的版本不匹配。

解决方案

建议更新DevEco Studio。

旧版本DevEco Studio检测版本不匹配，会拦截安装动作。新版本更改为仅提醒，不影响正常安装使用。

参考链接

• DevEco Studio下载链接

如何修改编译的hap包中module.json文件app.debug配置

解决措施

该debug字段指定允不允许开发者进行调试，可以在hvigor命令中添加-p debuggable=false；在工程目录下打开命令行工具，执行 hvigor 命令，如下：

node .\node_modules\@ohos\hvigor\bin\hvigor.js  -p debuggable=false --mode module assembleHap

无法找到hdc命令

适用于：OpenHarmony 3.2 Beta5 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，即可查看组件树结构。

多模块开发，能否做到模块跳转，复用某个view

适用于：OpenHarmony 3.2 Beta5 API9

问题现象

在进行多个模块开发时，需要在多个模块之间复用某一个组件内容，如何实现？

解决措施

1. 创建har包

2. 引入har包

参考链接

• 开发har包

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

适用于：OpenHarmony 3.2 Beta5 API 9

解决方案

代码格式化处理可参考：代码格式化

代码检查工具：codelinter； 详情使用可参考：codelinter使用指导

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

适用于：OpenHarmony 3.2 Beta5 API 9

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

使用DevEco Studio安装应用时，报错：error: unknow option. usage: aa start

适用于：OpenHarmony 3.2 Beta5 API 9

问题现象

DevEco Studio点击run按钮后，报错：error: unknow option. usage: aa start <options>

问题原因

SDK版本升级导致aa命令参数变更，旧的设备系统版本无法识别新的命令导致报错。

解决措施

请升级设备系统版本，保证设备系统版本等于或高于SDK版本。

设备系统版本可以通过“系统桌面–设置–关于本机”查看。

SDK版本可以通过“DevEco Studio工具栏 Tools–SDK Manger”查看。

DevEco Studio 执行ohpm install 过程无响应

适用于：OpenHarmony 3.2 Beta5 API 9

问题现象

ohpm install执行过程无响应。

问题原因

ohpm安装的依赖文件被其他进程所占用，导致安装该依赖时一致卡住不动。

解决措施

结束DevEco Studio和ohpm相关的进程，或者重启电脑后再执行ohpm install。

DevEco Studio编译报错：‘entryModules’ must be configured for a feature module

适用于：OpenHarmony 3.2 Beta5 API 9

问题现象

项目编译过程中报错：‘entryModules’ must be configured for a feature module。

问题原因

build-profile.json5文件中缺少entryModules配置。

解决措施

打开该模块的build-profile.json5文件，配置entryModules字段，并指定入口的模块名。

IDE忽略代码报错后，如何取消

适用于：Openharmony 3.2 Beta5 API 9

解决措施

通过去掉代码中的@ts-nocheck和@ts-ignore实现。

如何查看应用进程是否运行

适用于：OpenHarmony 3.2 Beta5 API 9

问题现象

调测阶段，需要通过命令行查看后台服务是否正在运行。

解决方案

通过命令 hdc shell ps -ef 命令查看所有进程，

也可以使用 hdc shell ps -ef | grep 应用包名 查看指定应用。

若无特殊配置，应用的进程名默认是应用包名。

如何解决hdc file recv 使用报错：Unkonow file option -r

适用于：OpenHarmony 3.2 Beta5 API 9

问题现象

使用hdc工具向设备推送文件时，报错：Unkonow file option -r。

问题原因

1. hdc工具需要与设备上的hdcd服务配套使用，版本差异过大，会导致不兼容的问题。
2. hdc指定路径时不能含有中文和空格。

解决措施

1. 使用设备镜像或者同版本SDK中配套的hdc工具进行使用。
2. hdc工具指定的路径不要包含中文和空格。

如何查看系统是32位还是64位

适用于：OpenHarmony 3.2 Beta5 API9

问题现象

由于32位系统与64位系统使用的so文件不通用，开发调试阶段需要查看系统是32位还是64位。

解决措施

使用命令：hdc shell getconf LONG_BIT

若返回64则为64位系统，否则为32位系统。

如何获取OpenHarmony单元测试案例的使用资料

适用于：OpenHarmony 3.2 Beta5 API 9

问题现象

官网上如何获取OpenHarmony单元测试案例的使用资料。

参考链接

• 自动化测试框架使用介绍

如何使设备保持屏幕常亮

适用于：OpenHarmony 3.2 Beta5 API 9

解决措施

输入命令：hdc shell power-shell setmode 602

参数说明：600（正常模式），601（省电模式），602（常亮），603（退出省电模式）

如何通过命令启动Ability

适用于：OpenHarmony 3.2 Beta5 API 9

问题现象

通过hdc命令启动Ability。

解决措施

输入命令 hdc shell aa start -a AbilityName -b bundleName -m moduleName。

当使用高APL权限等级时，更新UnsgnedReleasedProfileTemplate.json未生效

适用于：OpenHarmony 3.2 Beta5 API 9

问题现象

修改签名文件UnsgnedReleasedProfileTemplate.json之后结果权限申请还是不成功。

解决措施

修改UnsgnedReleasedProfileTemplate.json中的配置之后，需要清除本地签名文件的缓存，重新生成签名文件。

自动生成签名文件默认路径：C:\Users${用户名}.ohos\config\openharmony

日志的常用命令有哪些

适用于：OpenHarmony 3.2 Beta5，API 9 Stage模型

日志的常用命令包括：

• 清理日志：hdc shell hilog -r
• 调大缓存到20M：hdc shell hilog -G 20M
• 抓取日志：hdc shell hilog > log.txt
• 上传文件：hdc file send path://local.txt path://targetPath

如何下载SDK的历史版本

适用于：OpenHarmony 3.2 Beta5 API9

问题现象

需要下载旧版本SDK

解决措施

• 历史版本SDK下载

DevEco Studio支持哪些系统和版本

适用于：OpenHarmony 3.2 Beta API 9

问题现象

DevEco Studio支持哪些系统和版本

解决措施

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

IDE上检测不到真机设备

适用于：OpenHarmony 3.2 Beta API 9

问题现象

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

解决措施

按照如下三步排查问题：

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

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

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

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

• hdc kill
• hdc start
• hdc shell

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

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

IDE中无法使用ctrl+shift+F快捷键开启全文搜索

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

问题现象

IDE中无法使用ctrl+shift+F快捷键开启全文搜索

可能原因

输入法快捷键冲突

解决措施

关闭输入法快捷键即可。

如何更换SDK目录

适用于：OpenHarmony 3.2 Beta API 9

解决措施

通过Settings中SDK Manager来更换。

如何通过hdc命令卸载应用

适用于：OpenHarmony 3.2 Beta5 API 9

命令行输入命令：hdc uninstall [packageName]

如何查看组件树结构

适用于：OpenHarmony 3.2 Beta5 API 9

1. 使用hdc shell进入命令行界面。
2. 输入 aa dump -a 找到应用 AbilityRecord ID。
3. aa dump -i [abilityID] -c -element 查看组件树。

如何使用DevEco Studio实现C++和js跨语言调试

适用于：OpenHarmony 3.2 Beta5 API 9

解决措施

参考文档内容：ArkTS/JS与C/C++工程跨语言调试

如何使用命令行编译CMake

适用于：OpenHarmony 3.2 Beta5 API 9

解决措施

参考文档内容：NAPI_Learning

如何解决hvigor报错 env：node：No such file or directory

适用于：OpenHarmony 3.2 Beta5 API 9

解决措施

需要清除缓存，需将.hvigor、.idea、build、node_modules等临时文件删除并重启IDE

OpenHarmony如何关闭布局边界

适用于：OpenHarmony 3.2 Beta API 9

解决措施

可以通过hdc命令关闭布局边界的选项，组件边界开关命令：hdc_std shell param set persist.ace.debug.boundary.enabled true

最新版OpenHarmonyUT用例的名字不能有空格了吗

适用于：OpenHarmony 3.2 Beta API 9

解决措施

测试UI例命名，测试点采用驼峰描述，测试用例字母小写