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
    5

基本概念

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
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

常见问题

冷启动应用失败

现象描述
    通过命令冷启动应用失败。

解决方法
    1. 确认是否打开冷启动设置。
    2. 确认冷启动命令是否正确。