appspawn应用孵化组件
appspawn应用孵化组件
概述
appspawn被init启动后,等待接收进程间消息,根据消息内容启动应用服务并赋予其对应权限。
功能简介
安全控制
支持为app设置SELinux标签。应用进程控制
- 支持为app设置AccessToken。
- 支持重启前,appspawn停止后,可同时停止所有已孵化的app进程。
冷启动
支持应用通过aa命令冷启动应用。param set appspawn.cold.boot true // 打开冷启动开关 aa start -d 12345 -a $name -b $package -C 参考命令: aa start -d 12345 -a ohos.acts.startup.sysparam.function.MainAbility -b ohos.acts.startup.sysparam.function -C
1
2
3
4
基本概念
appspawn注册的服务名称为“appspawn”。appspawn 通过监听本地socket,接收来自客户端的请求消息。消息类型为AppProperty的结构体,定义路径为:“base/startup/appspawn_standard/interfaces/innerkits/include/sclient_socket.h”。
表1 字段说明
字段名 | 说明 |
---|---|
processName | 即将启动的应用服务进程名,最大256字节。 |
bundleName | 即将启动的应用程序包名,最大256字节。 |
soPath | 应用程序指定的动态库的路径,最大256字节。 |
uid | 即将启动的应用进程的uid,必须为正值。 |
gid | 即将启动的应用进程的gid,必须为正值。 |
gidTable | 即将启动的应用进程组信息,长度由gidCount指定,最大支持64个进程组,必须为正值。 |
gidCount | 即将启动的应用进程组个数。 |
accessTokenId | 应用进程权限控制的token id。 |
apl | 应用进程权限控制的apl,最大32字节。 |
开发指导
接口定义路径: “base/startup/appspawn_standard/interfaces/innerkits/include/client_socket.h”,表 2为接口说明。
接口说明
表2 接口说明
接口名 | 说明 |
---|---|
CreateClient | 创建client。 |
CloseClient | 关闭client。 |
ConnectSocket | 向appspawn服务发起连接请求。 |
WriteSocketMessage | 发送消息到appspawn服务。 |
ReadSocketMessage | 接收来自appspawn服务的消息。 |
开发实例
接口使用参考:
std::shared_ptr<AppSpawn::ClientSocket> clientSocket = std::make_unique<AppSpawn::ClientSocket>("AppSpawn");
if (clientSocket == nullptr) {
return -1;
}
if (clientSocket->CreateClient() != ERR_OK) {
return -1;
}
if (clientSocket->ConnectSocket() != ERR_OK) {
return -1;;
}
// property 构造AppProperty
clientSocket->WriteSocketMessage((void *)&property, sizeof(AppSpawn::AppProperty));
// 读结果
int pid;
clientSocket->ReadSocketMessage((void *)&pid, sizeof(pid));
// 如果失败,返回pid小于等于0;否则返回应用的进程id
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
常见问题
冷启动应用失败
现象描述
通过命令冷启动应用失败。
解决方法
确认是否打开冷启动设置。
确认冷启动命令是否正确。