【入门到实战】OpenHarmony南向子系统开发：插件_bootchart-master.tar 下载-优快云博客

往期鸿蒙5.0全套实战文章必看：（文中附带全栈鸿蒙5.0学习资料）

插件

概述

基本概念

begetctl介绍
bootchart 插件

bootchart是一个用于linux启动过程性能分析的开源工具软件，在系统中自动收集CPU占用率、磁盘吞吐率、进程等信息，并以图形方式显示分析结果，可用作指导优化系统启动过程。
bootevent 插件

bootevent是一个记录init进程及各个服务的启动关键事件的插件，记录内容包括事件名称，关联事件的服务的启动时间，事件发生时间。导出文件支持tracing解析，可用作指导优化系统启动过程。

约束与限制

bootchart和bootevent只支持标准系统， begetctl 支持小型系统和标准系统。

开发指导

参数说明

表1 begetctl 命令说明

命令	说明	格式和示例
init group test [stage]	init moduletest 测试用	stage参见ServiceStatus
param ls [-r] [name]	显示系统参数dac和selinux信息 -r：展示所有参数信息 name：展示指定参数信息	begetctl param ls xxx.xxx 或 param ls xxx.xxx 例如： begetctl param ls persist.sys.usb
param get [name]	获取系参数统值	begetctl param get xxxx.xxx 或 param get xxxx.xxx 例如： param get const.product.name
param set name value	设置系统参数值	begetctl param set xxxx.xxx value 或 param set xxxx.xxx value 例如： begetctl param set ohos.servicectrl.display 1
param wait name [value] [timeout]	等待参数被设置成某值 timeout默认值：30秒	begetctl param wait xxx.xxx value 或 wait xxx.xxx value 例如： param wait xx.sss 1
param dump [verbose]	dump 系统参数信息	begetctl param dump 或 param dump
param shell [name]	进入Parameter shell	begetctl param shell 或 param shell
param save	持久化workspace中的所有带持久化标记的参数	begetctl param save 或 param save
dump api	dump 显示init 系统参数接口信息	begetctl dump api
getloglevel	获取当前init的log等级读取persist.init.debug.loglevel 0:debug 1:info 2:warning 3:err 4:fatal	begetctl getloglevel
setloglevel level	设置log等级为info log等级设置范围0~4 0:debug 1:info 2:warning 3:err 4:fatal	begetctl setloglevel 1
timer_stop servicename	停止服务计时器 servicename长度不超过96字符	begetctl timer_stop servicename
timer_start servicename timeout	启动服务计时器 servicename长度不超过96 timeout默认值：10毫秒	begetctl timer_start servicename
start_service servicename	启动服务	begetctl start_service servicename 或 start_service servicename
stop_service servicename	停止服务	begetctl stop_service servicename 或 stop_service servicename
service_control start servicename	启动服务	begetctl service_control start servicename 或 service_control start servicename
service_control stop servicename	停止服务	begetctl service_control stop servicename 或 service_control stop servicename
sandbox -b pid	进入native应用沙盒	begetctl sandbox -b pid
sandbox -p process_name	进程进沙盒	begetctl sandbox -p /bin/sh
sandbox -n sandbox_name	进入配置的system或者chipset沙盒	begetctl sandbox -n system
sandbox -s service_name	服务进沙盒	begetctl sandbox -s service_name
sandbox -h	展示sandbox 命令帮助信息	begetctl sandbox -h
modulectl uninstall moduleName	卸载动态插件	begetctl modulectl uninstall moduleName 例如: 卸载bootchart： begetctl modulectl uninstall bootchart
modulectl install moduleName	安装动态插件	begetctl modulectl install moduleName 例如: 安装bootchart： begetctl modulectl install bootchart
modulectl list	查询动态插件列表	begetctl modulectl list
misc_daemon --write_logo xxx.rgb	写入开机logo rgb文件最大不超过1024*2038，仅支持hi3516dv300	begetctl misc_daemon --write_logo logo.rgb 或 misc_daemon --write_logo logo.rgb
reboot	重启系统	begetctl reboot 或 reboot
reboot shutdown[:options]	关闭系统	begetctl reboot shutdown 或 reboot shutdown
reboot suspend	暂停系统	begetctl reboot suspend 或 reboot suspend
reboot updater	重新启动并进入updater	begetctl reboot updater 或 reboot updater
reboot updater[:options]	重新启动并进入updater	begetctl reboot updater 或 reboot updater
reboot flashd	重新启动并进入flashd	begetctl reboot flashd 或 reboot flashd
reboot flashd[:options]	重新启动并进入flashd	begetctl reboot flashd 或 reboot flashd
reboot charge	重新启动并进入charge	begetctl reboot charge 或 reboot charge
reboot loader	重新启动并进入烧写模式	begetctl reboot loader 或 reboot loader
bootevent disable	关闭bootevent插件功能	begetctl bootevent disable
bootevent enable	开启bootevent插件功能	begetctl bootevent enable
dump_service parameter_service trigger	命令行展示所有trigger信息	begetctl dump_service parameter_service trigger
dump_service all	命令行展示所有服务的信息	begetctl dump_service all
dump_service serviceName	命令行展示单个服务信息	begetctl dump_service param_watcher
dump_service loop	dump loop 中fd信息	begetctl dump_service loop
bootchart stop	停止图形分析，仅支持rk3568	begetctl bootchart stop
bootchart start	开始图形分析	begetctl bootchart start
bootchart disable	图形分析不使能	begetctl bootchart disable
bootchart enable	图形分析使能	begetctl bootchart enable
dac uid username	查询username 对应的uid	begetctl dac uid username 例如: begetctl dac uid root
dac gid groupname	groupname 对应的gid以及组成员	begetctl dac gid groupname 例如: begetctl dac gid shell
get log level	获取当前init的log等级读取persist.init.debug.loglevel 0:debug 1:info 2:warning 3:err 4:fatal	begetctl get log level
set log level	设置log等级为info log等级设置范围0~4 0:debug 1:info 2:warning 3:err 4:fatal	begetctl set log level 1
appspawn_time	查询应用孵化的最大最小时间	begetctl appspawn_time 例如： begetctl appspawn_time
dump_nwebspawn	dump nwebspawn 应用信息	begetctl dump_nwebspawn 例如：打开备忘录 begetctl dump_nwebspawn
dump_appspawn	dump appspawn 应用信息	begetctl dump_appspawn 例如： begetctl dump_appspawn

ServiceStatus

typedef enum {
    SERVICE_IDLE = 0, // service add
    SERVICE_STARTING, // service start
    SERVICE_STARTED, // 2 service ok running
    SERVICE_READY, // 3 service ok running
    SERVICE_STOPPING,
    SERVICE_STOPPED, // 5
    SERVICE_ERROR,
    SERVICE_SUSPENDED,
    SERVICE_FREEZED,
    SERVICE_DISABLED,
    SERVICE_CRITICAL
} ServiceStatus;

开发步骤

新增一个插件，以bootchart为例：

安装so文件，定义单独文件，实现下面函数。

static int bootchartEarlyHook(int stage, int prio, void *cookie)
{
    char enable[4] = {}; // 4 enable size
    uint32_t size = sizeof(enable);
    SystemReadParam("persist.init.bootchart.enabled", enable, &size);
    if (strcmp(enable, "1") != 0) {
        PLUGIN_LOGI("bootchart disabled.");
        return 0;
    }
    InitModuleMgrInstall("libbootchart");
    PLUGIN_LOGI("bootchart enabled.");
    return 0;
}

MODULE_CONSTRUCTOR(void)
{
    // Depends on parameter service
    InitAddPostPersistParamLoadHook(0, bootchartEarlyHook);
}

编译成静态库libbootchart_static，并加入static_modules组。

group("static_modules") {
  if (!defined(ohos_lite)) {
    deps = [ ":libbootchart_static" ]
  }
}

初始化bootchart插件，可以安装插件命令。

static int BootchartInit(void)
{
    if (g_executorId == -1) {
        g_executorId = AddCmdExecutor("bootchart", DoBootchartCmd);
        PLUGIN_LOGI("BootchartInit executorId %d", g_executorId);
    }
    return 0;
}

MODULE_CONSTRUCTOR(void)
{
    PLUGIN_LOGI("DoBootchartStart now ...");
    BootchartInit();
}

退出bootchart插件。

MODULE_DESTRUCTOR(void)
{
    PLUGIN_LOGI("DoBootchartStop now ...");
    DoBootchartStop();
    BootchartExit();
}

执行bootchart命令。

static int DoBootchartCmd(int id, const char *name, int argc, const char **argv)
{
    PLUGIN_LOGI("DoBootchartCmd argc %d %s", argc, name);
    ...
    return 0;
}

开发实例

bootchart 使用示例

预制条件：

准备bootchart测试环境：linux操作系统下安装python及pycairo pip install pycairo
在linux解压bootchart-master.tar

tar -zxvf bootchart-master.tar

执行步骤：

启动系统。
执行命令行：begetctl bootchart enable
重启系统。
执行命令行：begetctl bootchart stop
执行命令行：begetctl bootchart disable
在/data/service/el0/startup/init/目录下导出如下文件并存放在bootchart文件夹：
header
proc_diskstats.log
proc_ps.log
proc_stat.log
使用tar -zcvf bootchart.tgz * 命令进行打包（只支持linux版本）并将该打包文件拷贝到linux：bootchart-master目录下。

在bootchart-master目录下运行命令：

python3 pybootchartgui.py -f pdf bootchart.tgz

预期结果：
在bootchart-master目录下生成bootchart.pdf。

bootevent 使用示例

在服务的cfg文件中配置bootevent事件,支持配置一个或多个bootevent事件。

配置单个bootevent事件:
```
bootevents : "bootevent.xxxbootevent",
```
配置多个bootevent事件:
```
bootevents : ["bootevent.xxxbootevent1", "bootevent.xxxbootevent2.xxx"],
```

注意： 配置的bootevent事件必须以“bootevent.”开始。

服务代码中发送bootevent事件。

服务自身代码中调用init提供的SetParameter接口发送bootevent事件,例如发送上一步骤中设置的XXXbootevent1事件：
```
SetParameter("bootevent.XXXbootevent1", "true");
```
命令行启用bootevent功能。
- 执行begetctl bootevent enable命令后再次启动系统，bootevent功能开启。
- 执行begetctl bootevent disable命令后再次启动系统，bootevent功能关闭。
导出文件支持trace分析。
- 导出的bootevent文件目录：/data/service/el0/startup/init/。
- 导出文件命名规则：“时间戳.bootevent”。
- 导出的bootevent信息文件可以通过trace分析工具进行可视化展示。