扩展程序应用和本地命令

借助 Android Management API (AMAPI) SDK，EMM 指定的扩展程序应用能够 直接与 Android Device Policy (ADP) 通信，并执行 Commands 。

与 AMAPI SDK 集成提供了有关 以及如何将其添加到您的应用中。

集成 SDK 后，您的扩展程序应用便可与 ADP 通信，以便：

发出命令

扩展程序应用可以请求使用 ADP 发出命令。 IssueCommandRequest 包含请求对象，该对象将包含有关 要发出的命令和特定参数。

以下代码段展示了如何发出清除软件包数据的请求：

import android.util.Log;
...
import com.google.android.managementapi.commands.LocalCommandClientFactory;
import com.google.android.managementapi.commands.model.Command;
import com.google.android.managementapi.commands.model.GetCommandRequest;
import com.google.android.managementapi.commands.model.IssueCommandRequest;
import com.google.android.managementapi.commands.model.IssueCommandRequest.ClearAppsData;
import com.google.common.collect.ImmutableList;
import com.google.common.util.concurrent.FutureCallback;
import com.google.common.util.concurrent.Futures;
import com.google.common.util.concurrent.MoreExecutors;

...
  void issueClearAppDataCommand(ImmutableList<String> packageNames) {
    Futures.addCallback(
        LocalCommandClientFactory.create(getContext())
            .issueCommand(createClearAppRequest(packageNames)),
        new FutureCallback<Command>() {
          @Override
          public void onSuccess(Command result) {
            // Process the returned command result here
            Log.i(TAG, "Successfully issued command");
          }

          @Override
          public void onFailure(Throwable t) {
            Log.e(TAG, "Failed to issue command", t);
          }
        },
        MoreExecutors.directExecutor());
  }

  IssueCommandRequest createClearAppRequest(ImmutableList<String> packageNames) {
    return IssueCommandRequest.builder()
        .setClearAppsData(
            ClearAppsData.builder()
                .setPackageNames(packageNames)
                .build()
        )
        .build();
  }
...

前面的示例展示了如何针对指定的 软件包并等待命令成功发出。如果 成功发出，系统将返回一个 Command 对象以及当前的 命令状态和命令 ID（稍后可用于查询 任何长时间运行的命令

获取命令

扩展程序应用可以查询以前发出的命令请求的状态。接收者 检索命令的状态，您将需要命令 ID（可从 发出命令请求）。以下代码段展示了如何发送 GetCommandRequest 提交给 ADP。

import android.util.Log;
...
import com.google.android.managementapi.commands.LocalCommandClientFactory;
...
import com.google.android.managementapi.commands.model.GetCommandRequest;
import com.google.common.util.concurrent.FutureCallback;
import com.google.common.util.concurrent.Futures;
import com.google.common.util.concurrent.MoreExecutors;

...
  void getCommand(String commandId) {
    Futures.addCallback(
        LocalCommandClientFactory.create(getApplication())
            .getCommand(GetCommandRequest.builder().setCommandId(commandId).build()),
        new FutureCallback<Command>() {
          @Override
          public void onSuccess(Command result) {
            // Process the returned command result here
            Log.i(Constants.TAG, "Successfully issued command");
          }

          @Override
          public void onFailure(Throwable t) {
            Log.e(Constants.TAG, "Failed to issue command", t);
          }
        },
        MoreExecutors.directExecutor());
  }
  ...

监听命令状态更改回调

扩展程序应用可以注册回调来接收状态变化更新 按照下列步骤操作：

  1. 命令状态变更会通知给 CommandListener，请实施此 接口，并提供有关如何处理 收到状态更新。
  2. 扩展 NotificationReceiverService 并提供 CommandListener 实例。

  3. 指定 Android 中扩展 NotificationReceiverService 的类名称 Management API 政策（请参阅政策配置）。

    import com.google.android.managementapi.commands.CommandListener;
    import com.google.android.managementapi.notification.NotificationReceiverService;

    ...

    public class SampleCommandService extends NotificationReceiverService {

          @Override
          protected void setupInjection() {
            // (Optional) If using DI and needs initialisation then use this method.
          }

          @Override
          public CommandListener getCommandListener() {
            // return the concrete implementation from previous step
            return ...;
          }
    }

  4. 将服务添加到您的 AndroidManifest.xml 并确保将其导出。

    <service
         android:name = ".notification.SampleCommandService"
         android:exported = "true" />

策略配置

为了让该扩展程序应用能够直接与 ADP 通信，EMM 必须 提供 extensionConfig 政策。

 "applications": [{
   "packageName": "com.amapi.extensibility.demo",
   ...
   "extensionConfig": {
     "signingKeyFingerprintsSha256": [
       // Include signing key of extension app
     ],
     // Optional if callback is implemented
     "notificationReceiver": "com.amapi.extensibility.demo.notification.SampleCommandService"
   }
 }]

测试

单元测试

LocalCommandClient 是一个接口，因此能够提供可测试的 实施。

集成测试

若要使用 ADP 进行测试，您需要提供以下信息：

  1. 扩展程序应用的软件包名称。
  2. 与应用相关联的签名的十六进制编码 SHA-256 哈希值 软件包。
  3. （可选）如果要测试回调 - 来自 的服务的完全限定名称 新引入的服务来支持回调。（ CommandService）。