このページは Cloud Translation API によって翻訳されました。

拡張機能アプリとローカルコマンド

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();
  }
...

上記の例では、指定したパッケージに対してアプリデータのクリアリクエストを発行し、コマンドが正常に発行されるまで待機しています。正常に発行されると、現在のコマンドステータスとコマンド ID とともに Command オブジェクトが返されます。このオブジェクトは、後で長時間実行されているコマンドのステータスをクエリするために使用できます。

コマンドの取得

拡張機能アプリは、以前に発行されたコマンドリクエストのステータスをクエリできます。コマンドのステータスを取得するには、コマンド ID（issue コマンドリクエストから取得可能）が必要です。次のスニペットは、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());
  }
  ...

コマンドステータス変更のコールバックをリッスンする

拡張機能アプリは、次の手順に沿って、長時間実行コマンドのステータス変更の更新を受信するためのコールバックを登録できます。

コマンドステータスの変更は CommandListener に通知され、このインターフェースをアプリに実装して、受信したステータス更新の処理方法を実装します。
NotificationReceiverService を拡張し、CommandListener インスタンスを指定します。

Android Management API ポリシーで、拡張された NotificationReceiverService のクラス名を指定します（ポリシー構成を参照）。

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 ...;
  }
}

サービスを 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 を使用してテストするには、次の情報が必要です。

拡張機能アプリのパッケージ名。
アプリパッケージに関連付けられた署名の 16 進数でエンコードされた SHA-256 ハッシュ。
（省略可）コールバックをテストする場合 - コールバックをサポートする、新しく導入されたサービスのサービスの完全修飾名。（この例では CommandService の完全修飾名）。