点击Run > Edit Configurations > Debugger > Symbol Directories页签，点击+，添加带调试信息的so文件，so文件在{ProjectPath}/{ModuleName}/build/{product}/intermediates/libs/default/arm64-v8a路径下。

在工程级或模块级build-profile.json5中添加strip字段并设置为false，可以生成带调试信息的so文件，具体请参考配置CPP。
DevEco Studio调试应用时会优先加载配置的so文件，本地so文件包含调试信息时，可以正常调试源码。由于so的源码文件信息为编译时的文件路径，若与本地的源码文件路径不一致时，需要关联源码文件，有两种方式：
- 方式一：可以在LLDB Startup Commands页签中添加命令做映射，示例如下。
```
settings set -- target.source-map {old-path} {new-path}
```
  - old-path：编译时的文件路径。
  - new-path：本地的源码文件路径。
- 方式二：当Step Into进入汇编代码后，会弹出源码关联的提示，请点击Select file，选择本地对应C++源码进行关联。

[h2]ArkTS代码调试

假如在工程A（HAR包工程）中以debug模式编译得到字节码HAR包，工程B（主工程）中引用该字节码HAR包，并且本地有HAR包的源码，要调试该字节码HAR，有两种方式：在主工程中调试或在HAR包工程中调试。

release模式编译的字节码HAR不支持调试。

方式一：在主工程中调试。
1. 在主工程中导入字节码HAR对应的模块，确保模块的层级目录与HAR包工程的保持一致，例如HAR模块都在工程根目录下。
2. 导入成功后，由于debug模式编译的字节码HAR中包含sourceMap，调试时默认会关联当前工程的源码，此时可以在HAR模块上直接添加断点。
方式二：在HAR包工程中调试，通过修改前缀配置进行attach调试。
1. 在HAR包工程新建一个entry类型的demo主模块，如果主模块已存在则跳过本步骤。
2. 在demo主模块的oh-package.json5中配置对字节码HAR包的依赖。
```
// demo主模块的oh-package.json5
"dependencies": {
  "@ohos/test_stage_ets_library": "file:./lib/test_stage_ets_library.har",
}
```
  如果在demo主模块的oh-package.json5中，配置对字节码HAR模块的依赖，如file:../test_stage_ets_library，调试时可能导致断点无效。
3. 在HAR包工程主模块中调用HAR模块的接口，确保编译后主模块的sourceMap文件中包含HAR模块的相关信息。
4. 构建HAR包工程，打开主模块的sourceMap，根据HAR的oh-package.json5中的name进行查找，将Index文件的前缀路径记录为localUrl，例如以下的demo|test_stage_ets_library|1.0.0。
5. 主工程应用在设备上运行起来后，在HAR包工程中通过attach方式对该应用进行调试，在Debug窗口获取程序加载时的前缀，记录为remoteUrl，例如以下的entry|@ohos/test_stage_ets_library|1.0.0。
6. 点击Run > Edit Configurations > Debugger > ArkTS Source Pairs，点击+，填写前两个步骤获取到的remoteUrl和localUrl。
  - remoteUrl：应用程序加载HAR包的前缀路径。
  - localUrl：本地生成sourceMap中HAR的前缀路径。
7. 在HAR包工程中重新通过attach方式对主工程应用进行调试，此时可以在HAR模块上添加断点进行调试。
如果在HAR包工程中同时配置Symbol Directories和ArkTS Source Pairs，可同时attach调试ArkTS和C++断点。

源码HAR调试

[h2]C++代码调试

如果HAP/HSP引用源码HAR包，同时HAR包中包含C++代码，可参考字节码HAR进行调试。

[h2]ArkTS代码调试

工程中引用源码HAR包，对该HAR包进行调试，根据本地是否有源码，调试方式分别如下：

如果HAR包在本地没有对应源码，此时应用构建打包时引用的源码来源是工程级oh_modules目录下的源码，只能针对oh_modules下的源码进行调试。
如果HAR包在本地有对应源码，调试时可关联本地源码以实现对源码的调试，有两种方式。
- 方式一：参考字节码HAR调试。
- 方式二：当Step Into进入oh_modules中的ets代码后，会弹出源码关联的提示时，请点击Choose Sources，选择本地对应ets源码进行关联。

HSP源码调试

如果要调试HSP源码，需要将源码置于本地工程模块下，参考字节码HAR的方式一进行调试。

目录

三方库源码调试

区分字节码HAR和源码HAR

字节码HAR调试

[h2]C++代码调试

[h2]ArkTS代码调试

源码HAR调试

[h2]C++代码调试

[h2]ArkTS代码调试

HSP源码调试