使用HiCollie监控函数执行时间超长问题（C/C++）
=============================

#### 简介

任务执行超时指要监控的业务代码逻辑执行时长超过业务逻辑预期时间。本文面向开发者介绍HiCollie模块对外提供函数执行时间超长的检测能力。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/05/v3/hzg2lt94Q6OPkkaMvuCJzg/caution_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260612T073458Z&HW-CC-Expire=86400&HW-CC-Sign=D30968F6EF2CDD5F9A4E818C1F2353C3F42501739B59B8E9DDCA847CBBCC2C62)

当开发者通过DevEco Studio的Debug按钮安装并启动应用时，会自动关闭当前工程的超时检测机制。避免调试过程出现超时检测影响开发者调试。

#### 接口说明

| 接口名 | 描述 |
| :-- | :-- |
| OH\_HiCollie\_SetTimer | 
注册定时器，用于检测函数或代码块执行是否超过自定义时间。

结合OH\_HiCollie\_CancelTimer接口配套使用，应在调用耗时的函数之前使用。

说明：从API version 18开始，支持该接口。

 |
| OH\_HiCollie\_CancelTimer | 

取消定时器。

结合OH\_HiCollie\_SetTimer接口配套使用，执行函数或代码块后使用，OH\_HiCollie\_CancelTimer通过id将该任务取消；

若未在自定义时间内取消，则执行回调函数，在特定自定义超时动作下，生成故障日志。

说明：从API version 18开始，支持该接口。

 |

*   API接口的具体使用说明（参数使用限制、具体取值范围等）请参考[HiCollie](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hicollie-h)。
    
*   函数执行时间超长故障日志以syswarning-开头，生成在“设备/data/log/warninglog/”路径下。文件名格式为“syswarning-应用包名-应用UID-秒级时间.log”。
    

#### 开发步骤

下文将展示如何在应用内增加一个按钮，并单击该按钮以调用HiCollie Ndk接口。

1.  新建Native C++工程，目录结构如下：
    
    entry:
      src:
        main:
          cpp:
            types:
              libentry:
                - index.d.ts
            - CMakeLists.txt
            - napi\_init.cpp
          ets:
            entryability:
              - EntryAbility.ts
            pages:
              - Index.ets
    
2.  编辑“CMakeLists.txt”文件，添加源文件及动态库。
    
    \# 依赖动态库libhilog\_ndk.z.so（日志输出），libohhicollie.so（HiCollie对外检测接口）
    target\_link\_libraries(entry PUBLIC libace\_napi.z.so libhilog\_ndk.z.so libohhicollie.so)
    
3.  编辑“napi\_init.cpp”文件，导入依赖头文件、定义LOG\_TAG与测试方法以及注册TestHiCollieTimerNdk为ArkTS接口。
    
    引入头文件及定义LOG\_TAG。
    
    #include "napi/native\_api.h"
    // ...
    #include "hilog/log.h"
    
    #undef LOG\_TAG
    #define LOG\_TAG "testTag"
    
    #include <unistd.h>
    #include "hicollie/hicollie.h"
    
    构造任务执行时间超时场景，并使用OH\_HiCollie\_SetTimer及OH\_HiCollie\_CancelTimer函数进行监控。
    
    // 定义回调函数
    void CallBack(void\*)
    {
        OH\_LOG\_INFO(LogType::LOG\_APP, "HiCollieTimerNdk CallBack");  // 回调函数中打印日志
    }
    
    static napi\_value TestHiCollieTimerNdk(napi\_env env, napi\_callback\_info info)
    {
        int id;
        // 设置HiCollieTimer 参数（Timer任务名，超时时间，回调函数，回调函数参数，超时发生后行为）
        HiCollie\_SetTimerParam param = {"testTimer", 1, CallBack, nullptr, HiCollie\_Flag::HICOLLIE\_FLAG\_LOG};
        HiCollie\_ErrorCode errorCode = OH\_HiCollie\_SetTimer(param, &id);  // 注册HiCollieTimer函数执行时长超时检测一次性任务
        if (errorCode == HICOLLIE\_SUCCESS) {  // HiCollieTimer任务注册成功
            OH\_LOG\_INFO(LogType::LOG\_APP, "HiCollieTimer taskId: %{public}d", id); // 打印任务id
            sleep(2);  // 模拟执行耗时函数，在这里简单的将线程阻塞2s
            OH\_HiCollie\_CancelTimer(id);  // 根据id取消已注册任务
        }
        return nullptr;
    }
    
    在Init函数中的desc\[\]数组中将TestHiCollieTimerNdk注册为ArkTS接口。
    
    // 将TestHiCollieTimerNdk注册为ArkTS接口
    { "TestHiCollieTimerNdk", nullptr, TestHiCollieTimerNdk, nullptr, nullptr, nullptr, napi\_default, nullptr },
    
4.  编辑“index.d.ts”文件，定义ArkTS接口。
    
    export const TestHiCollieTimerNdk: () => void;
    
5.  编辑“Index.ets”文件。
    
    引入调用C接口的头文件。
    
    import testNapi from 'libentry.so';
    
    在Index页面新增触发TestHiCollieTimerNdk方法的按钮。
    
    // 添加点击事件，触发TestHiCollieTimerNdk方法。
    Button('TestHiCollieTimerNdk')
      .type(ButtonType.Capsule)
      .margin({
        top: 20
      })
      .backgroundColor('#0D9FFB')
      .width('80%')
      .height('5%')
      .onClick(() => {
        testNapi.TestHiCollieTimerNdk();
      })
    
6.  点击DevEco Studio界面中的运行按钮，运行应用工程。
    
7.  在DevEco Studio的底部，切换到“Log->HiLog”窗口，设置日志的过滤条件为“testTag”。
    
    （1）点击“TestHiCollieTimerNdk”按钮执行程序，日志窗口打印任务id。
    
    .../testTag ... HiCollieTimer taskId: x
    
    （2）等待2s后，执行回调函数，日志窗口打印。
    
    .../testTag ... HiCollieTimerNdk CallBack
    
    获取故障文件信息相关内容可参考[订阅任务执行超时事件（C/C++）](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/hiappevent-watcher-apphicollie-events-ndk) 订阅获取。