自定义运行/调试配置
==========

#### 配置应用可调试

应用是否支持调试，根据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：应用支持调试。当[编译模式](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-hvigor-compilation-options-customizing-guide#section192461528194916)不是release时，debuggable的缺省值是true，即支持调试。
    *   false：应用不支持调试。当编译模式为release时，debuggable的缺省值是false，即不支持调试。

#### 设置调试代码类型

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

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/50/v3/-Nfh8o9JRxOnmDAPemHK8g/zh-cn_image_0000002624994315.png?HW-CC-KV=V1&HW-CC-Date=20260612T073857Z&HW-CC-Expire=86400&HW-CC-Sign=E03A2E02BCF81CAFF091D09EBC5911AFDD0D5C6D42440ECF1E5B830C7762D536)

工程调试类型默认为**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种，可以根据实际需要进行设置。

*   安装方式一：先卸载应用/元服务后，再重新安装，该方式会清除设备上应用/元服务所有的缓存数据。
    
    从DevEco Studio 4.1 Canary2版本开始，支持当代码无变化时，不进行推包安装。即根据模块有无变化来判断是否重新推送安装模块包，在运行调试时仅将有变化的模块及依赖它的模块重新推送安装至设备上。如entry依赖了HSP模块，当HSP模块有变化，运行调试时将同时推送安装HSP模块和entry模块。
    
*   安装方式二：采用覆盖安装方式，不卸载应用/元服务，该方式会保留应用/元服务的缓存数据。

设置方法如下：

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

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/57/v3/Z-jScsTpSJepdxfZ39HNhA/zh-cn_image_0000002594474972.png?HW-CC-KV=V1&HW-CC-Date=20260612T073857Z&HW-CC-Expire=86400&HW-CC-Sign=49E7E72E8708345B9CDD551D87BB45F1438EA2BD6CBF4ABE3B1974F9BA419093)

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

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

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/e6/v3/-e34KMc0SLCFdph_ReyYeQ/zh-cn_image_0000002594634870.png?HW-CC-KV=V1&HW-CC-Date=20260612T073857Z&HW-CC-Expire=86400&HW-CC-Sign=66E850EF00342F358940EE56648360824FE9FC4D6CF658B79A99712B8B995EAB)

*   Installation Options
    *   DebugLine Support：勾选Enable DebugLine表示在构建产物中系统组件增加debugline属性，用于开启[ArkUI Inspector源码跳转](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-arkui-inspector#section1226015494335)功能。
    *   Install Flags：输入bm install命令相关的选项，请参见[bm install 参数](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/bm-tool#安装命令install)。如可以设置“-w 360”，表示将超时等待时间设置为360秒。
*   Launch Options
    *   Launch：指定在安装应用后启动的Ability。
        
        ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/a7/v3/9lXlpoxhQLuA-R4MqyDDSw/zh-cn_image_0000002625074467.png?HW-CC-KV=V1&HW-CC-Date=20260612T073857Z&HW-CC-Expire=86400&HW-CC-Sign=56618889553041DAF4ED78751EE69AC695A761566EBC4507547FBF11C7729E59)
        
        *   Nothing：只安装不启动任何Ability。
        *   Default Ability：默认的EntryAbility。
            *   Stage模型：module.json5文件中配置了“skills”属性的第一个ability；若无配置“skills”属性的ability，则取“mainElement”指定的ability（该ability需存在于“abilities”数组内）；若“mainElement”未指定，则取“abilities”数组内的第一个ability。
                
                ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/86/v3/dVxEfYWwQKWIs4hHSpOIaQ/zh-cn_image_0000002624994325.png?HW-CC-KV=V1&HW-CC-Date=20260612T073857Z&HW-CC-Expire=86400&HW-CC-Sign=2B50E30DAF25299C43777BDB4F442321D7FC235EBF9B97EBA33FEC3E350377DC "点击放大")
                
            *   FA模型：config.json文件中配置了“skills”属性的第一个ability；若无配置“skills”属性的ability，则取“mainAbility”指定的ability（该ability需存在于“abilities”数组内）；若“mainAbility”未指定，则取“abilities”数组内的第一个ability。
        *   Specified Ability：工程中的UIAbility或ExtensionAbility。
            
            您可以在工程中添加UIAbility或ExtensionAbility，详细请查看[UIAbility开发指导](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/uiability)或[ExtensionAbility开发指导](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/extensionability-overview)。
            
            ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/c6/v3/4tynFZMTSYaAyY6h2FF3Zw/zh-cn_image_0000002624994327.png?HW-CC-KV=V1&HW-CC-Date=20260612T073857Z&HW-CC-Expire=86400&HW-CC-Sign=A45462FEFC7E15715E109234E719287F3F51B5A4BC79807E44E3B2E3142CC8B5)
            
        
    *   Launch Flags：输入aa start命令相关的选项，请参见[aa start 参数](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/aa-tool)。

#### \[h2\]配置环境变量

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

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/5e/v3/RIGTdNEBRoelZ-saafyTiw/zh-cn_image_0000002594474962.png?HW-CC-KV=V1&HW-CC-Date=20260612T073857Z&HW-CC-Expire=86400&HW-CC-Sign=FBF582CB12FE6ECB6BFCBB93BBA6603C15F8244954D8B0C45809C519E849C2DF)

点击![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/f6/v3/_ZRqkAiYSKeLI8j1aMLg-g/zh-cn_image_0000002624994329.png?HW-CC-KV=V1&HW-CC-Date=20260612T073857Z&HW-CC-Expire=86400&HW-CC-Sign=FBE1CBCC0C2AD6015A81E6EF9E0790DEEA63D1E92AE1D3CEFB976C96665CD981)按钮，新增一行配置项。当前支持以下配置项：

*   ASAN\_OPTIONS：在运行时配置ASan的行为，包括设置检测级别、输出格式、内存错误报告的详细程度等，具体可配置的value请参见[配置参数](https://developer.huawei.com/consumer/cn/doc/best-practices/bpta-stability-asan-detection#section1496994494018)。若开发者未配置log\_exe\_name、abort\_on\_error，DevEco Studio将自动填充。ASAN\_OPTIONS是应用级别的，只在entry和feature模块中配置生效，HAR/HSP模块配置不生效。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/2e/v3/3LU4oYlJTEiQEZQfOrh5Lg/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260612T073857Z&HW-CC-Expire=86400&HW-CC-Sign=8B7C331B4B2138D1403A3D250BF35BDD0330D76F49B5275276A3E38854EC0CCD)

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

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

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/7a/v3/PaGXbxFwSMSaOStzFFcihA/zh-cn_image_0000002594634892.png?HW-CC-KV=V1&HW-CC-Date=20260612T073857Z&HW-CC-Expire=86400&HW-CC-Sign=15709DDFA7038FBBD73720B6FBECAB813E643BB03A8ED6C9DFF1940404538B8C)

#### 自动映射WebView调试链接

当应用中含有需要调试的WebView组件页面时，可以通过浏览器的DevTools工具进行页面调试，具体可参考[使用DevTools工具调试前端页面](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/web-debugging-with-devtools)。调试WebView组件需要执行转发端口等繁琐的命令行操作，因此可以在DevEco Studio中勾选**Auto WebView Debug**，该操作会在应用启动后两分钟内自动监听可调试的WebView进程并完成端口转发。

该功能从DevEco Studio 5.0.5 Release版本开始支持。

设置方法如下：

单击**Run** **>** **Edit Configurations**，在**General**中，勾选**Auto WebView Debug**。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/4c/v3/mr70uGQsRHuaYIV3Yt64oA/zh-cn_image_0000002624994335.png?HW-CC-KV=V1&HW-CC-Date=20260612T073857Z&HW-CC-Expire=86400&HW-CC-Sign=A3101ABFED1E0F87BCC01A6A3C63FE3CBBB11B826EFC472C8D8B81E8A7EF03C1)

开启后，当检测到设备上有可调试的WebView组件进程时，会在Run面板中打印转发成功的端口，通过浏览器的DevTools工具连接该端口即可进行WebView调试。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/c6/v3/6yUrAt6SShSU4lo-cCnOOw/zh-cn_image_0000002594474958.png?HW-CC-KV=V1&HW-CC-Date=20260612T073857Z&HW-CC-Expire=86400&HW-CC-Sign=9E80DA8E56517E03D14DFF53C49DE72042936FF179A73398F6BC6E128E740D49)

#### 多模块调试

#### \[h2\]安装多个模块

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

设置方法如下：

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

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/d8/v3/Q6o8ypfoSfmDLIJZZ9-zzA/zh-cn_image_0000002625074471.png?HW-CC-KV=V1&HW-CC-Date=20260612T073857Z&HW-CC-Expire=86400&HW-CC-Sign=274D86EA40A4E77BECF9630806AD81FEA610B887F202ADE6229F48D6BCC3FA73)

#### \[h2\]自动安装依赖

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

设置方法如下：

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

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/8d/v3/lewoyXPTT1Wd4xg4njPP_A/zh-cn_image_0000002624994313.png?HW-CC-KV=V1&HW-CC-Date=20260612T073857Z&HW-CC-Expire=86400&HW-CC-Sign=3B2971D3FC421193FDCE6C8B7FE540E4E0FB8AF1DB39B9C826A89C70FFCD44F6)

在Before launch窗格中，您可以点击![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/6c/v3/Yk9DBulNTJOJWkmnSbcGFg/zh-cn_image_0000002624994321.png?HW-CC-KV=V1&HW-CC-Date=20260612T073857Z&HW-CC-Expire=86400&HW-CC-Sign=68A1C9A9519094FF5B38093DC956519BDB78B9E8EB7A73EA4C1FDF9032D51174)添加应用启动前的任务。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/f3/v3/38dBb8BnQES6gmIDi4RISg/zh-cn_image_0000002594634884.png?HW-CC-KV=V1&HW-CC-Date=20260612T073857Z&HW-CC-Expire=86400&HW-CC-Sign=5757B6EBD2F9601A28F43E1C6F37A6B1F5218374FBB4774A6E7D64403D916611)

也可以点击![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/d0/v3/5lyjrfjCSZeisxphkQOZoQ/zh-cn_image_0000002594634880.png?HW-CC-KV=V1&HW-CC-Date=20260612T073857Z&HW-CC-Expire=86400&HW-CC-Sign=F27194307DD2796D84249338C1AABB16D6C445E9D75C85D104FDE3E1D8B9B94C)移除任务。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/28/v3/AQi8vKU9TDyZY-Y0plhypw/zh-cn_image_0000002594634878.png?HW-CC-KV=V1&HW-CC-Date=20260612T073857Z&HW-CC-Expire=86400&HW-CC-Sign=072071651C48144B37D0D3C949BD7F47A4F8DDDDD36BCFCCA7FFDC6F0D1B1637)

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

#### 多设备运行

从DevEco Studio 6.0.2 Beta1版本开始，支持同时在多个设备上运行应用，包括真机和已启动的模拟器。

1.  在设备选择框中，点击**Select Multiple Devices**，弹出多设备选择框。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/92/v3/aqJJTgaxQaCdDvdnH8EtuA/zh-cn_image_0000002625074463.png?HW-CC-KV=V1&HW-CC-Date=20260612T073857Z&HW-CC-Expire=86400&HW-CC-Sign=A0D062AE918A7AF7C205A49F493256B1AE87700662988B8291D853E55E0E3F88)
    
2.  选择需要推包运行的设备。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/0d/v3/5ZwKSsYBQMChS-BR0J7q5A/zh-cn_image_0000002625074465.png?HW-CC-KV=V1&HW-CC-Date=20260612T073857Z&HW-CC-Expire=86400&HW-CC-Sign=46641F035AD30353C2E66E9D59692C457995A0F6BCA596FF3DE407E8862E73B5)
    
3.  设备栏会出现Multiple Devices(N)，表示选中N个设备，点击运行按钮即可同时在选中设备上运行应用。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/82/v3/nqurWzi_RD26IHF9z1Q8dg/zh-cn_image_0000002624994323.png?HW-CC-KV=V1&HW-CC-Date=20260612T073857Z&HW-CC-Expire=86400&HW-CC-Sign=917D3BA22DE0AFE962B6FBF55069AA4DC143FB0415718BF6EAF500731FBBCBC2)