目录

自定义运行/调试配置

配置应用可调试

应用是否支持调试,根据app.json5的debug字段和build-profile.json5的debuggable字段综合判断,app.json5的优先级高于build-profile.json5。

  1. 在app.json5中配置debug字段:
    • true:应用支持调试。
    • false:应用不支持调试。
  2. 如果没有配置debug字段,则根据build-profile.json5的debuggable字段判断应用是否支持调试。
    • true:应用支持调试。当构建模式不是release时,debuggable的缺省值是true,即支持调试。
    • false:应用不支持调试。当构建模式为release时,debuggable的缺省值是false,即不支持调试。

设置调试代码类型

点击编辑器上方按钮,在菜单中点击Application并选择相应模块,点击右侧按钮打开配置界面。

在配置界面中点击调试器选项并设置调试类型。

工程调试类型默认为Detect Automatically,关于各调试类型的说明如下表所示:
表1 调试类型配置项

调试类型

调试代码

Detect Automatically

新建工程默认调试器选项。根据工程模块及其依赖的模块涉及的编程语言,自动启动对应的调试器。

ArkTS/JS

  • 调试ArkTS代码
  • 调试JS代码

Native

仅调试C/C++代码

Dual(ArkTS/JS + Native)

调试C/C++工程的ArkTS/JS和C/C++代码

设置HAP安装方式

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

设置方法如下:

点击编辑器上方按钮,在菜单中点击Application并选择相应模块,点击右侧按钮打开配置界面。在配置界面通用中设置指定模块的HAP安装方式,勾选保留应用数据,则表示采用覆盖安装方式,保留应用/元服务缓存数据。

[h2]配置自定义调试参数

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

[h2]配置环境变量

如果开发者需要配置和管理应用开发环境,以及控制应用程序的行为,可配置环境变量。

点击按钮,新增一行配置项。当前支持以下配置项:

当配置环境变量后,保留应用数据覆盖安装不生效。

环境变量配置完成后,需确保环境变量已勾选。

多模块调试

[h2]安装多个模块

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

设置方法如下:

点击编辑器上方按钮,在菜单中点击Application并选择相应模块,点击右侧按钮打开配置界面。在配置界面通用中,勾选多包推送,选择多个模块。

[h2]自动安装依赖

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

设置方法如下:

点击编辑器上方按钮,在菜单中点击Application并选择相应模块,点击右侧按钮打开配置界面。在配置界面通用中,勾选自动依赖。

在前置任务中,可以点击添加应用启动前的任务,也可以点击移除任务。

在勾选自动依赖后,可以同时勾选多包推送,从而达到推送所有包的效果。