鸿蒙NEXT开发【自定义运行/调试配置】应用/服务调试

DevEco Studio提供了丰富的HarmonyOS应用/服务调试能力，支持JS、ArkTS、C/C++单语言调试和ArkTS/JS+C/C++跨语言调试能力，并且支持三方库源码调试，帮助开发者更方便、高效的调试应用/服务。

HarmonyOS应用/服务调试支持使用真机设备、模拟器、预览器调试。接下来以使用真机设备为例进行说明，详细的调试流程如下图所示：

1. [配置签名信息]：使用真机设备进行调试前需要对HAP[进行签名]；使用模拟器和预览器调试无需签名。
2. [设置调试代码类型]：调试类型默认为Detect Automatically 。
3. [设置HAP安装方式]：选择先卸载应用/服务后再重新安装或覆盖安装。
4. [启动调试]：启动debug调试或attach调试。

使用预览器调试的特别说明

使用真机或模拟器进行调试时，修改后的代码需要经过较长时间的编译和安装过程，才能刷新至调试环境。使用预览器进行调试，可快速地修改代码和运行应用，在DevEco Studio中直接查看修改后的界面显示效果。

开发者可以使用预览器运行调试Ability生命周期代码和界面代码，预览器调试支持基础Debug能力，包括断点、调试执行、变量查看等。

预览器调试使用约束：

• 一个工程内不支持启动多个预览调试任务。

• 一个Previewer只能支持普通预览或预览调试模式，不可同时支持两种模式。

• 使用预览器进行调试不支持以下场景：

  • 不支持Attach。
  • 不支持跨Ability调试。
  • 不支持C++调试。
  • 不支持极速预览。
  • 不支持Hot Reload。
  • 不支持多进程和worker/taskpool调试。

自定义运行/调试配置

设置调试代码类型

点击Run > Edit Configurations > Debugger，选择相应模块，设置Debug type即可。

工程调试类型默认为Detect Automatically，关于各调试类型的说明如下表所示：

调试类型	调试代码
Detect Automatically	新建工程默认调试器选项。根据工程模块及其依赖的模块涉及的编程语言，自动启动对应的调试器。
ArkTS/JS	- 调试ArkTS代码

• 调试JS代码 |
  | Native | 仅调试C/C++代码 |
  | Dual(ArkTS/JS + Native) | 调试C/C++工程的ArkTS/JS和C/C++代码 |

设置HAP安装方式

在调试阶段，HAP在设备上的安装方式有2种，可以根据实际需要进行设置。

• 安装方式一：先卸载应用/服务后，再重新安装，该方式会清除设备上的所有应用/服务缓存数据。

  从DevEco Studio 4.1 Canary2版本开始，支持当代码无变化时，不进行推包安装。即根据模块有无变化来判断是否重新推送安装模块包，在运行调试时仅将有变化的模块及依赖它的模块重新推送安装至设备上。如entry依赖了HSP模块，当HSP模块有变化，运行调试时将同时推送安装HSP模块和entry模块。

• 安装方式二：采用覆盖安装方式，不卸载应用/服务，该方式会保留应用/服务的缓存数据。

设置方法如下：

单击Run > Edit Configurations，设置指定模块的HAP安装方式，勾选“Keep Application Data”，则表示采用覆盖安装方式，保留应用/服务缓存数据。

说明

从DevEco Studio NEXT Developer Beta1开始，默认勾选“Keep Application Data”。

配置自定义调试参数

如果未进行自定义，将按默认配置安装和运行应用。如果开发者需要对应用安装、运行等流程增加参数配置，可在“Installation Options”和“Launch Options”下进行配置。

• Installation Options

  • DebugLine Support：勾选Enable DebugLine表示在build产物中系统组件增加debugline属性，用于开启[ArkUI Inspector源码跳转]功能。
  • Install Flags：输入bm install命令相关的选项。如可以设置“-w 360”，表示将超时等待时间设置为360秒。

• Launch Options

  • Launch：指定在安装应用后启动的Ability。

    外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

    • Nothing：只安装不启动任何Ability。

    • Default Ability：默认的EntryAbility。

      • Stage模型：module.json5文件中配置了“skills”属性的第一个ability；若无配置“skills”属性的ability，则取“mainElement”指定的ability（该ability需存在于“abilities”数组内）；若“mainElement”未指定，则取“abilities”数组内的第一个ability。

        

      • FA模型：config.json文件中配置了“skills”属性的第一个ability；若无配置“skills”属性的ability，则取“mainAbility”指定的ability（该ability需存在于“abilities”数组内）；若“mainAbility”未指定，则取“abilities”数组内的第一个ability。

    • Specified Ability：工程中的ExtensionAbility。

      您可以在工程中添加ExtensionAbility，如需了解开发ExtensionAbility。

      如果您的工程中包含ExtensionAbility，可以选择Specified Ability，在Ability指定您希望调试的ExtensionAbility进行调试。

      

  • Launch Flags：输入aa start命令相关的选项。

配置环境变量

如果开发者需要配置和管理应用开发环境，以及控制应用程序的行为，可在“Environment Variables”下配置环境变量。

点击+按钮，新增一行配置项。当前支持以下配置项：

• ASAN_OPTIONS：在运行时配置ASan的行为，包括设置检测级别、输出格式、内存错误报告的详细程度等。若开发者未配置log_exe_name、abort_on_error，DevEco Studio将自动填充。因NEXT.0.0.68及以上版本的ROM不再需要log_path参数，DevEco Studio 5.0.3.810及以上版本不再自动填充该值，5.0.3.810以下的版本会自动填充。如果需要在NEXT.0.0.68以下版本的ROM中配置ASAN_OPTIONS，请手动配置log_path，否则检测出的内存错误日志无法上报。ASAN_OPTIONS是应用级别的，只在entry和feature模块中配置生效，HAR/HSP模块配置不生效。

说明

当配置Environment Variables后，“Keep Application Data”覆盖安装不生效。

环境变量配置完成后，需确保环境变量已勾选，勾选后点击Apply才可生效。

开启异常检测

如需开启异常检测相关能力，请点击Diagnostics。当前支持Runtime Sanitization，勾选Address Sanitizer表示启用ASan功能。

多模块调试

安装多个模块

如果一个工程中同一个设备存在多个模块（如存在entry和feature模块），且存在模块间的调用时，在调试阶段需要同时安装多个模块的Hap包到设备中。此时，需要在Deploy Multi Hap中选择多个模块，启动调试时，DevEco Studio会将所有的模块都安装到设备上。

从DevEco Studio V3.1 Release开始支持。

设置方法如下：

单击Run > Edit Configurations，在Deploy Multi Hap中，勾选Deploy Multi Hap Packages，选择多个模块。

自动安装依赖

如果一个工程中entry/feature/HSP模块直接依赖其他HAR/HSP模块（如entry模块依赖HSP模块）及间接依赖其他模块（如entry模块依赖HAR模块，HAR又依赖HSP模块）时，在调试阶段需要同时安装模块包及其所有依赖模块的包到设备中。此时，可以设置Auto Dependencies，启动调试时会自动将所有依赖的模块都安装到设备上。

从DevEco Studio 4.1 Canary1版本开始支持。

设置方法如下：

单击Run > Edit Configurations，在General中，勾选Auto Dependencies。

在Before launch窗格中，您可以点击+添加应用启动前的任务。

也可以点击-移除任务。

在勾选Auto Dependencies后，可以同时勾选Deploy Multi Hap Packages，从而达到推送所有包的效果。加粗样式

最后呢

很多开发朋友不知道需要学习那些鸿蒙技术？鸿蒙开发岗位需要掌握那些核心技术点？为此鸿蒙的开发学习必须要系统性的进行。

而网上有关鸿蒙的开发资料非常的少，假如你想学好鸿蒙的应用开发与系统底层开发。你可以参考这份资料，少走很多弯路，节省没必要的麻烦。由两位前阿里高级研发工程师联合打造的《鸿蒙NEXT星河版OpenHarmony开发文档》里面内容包含了（ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、Harmony南向开发、鸿蒙项目实战等等）鸿蒙（Harmony NEXT）技术知识点

如果你是一名Android、Java、前端等等开发人员，想要转入鸿蒙方向发展。可以直接领取这份资料辅助你的学习。下面是鸿蒙开发的学习路线图。

针对鸿蒙成长路线打造的鸿蒙学习文档。话不多说，我们直接看详细鸿蒙（OpenHarmony ）手册（共计1236页）与鸿蒙（OpenHarmony ）开发入门视频，帮助大家在技术的道路上更进一步。

• 《鸿蒙 (OpenHarmony)开发学习视频》
• 《鸿蒙生态应用开发V2.0白皮书》
• 《鸿蒙 (OpenHarmony)开发基础到实战手册》
• OpenHarmony北向、南向开发环境搭建
• 《鸿蒙开发基础》
• 《鸿蒙开发进阶》
• 《鸿蒙开发实战》

总结

鸿蒙—作为国家主力推送的国产操作系统。部分的高校已经取消了安卓课程，从而开设鸿蒙课程；企业纷纷跟进启动了鸿蒙研发。

并且鸿蒙是完全具备无与伦比的机遇和潜力的；预计到年底将有 5,000 款的应用完成原生鸿蒙开发，未来将会支持 50 万款的应用。那么这么多的应用需要开发，也就意味着需要有更多的鸿蒙人才。鸿蒙开发工程师也将会迎来爆发式的增长，学习鸿蒙势在必行！ 自↓↓↓拿