attach启动调试
==========

开发者也可以通过将调试程序attach到已运行的应用进行调试。

Attach Debugger和Debug的区别在于，Attach Debugger to Process可以先运行应用/元服务，然后再启动调试，或者直接启动设备上已安装的应用/元服务进行调试；而Debug是直接运行应用/元服务后立即启动调试。

#### 前提条件

当前设备上被attach的应用代码和本地代码一致，且已提前进行构建生成必要的sourceMap文件。

#### 使用约束

attach不支持的场景：

*   本地无源码。
*   bundleName不匹配，将出现提示“The selected process does not match the bundlename of the current project!”，但不阻塞调试过程。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/7d/v3/leBJ0uaQT3KlS3V9JdasYQ/zh-cn_image_0000002624994311.png?HW-CC-KV=V1&HW-CC-Date=20260612T073858Z&HW-CC-Expire=86400&HW-CC-Sign=A1FD5B924CDBF2E8AD8850D43F43F42EE014C5DD6303881E06BFF6379A67D2FA)
    

#### 操作步骤

1.  在工具栏中，选择调试的设备，并单击**Attach Debugger to Process**![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/2b/v3/iAuiCGrLRj2SCmgDwhPDkg/zh-cn_image_0000002594634872.png?HW-CC-KV=V1&HW-CC-Date=20260612T073858Z&HW-CC-Expire=86400&HW-CC-Sign=91175AC795B148E16C72075F215FCB7377AC46D65748F72042177CFFB8A9BDDD)启动调试。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/ee/v3/qpD6rpBFR_C1B5pi_p9ncQ/zh-cn_image_0000002625074451.png?HW-CC-KV=V1&HW-CC-Date=20260612T073858Z&HW-CC-Expire=86400&HW-CC-Sign=DDF651B49AF58E8D844B204CD9E39B99067890BD26C865E43C0E219E17F45C15)
    
2.  选择要调试的应用进程，若应用bundleName与当前工程不一致，则需勾选Show all process。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/82/v3/p6VuBtu-SrecCqA6xIPSRQ/zh-cn_image_0000002625074453.png?HW-CC-KV=V1&HW-CC-Date=20260612T073858Z&HW-CC-Expire=86400&HW-CC-Sign=0FA8D6412F85CA2BDB71A7D51774AD031286424890A55EA34F06F066953AD31D)
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/37/v3/TO24vK5cRCGuGByNmEOaCA/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260612T073858Z&HW-CC-Expire=86400&HW-CC-Sign=1BB176D6E35F5E96EF0A74227863C56511335FDE0CF604BD295F35471C70FA34)
    
    正常情况下，attach调试仅支持debug签名的应用，从DevEco Studio 6.0.2 Beta1版本开始，PC/2in1上的应用，如果使用了release签名并且配置了ohos.permission.kernel.ALLOW\_DEBUG权限，也支持被attach调试。
    
3.  选择需要使用的调试配置，或者使用默认配置。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/b7/v3/gctvEMJiQES_fXSwP1V0Vw/zh-cn_image_0000002594634868.png?HW-CC-KV=V1&HW-CC-Date=20260612T073858Z&HW-CC-Expire=86400&HW-CC-Sign=8306AF80BCE5F4F031088BA02F2D6F29A933A28C1A11945226828F1B458C7F39)
    
4.  选择需要调试的Debug type，若选择已创建的Run/Debug configuration进行attach调试，此时Debug type不可改变，只可在Run/Debug configuration界面修改。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/e1/v3/1N5WMnLmTA2ikZnI2np5Fw/zh-cn_image_0000002625074447.png?HW-CC-KV=V1&HW-CC-Date=20260612T073858Z&HW-CC-Expire=86400&HW-CC-Sign=23960E231BADBAE81CE303FBE97471CEB566BA8EEAFA679855157B1173AA8059)
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/99/v3/YC1Ca76xTrimu7Cfqob5DQ/zh-cn_image_0000002594474948.png?HW-CC-KV=V1&HW-CC-Date=20260612T073858Z&HW-CC-Expire=86400&HW-CC-Sign=A634D4BCE387D7EDBC934B02130C52E064AEB6C8D81C1D9C10E82078840E8FA7)
    
5.  点击**OK**开始attach调试。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/91/v3/wxLxM3UdRrSpnQiYhO_Eug/zh-cn_image_0000002625074449.png?HW-CC-KV=V1&HW-CC-Date=20260612T073858Z&HW-CC-Expire=86400&HW-CC-Sign=78866A35634093C1F3ED0CC6A65C2DA1343182C0E05C62985879B39A77CA6C94)