目录

使用HWASan检测内存错误

HWASan（Hardware-Assisted Address Sanitizer）是一款类似于ASan的内存错误检测工具。与ASan相比，HWASan使用的内存减少很多，因而更适合用于整个系统的检测。关于HWASan的检测原理请参考HWASan检测原理。

在适配过程中，若遇到应用崩溃等问题，可参考适配常见问题。

使用约束

HWASan检测仅适用于AArch64架构的硬件。
ASan、TSan、UBSan、HWASan不能同时开启，只能开启其中一个。

开启HWASan

DevEco Studio 6.1.0 Beta1之前的版本，仅支持对C++源码开启HWASan。

从DevEco Studio 6.1.0 Beta1版本开始，同时支持对C++编译生成的无源码so文件进行二进制插桩，进而开启HWASan功能。

[h2]方式一

点击Run > Edit Configurations > Diagnostics，勾选Hardware-Assisted Address Sanitizer开启C++源码检测插桩。
从DevEco Studio 6.1.0 Beta1版本开始，可以同时勾选BinXO check，开启无源码的so文件的HWASan检测插桩。
（可选）如果部分无源码so不需要进行HWASan检测插桩，可以在工程级或模块级build-profile.json5文件中，配置excludeSoFromBinXO字段，填写需要忽略的so列表，支持正则匹配。
```
"buildOption": {
  "nativeLib": {
    "excludeSoFromBinXO": ["**/liblibrary.so"]
  }
}
```

[h2]方式二

修改工程目录下的AppScope/app.json5文件，添加HWASan配置开关。
```
"hwasanEnabled": true
```

在需要开启HWASan的模块级build-profile.json5中，添加构建参数开启HWASan检测插桩。

// DevEco Studio 6.1.0 Beta1以下版本
"buildOption": {
  "externalNativeOptions": {
    "arguments": ["-DOHOS_ENABLE_HWASAN=ON"]
  }
}
// DevEco Studio 6.1.0 Beta1及以上版本，同时开启有源码和无源码的C++的HWASan检测插桩
"buildOption": {
  "externalNativeOptions": {
    "arguments": ["-DOHOS_ENABLE_HWASAN=ON", "-DOHOS_ENABLE_BINXO=ON"]
  }
}

如果部分无源码so不需要进行HWASan检测插桩，可以在工程级或模块级build-profile.json5文件中，配置excludeSoFromBinXO字段，填写需要忽略的so列表，支持正则匹配。
```
"buildOption": {
  "nativeLib": {
    "excludeSoFromBinXO": ["**/liblibrary.so"]
  }
}
```

使用HWASan

运行或调试当前应用。
当程序出现内存错误时，弹出HWASan log信息，点击信息中的链接即可跳转至引起内存错误的代码处。日志中各字段的说明请参考HWASan日志规格，异常检测类型请参考HWASan异常检测类型。
从26.0.0版本开始，支持解析错误堆栈对应的伪代码、方法入参及变量的名称、值。仅解析前三行堆栈（#0~#2），其中#0行会解析入参、变量的名称和值，另外两行（#1、#2）仅解析入参和变量名称。

为确保正确解析堆栈，需保留代码中的调试信息，具体请参考注意事项。
如果是release应用，本地无工程代码，可以使用AnalyzeStackTrace功能，提供要解析堆栈的so，解析结果为源码地址。

注意事项

为确保正确解析堆栈，需保留代码中的调试信息，请遵循以下配置。

引用har包时，需在har的build-profile.json5中配置strip参数为false。
```
"nativeLib": {
  "debugSymbol": {
    "strip": false
  }
}
```

编译优化可能会清除代码中的调试信息，请在CMakeLists.txt文件中配置关闭编译优化选项的参数。

set_source_files_properties(
    filename.cpp
    PROPERTIES COMPILE_FLAGS "-O0"
)
string(REPLACE "-O2" "-O0"
    CMAKE_CXX_FLAGS_RELEASE
    "${CMAKE_CXX_FLAGS_RELEASE}"
)
string(REPLACE "-O2" "-O0"
    CMAKE_C_FLAGS_RELEASE
    "${CMAKE_C_FLAGS_RELEASE}"
)