跳到主要内容

获取Native子进程退出信息

场景介绍

从API version 20开始,支持父进程通过注册回调函数监听子进程,获取子进程异常退出信息,以便父进程做后续优化处理。这里支持监听的子进程必须为OH_Ability_StartNativeChildProcessOH_Ability_StartNativeChildProcessWithConfigsstartNativeChildProcess接口创建的子进程。

接口说明

名称描述
Ability_NativeChildProcess_ErrCode OH_Ability_RegisterNativeChildProcessExitCallback (OH_Ability_OnNativeChildProcessExit onProcessExit)注册子进程退出回调函数。
Ability_NativeChildProcess_ErrCode OH_Ability_UnregisterNativeChildProcessExitCallback (OH_Ability_OnNativeChildProcessExit onProcessExit)解注册子进程退出回调函数。

开发步骤

动态库文件

libchild_process.so

头文件

#include <AbilityKit/native_child_process.h>
  1. 主进程-注册和解注册Native子进程异常退出回调。

    调用OH_Ability_RegisterNativeChildProcessExitCallback注册Native子进程,如果返回值为NCP_NO_ERROR表示注册成功。

    调用OH_Ability_UnregisterNativeChildProcessExitCallback解注册Native子进程,如果返回值为NCP_NO_ERROR表示解注册成功。

    #include <AbilityKit/native_child_process.h>
    #include <hilog/log.h>

    // ···

    void OnNativeChildProcessExit(int32_t pid, int32_t signal)
    {
    OH_LOG_INFO(LOG_APP, "pid: %{public}d, signal: %{public}d", pid, signal);
    }

    void RegisterNativeChildProcessExitCallback()
    {
    Ability_NativeChildProcess_ErrCode ret =
    OH_Ability_RegisterNativeChildProcessExitCallback(OnNativeChildProcessExit);
    if (ret != NCP_NO_ERROR) {
    OH_LOG_ERROR(LOG_APP, "register failed.");
    }
    // ···
    }

    void UnregisterNativeChildProcessExitCallback()
    {
    Ability_NativeChildProcess_ErrCode ret =
    OH_Ability_UnregisterNativeChildProcessExitCallback(OnNativeChildProcessExit);
    if (ret != NCP_NO_ERROR) {
    OH_LOG_ERROR(LOG_APP, "unregister failed.");
    }
    // ···
    }
  2. 主进程-添加编译依赖项。

    修改CMaklist.txt添加必要的依赖库,假设主进程所在的so名称为libmainprocesssample.so(主进程和子进程的实现也可以选择编译到同一个动态库文件)。

    target_link_libraries(mainprocesssample PUBLIC
    # 添加依赖的元能力动态库
    libchild_process.so

    # 其它依赖的动态库
    # ...
    )