功能簡介

應用孵化器，負責接受應用程序框架的命令孵化應用進程，設置其對應權限，并調用應用程序框架的入口。

基本概念

appspawn注冊的服務名稱為“appspawn”。appspawn 通過監聽本地socket，接收來自客戶端的請求消息。消息類型為AppParameter的結構體，定義路徑為：“interfaces/innerkits/include/appspawn_msg.h“。

表 1 字段說明

約束與限制

僅限標準系統下使用

開發指導

場景介紹

• 安全控制
  支持為app設置SELinux標簽。
  SELinux標簽接口代碼如下：

  AppSpawnClientExt *appProperty = (AppSpawnClientExt *)client;
  HapContext hapContext;
  ret = hapContext.HapDomainSetcontext(appProperty- >property.apl, appProperty- >property.processName);
  if (ret != 0) {
      APPSPAWN_LOGE("AppSpawnServer::Failed to hap domain set context, errno = %d %s",
          errno, appProperty- >property.apl);
  } else {
      APPSPAWN_LOGI("AppSpawnServer::Success to hap domain set context, ret = %d", ret);
  }
  

• 應用進程控制

  • 支持為app設置AccessToken。
  • 支持重啟前，appspawn停止后，可同時停止所有已孵化的app進程。

  AccessToken接口代碼如下：

  AppSpawnClientExt *appProperty = (AppSpawnClientExt *)client;
  int32_t ret = SetSelfTokenID(appProperty- >property.accessTokenId);
  APPSPAWN_LOGI("AppSpawnServer::set access token id = %d, ret = %d %d", appProperty- >property.accessTokenId, ret, getuid());
  

• 冷啟動
  支持通過aa命令冷啟動應用。

  param set startup.appspawn.cold.boot 1 // 打開冷啟動開關
  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
  

• 應用沙盒
  應用獨立運行于自身沙盒環境。應用沙盒中，只保留應用依賴的庫或文件，同時，應用之間數據的也進行隔離。

接口說明

接口定義路徑： "/base/startup/appspawn/interfaces/innerkits/include/client_socket.h"，接口說明參見表2。

表 2 接口說明

開發步驟

沙盒配置說明：

{
      "common" : [{                                           // 應用沙盒通用掛載項
          "top-sandbox-switch": "ON",                         // 沙盒總開關 ON: 打開， OFF： 關閉
          "app-base" : [{
              "sandbox-root" : "/mnt/sandbox/< PackageName >",  // 沙盒根路徑
              "mount-paths" : [{
                      "src-path" : "/config",                 // mount的源目錄
                      "sandbox-path" : "/config",             // 沙盒掛載路徑
                      "sandbox-flags" : [ "bind", "rec" ],    // 掛載方式
                      "check-action-status": "false"          // false 不檢查當前項掛載結果， true： 檢查當前項掛載結果
                  }
              ],
              "symbol-links" : [{                             // link 的目錄項
                      "target-name" : "/system/bin",          // link 的源目錄
                      "link-name" : "/bin",                   // 鏈接名稱
                      "check-action-status": "false"
                  }
              ]
          }],
      // 應用獨有配置參考
      "individual" : [{                                        // 個別應用單獨掛載項
          "com.ohos.medialibrary.MediaLibraryDataA" : [{       // 應用名
              "sandbox-switch": "ON",                          // ON： 掛載沙盒路徑， OFF: 掛載根路徑
              "sandbox-root" : "/mnt/sandbox/< PackageName >",   // 沙盒根路徑
              "mount-paths" : [{
                      "src-path" : "/storage/media/< currentUserId >",
                      "sandbox-path" : "/storage/media",
                      "sandbox-flags" : [ "bind", "rec" ],
                      "check-action-status": "false"
                  }
              ],
              "symbol-links" : []
          }]
      }]
  }

參考沙盒配置說明，修改配置文件。

• 進入設備下：/system/etc/sandbox/路徑下，直接修改對應沙盒配置文件， 重新啟動。
• 代碼路徑下：base/startup/appspawn_standard， 修改對應沙盒配置文件。

表 3 沙盒配置文件解釋

開發實例

以launcher應用新增獨有配置應用為例：

"com.ohos.launcher" : [{
    "sandbox-switch": "ON",
    "sandbox-root" : "/mnt/sandbox/< PackageName >",
    "mount-paths" : [{
            "src-path" : "/data/app/el1/bundle/public/",
            "sandbox-path" : "/data/bundles/",
            "sandbox-flags" : [ "bind", "rec" ],
            "check-action-status": "true"
        }
    ],
    "symbol-links" : []
}],

常見問題

冷啟動應用失敗

現象描述
通過命令冷啟動應用， 應用拉起失敗。

解決方法

1. 需要設置 param set startup.appspawn.cold.boot 1生效。

2. 確認冷啟動命令是否正確。

   審核編輯 黃宇