이 페이지는 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 객체가 반환됩니다.

Get 명령어

확장 프로그램 앱은 이전에 실행된 명령어 요청의 상태를 쿼리할 수 있습니다. 명령어의 상태를 검색하려면 명령어 ID (문제 명령어 요청에서 가져올 수 있음)가 필요합니다. 다음 스니펫은 ADP에 GetCommandRequest를 전송하는 방법을 보여줍니다.

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를 확장하고 getCommandListener 메서드를 통해 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
 public CommandListener getCommandListener() {
   // return the concrete implementation from previous step
   return ...;
 }
}

정책 구성

확장 프로그램 앱이 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의 정규화된 이름)