鸿蒙开辟进阶（HarmonyOS）订阅踩内存变乱场景（C/C++） ...

 鸿蒙NEXT开辟实战往期必看文章：
一分钟相识”纯血版！鸿蒙HarmonyOS Next应用开辟！
“非常详细的” 鸿蒙HarmonyOS Next应用开辟学习门路！（从零基础入门到精通）
HarmonyOS NEXT应用开辟案例实践总结合（持续更新......）
HarmonyOS NEXT应用开辟性能优化实践总结（持续更新......）

---

踩内存变乱先容

HiAppEvent提供接口用于订阅体系踩内存变乱。

• 订阅踩内存变乱（ArkTS）
  
• 订阅踩内存变乱（C/C++）
  

踩内存变乱信息中params属性的详细形貌如下：
params属性：
名称类型阐明timenumber变乱触发时间，单元为毫秒。bundle_versionstring应用版本。bundle_namestring应用名称。pidnumber应用的进程id。uidnumber应用的用户id。typestring地址越界错误类型，取值范围详见type属性。external_logstring[]故障日记文件路径。为制止目次空间超限（限制参考log_over_limit），导致新生成的日记文件写入失败，日记文件处理完后请及时删除。log_over_limitboolean生成的故障日记文件与已存在的日记文件总大小是否凌驾5M上限。true表示凌驾上限，日记写入失败；false表示未凌驾上限。 type属性：
取值阐明alloc-dealloc-mismatch内存分配和释放方式不匹配。allocation-size-too-big当分配对堆来说太大时发现的错误。calloc-overflowcalloc分配内存错误。container-overflow容器溢出。double-free释放已释放的内存。dynamic-stack-buffer-overflow缓冲区访问超出堆栈分配对象的边界。global-buffer-overflow全局缓冲区溢出。heap-buffer-overflow堆缓冲区溢出。heap-use-after-free使用已释放的堆内存。invalid-allocation-alignment无效的内存分配对齐方式。memcpy-param-overlapmemcpy不支持重叠内存。new-delete-type-mismatch内存释放大小与分配大小不一致。stack-buffer-overflow堆栈缓冲区溢出。stack-buffer-underflow堆栈缓冲区下溢。stack-use-after-return在返回后使用堆栈内存。stack-use-after-scope使用超出范围的堆栈内存。strcat-param-overlap在重叠缓冲区中移动内存导致的错误。use-after-poison使用已中毒的内存。 接口阐明

API接口的具体使用阐明（参数使用限制、具体取值范围等）请参考HiAppEvent。
订阅接口功能先容：
接口名形貌int OH_HiAppEvent_AddWatcher (HiAppEvent_Watcher *watcher)添加应用变乱观察者，以添加对应用变乱的订阅。int OH_HiAppEvent_RemoveWatcher (HiAppEvent_Watcher *watcher)移除应用变乱观察者，以移除对应用变乱的订阅。 开辟步骤

以实现对写数组越界场景生成的踩内存变乱订阅为例，阐明开辟步骤。

• 新建Native C++工程，并将jsoncpp导入到新建工程内，目次布局如下：
  
  1. entry:
  2.   src:
  3.     main:
  4.       cpp:
  5.         - json:
  6.             - json.h
  7.             - json-forwards.h
  8.         - types:
  9.             libentry:
  10.               - index.d.ts
  11.         - CMakeLists.txt
  12.         - napi_init.cpp
  13.         - jsoncpp.cpp
  14.       ets:
  15.         - entryability:
  16.             - EntryAbility.ets
  17.         - pages:
  18.             - Index.ets
  19. <strong>yml</strong>

  复制代码
• 编辑"CMakeLists.txt"文件，添加源文件及动态库：
  
  1. # 新增jsoncpp.cpp(解析订阅事件中的json字符串)源文件
  2. add_library(entry SHARED napi_init.cpp jsoncpp.cpp)
  3. # 新增动态库依赖libhiappevent_ndk.z.so和libhilog_ndk.z.so(日志输出)
  4. target_link_libraries(entry PUBLIC libace_napi.z.so libhilog_ndk.z.so libhiappevent_ndk.z.so)
  5. <strong>cmake</strong>

  复制代码
• 编辑"napi_init.cpp"文件，导入依赖的文件，并界说LOG_TAG：
  
  1. #include "napi/native_api.h"
  2. #include "json/json.h"
  3. #include "hilog/log.h"
  4. #include "hiappevent/hiappevent.h"
  6. #undef LOG_TAG
  7. #define LOG_TAG "testTag"
  8. <strong>c++</strong>

  复制代码
• 订阅体系变乱：
  
  
  
  • onReceive类型观察者：
    编辑"napi_init.cpp"文件，界说onReceive类型观察者干系方法：
    
    1. //定义一变量，用来缓存创建的观察者的指针。
    2. static HiAppEvent_Watcher *systemEventWatcher;
    4. static void OnReceive(const char *domain, const struct HiAppEvent_AppEventGroup *appEventGroups, uint32_t groupLen) {
    5.     for (int i = 0; i < groupLen; ++i) {
    6.         for (int j = 0; j < appEventGroups[i].infoLen; ++j) {
    7.             OH_LOG_INFO(LogType::LOG_APP, "HiAppEvent eventInfo.domain=%{public}s", appEventGroups[i].appEventInfos[j].domain);
    8.             OH_LOG_INFO(LogType::LOG_APP, "HiAppEvent eventInfo.name=%{public}s", appEventGroups[i].appEventInfos[j].name);
    9.             OH_LOG_INFO(LogType::LOG_APP, "HiAppEvent eventInfo.eventType=%{public}d", appEventGroups[i].appEventInfos[j].type);
    10.             if (strcmp(appEventGroups[i].appEventInfos[j].domain, DOMAIN_OS) == 0 &&
    11.                 strcmp(appEventGroups[i].appEventInfos[j].name, EVENT_ADDRESS_SANITIZER) == 0) {
    12.                 Json::Value params;
    13.                 Json::Reader reader(Json::Features::strictMode());
    14.                 Json::FastWriter writer;
    15.                 if (reader.parse(appEventGroups[i].appEventInfos[j].params, params)) {
    16.                     auto time = params["time"].asInt64();
    17.                     auto bundleVersion = params["bundle_version"].asString();
    18.                     auto bundleName = params["bundle_name"].asString();
    19.                     auto pid = params["pid"].asInt();
    20.                     auto uid = params["uid"].asInt();
    21.                     auto type = params["type"].asString();
    22.                     auto boolFlag = params["log_over_limit"].asBool();
    23.                     std::string logOverLimit = params["log_over_limit"].asBool() ? "true" : "false";
    24.                     auto externalLog = writer.write(params["external_log"]);
    25.                     OH_LOG_INFO(LogType::LOG_APP, "HiAppEvent eventInfo.params.time=%{public}lld", time);
    26.                     OH_LOG_INFO(LogType::LOG_APP, "HiAppEvent eventInfo.params.bundle_version=%{public}s", bundleVersion.c_str());
    27.                     OH_LOG_INFO(LogType::LOG_APP, "HiAppEvent eventInfo.params.bundle_name=%{public}s", bundleName.c_str());
    28.                     OH_LOG_INFO(LogType::LOG_APP, "HiAppEvent eventInfo.params.pid=%{public}d", pid);
    29.                     OH_LOG_INFO(LogType::LOG_APP, "HiAppEvent eventInfo.params.uid=%{public}d", uid);
    30.                     OH_LOG_INFO(LogType::LOG_APP, "HiAppEvent eventInfo.params.type=%{public}s", type.c_str());
    31.                     OH_LOG_INFO(LogType::LOG_APP, "HiAppEvent eventInfo.params.external_log=%{public}s", externalLog.c_str());
    32.                     OH_LOG_INFO(LogType::LOG_APP, "HiAppEvent eventInfo.params.log_over_limit=%{public}s", logOverLimit.c_str());
    33.                 }
    34.             }
    35.         }
    36.     }
    37. }
    39. static napi_value RegisterWatcher(napi_env env, napi_callback_info info) {
    40.     // 开发者自定义观察者名称，系统根据不同的名称来识别不同的观察者。
    41.     systemEventWatcher = OH_HiAppEvent_CreateWatcher("onReceiverWatcher");
    42.     // 设置订阅的事件为EVENT_ADDRESS_SANITIZER。
    43.     const char *names[] = {EVENT_ADDRESS_SANITIZER};
    44.     // 开发者订阅感兴趣的事件，此处订阅了系统事件。
    45.     OH_HiAppEvent_SetAppEventFilter(systemEventWatcher, DOMAIN_OS, 0, names, 1);
    46.     // 开发者设置已实现的回调函数，观察者接收到事件后回立即触发OnReceive回调。
    47.     OH_HiAppEvent_SetWatcherOnReceive(systemEventWatcher, OnReceive);
    48.     // 使观察者开始监听订阅的事件。
    49.     OH_HiAppEvent_AddWatcher(systemEventWatcher);
    50.     return {};
    51. }
    52. <strong>c++</strong>

    复制代码
  • onTrigger类型观察者：
    编辑"napi_init.cpp"文件，界说OnTrigger类型观察者干系方法：
    
    1. //定义一变量，用来缓存创建的观察者的指针。
    2. static HiAppEvent_Watcher *systemEventWatcher;
    4. // 开发者可以自行实现获取已监听到事件的回调函数，其中events指针指向内容仅在该函数内有效。
    5. static void OnTake(const char *const *events, uint32_t eventLen) {
    6.     Json::Reader reader(Json::Features::strictMode());
    7.     Json::FastWriter writer;
    8.     for (int i = 0; i < eventLen; ++i) {
    9.         Json::Value eventInfo;
    10.         if (reader.parse(events[i], eventInfo)) {
    11.             auto domain =  eventInfo["domain_"].asString();
    12.             auto name = eventInfo["name_"].asString();
    13.             auto type = eventInfo["type_"].asInt();
    14.             OH_LOG_INFO(LogType::LOG_APP, "HiAppEvent eventInfo.domain=%{public}s", domain.c_str());
    15.             OH_LOG_INFO(LogType::LOG_APP, "HiAppEvent eventInfo.name=%{public}s", name.c_str());
    16.             OH_LOG_INFO(LogType::LOG_APP, "HiAppEvent eventInfo.eventType=%{public}d", type);
    17.             if (domain ==  DOMAIN_OS && name == EVENT_ADDRESS_SANITIZER) {
    18.                 auto time = eventInfo["time"].asInt64();
    19.                 auto bundleVersion = eventInfo["bundle_version"].asString();
    20.                 auto bundleName = eventInfo["bundle_name"].asString();
    21.                 auto pid = eventInfo["pid"].asInt();
    22.                 auto uid = eventInfo["uid"].asInt();
    23.                 auto asanType = eventInfo["type"].asString();
    24.                 auto externalLog = writer.write(eventInfo["external_log"]);
    25.                 std::string logOverLimit = eventInfo["log_over_limit"].asBool() ? "true" : "false";
    26.                 OH_LOG_INFO(LogType::LOG_APP, "HiAppEvent eventInfo.params.time=%{public}lld", time);
    27.                 OH_LOG_INFO(LogType::LOG_APP, "HiAppEvent eventInfo.params.bundle_version=%{public}s", bundleVersion.c_str());
    28.                 OH_LOG_INFO(LogType::LOG_APP, "HiAppEvent eventInfo.params.bundle_name=%{public}s", bundleName.c_str());
    29.                 OH_LOG_INFO(LogType::LOG_APP, "HiAppEvent eventInfo.params.pid=%{public}d", pid);
    30.                 OH_LOG_INFO(LogType::LOG_APP, "HiAppEvent eventInfo.params.uid=%{public}d", uid);
    31.                 OH_LOG_INFO(LogType::LOG_APP, "HiAppEvent eventInfo.params.crash_type=%{public}s", asanType.c_str());
    32.                 OH_LOG_INFO(LogType::LOG_APP, "HiAppEvent eventInfo.params.external_log=%{public}s", externalLog.c_str());
    33.                 OH_LOG_INFO(LogType::LOG_APP, "HiAppEvent eventInfo.params.log_over_limit=%{public}s", logOverLimit.c_str());
    34.             }
    35.         }
    36.     }
    37. }
    39. // 开发者可以自行实现订阅回调函数，以便对获取到的事件打点数据进行自定义处理。
    40. static void OnTrigger(int row, int size) {
    41.     // 接收回调后，获取指定数量的已接收事件。
    42.     OH_HiAppEvent_TakeWatcherData(systemEventWatcher, row, OnTake);
    43. }
    45. static napi_value RegisterWatcher(napi_env env, napi_callback_info info) {
    46.     // 开发者自定义观察者名称，系统根据不同的名称来识别不同的观察者。
    47.     systemEventWatcher = OH_HiAppEvent_CreateWatcher("onTriggerWatcher");
    48.     // 设置订阅的事件为EVENT_ADDRESS_SANITIZER。
    49.     const char *names[] = {EVENT_ADDRESS_SANITIZER};
    50.     // 开发者订阅感兴趣的事件，此处订阅了系统事件。
    51.     OH_HiAppEvent_SetAppEventFilter(systemEventWatcher, DOMAIN_OS, 0, names, 1);
    52.     // 开发者设置已实现的回调函数，需OH_HiAppEvent_SetTriggerCondition设置的条件满足方可触发。
    53.     OH_HiAppEvent_SetWatcherOnTrigger(systemEventWatcher, OnTrigger);
    54.     // 开发者可以设置订阅触发回调的条件，此处是设置新增事件打点数量为1个时，触发onTrigger回调。
    55.     OH_HiAppEvent_SetTriggerCondition(systemEventWatcher, 1, 0, 0);
    56.     // 使观察者开始监听订阅的事件。
    57.     OH_HiAppEvent_AddWatcher(systemEventWatcher);
    58.     return {};
    59. }
    60. <strong>c++</strong>

    复制代码
  
  
• 构造地址越界错误：
  编辑"napi_init.cpp"文件，界说Test方法, 方法中对一个整数数组进行越界访问：
  
  1. static napi_value Test(napi_env env, napi_callback_info info)
  2. {
  3.     int a[10];
  4.     a[10] = 1;
  5.     return {};
  6. }
  7. <strong>c++</strong>

  复制代码
• 将RegisterWatcher和Test注册为ArkTS接口：
  编辑"napi_init.cpp"文件，将RegisterWatcher和Test注册为ArkTS接口：
  
  1. static napi_value Init(napi_env env, napi_value exports)
  2. {
  3.     napi_property_descriptor desc[] = {
  4.         { "registerWatcher", nullptr, RegisterWatcher, nullptr, nullptr, nullptr, napi_default, nullptr },
  5.         { "test", nullptr, Test, nullptr, nullptr, nullptr, napi_default, nullptr}
  6.     };
  7.     napi_define_properties(env, exports, sizeof(desc) / sizeof(desc[0]), desc);
  8.     return exports;
  9. }
  10. <strong>c++</strong>

  复制代码
  编辑"index.d.ts"文件，界说ArkTS接口：
  
  1. export const registerWatcher: () => void;
  2. export const test: () => void;
  3. <strong>typescript</strong>

  复制代码
• 编辑"EntryAbility.ets"文件，在onCreate()函数中新增接口调用：
  
  1. // 导入依赖模块
  2. import testNapi from 'libentry.so'
  4. // 在onCreate()函数中新增接口调用
  5. // 启动时，注册系统事件观察者
  6. testNapi.registerWatcher();
  7. <strong>typescript</strong>

  复制代码
• 编辑“entry > src > main > ets > pages > Index.ets”文件，新增按钮触发踩内存变乱：
  
  1. import testNapi from 'libentry.so'
  3. @Entry
  4. @Component
  5. struct Index {
  6.   build() {
  7.     Row() {
  8.       Column() {
  9.         Button("address-sanitizer").onClick(() => {
  10.           testNapi.test();
  11.         })
  12.       }
  13.       .width('100%')
  14.     }
  15.     .height('100%')
  16.   }
  17. }
  18. <strong>ts</strong>

  复制代码
• 点击IDE界面中的“entry”，点击“Edit Configurations”，点击“Diagnostics”，勾选“Address Sanitizer”，保存设置。点击IDE界面中的运行按钮，运行应用工程，然后在应用界面中点击按钮“address-sanitizer”，触发一次踩内存变乱。应用瓦解后重新进入应用，可以在Log窗口看到对体系变乱数据的处理日记：
  
  1. HiAppEvent eventInfo.domain=OS
  2. HiAppEvent eventInfo.name=ADDRESS_SANITIZER
  3. HiAppEvent eventInfo.eventType=1
  4. HiAppEvent eventInfo.params.time=1713148093326
  5. HiAppEvent eventInfo.params.bundle_version=1.0.0
  6. HiAppEvent eventInfo.params.bundle_name=com.example.myapplication
  7. HiAppEvent eventInfo.params.pid=3378
  8. HiAppEvent eventInfo.params.uid=20020140
  9. HiAppEvent eventInfo.params.type="stack-buffer-overflow"
  10. HiAppEvent eventInfo.params.external_log=["/data/storage/el2/log/hiappevent/ADDRESS_SANITIZER_1713148093326_3378.log"]
  11. HiAppEvent eventInfo.params.log_over_limit=false
  12. <strong>text</strong>

  复制代码
• 移除变乱观察者：
  
  1. static napi_value RemoveWatcher(napi_env env, napi_callback_info info) {
  2.     // 使观察者停止监听事件
  3.     OH_HiAppEvent_RemoveWatcher(systemEventWatcher);
  4.     return {};
  5. }
  6. <strong>c++</strong>

  复制代码
• 烧毁变乱观察者：
  
  1. static napi_value DestroyWatcher(napi_env env, napi_callback_info info) {
  2.     // 销毁创建的观察者，并置systemEventWatcher为nullptr。
  3.     OH_HiAppEvent_DestroyWatcher(systemEventWatcher);
  4.     systemEventWatcher = nullptr;
  5.     return {};
  6. }

  复制代码

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。