與 AMAPI SDK 整合

Android Management API (AMAPI) SDK 可讓特定應用程式直接與 Android 裝置政策 (ADP) 通訊。支援的項目包括：

如要將 AMAPI SDK 與應用程式整合，請務必採取下列步驟：

  1. 新增 AMAPI SDK 程式庫。
  2. 如果目標 SDK >= 30，請新增查詢元素。

必要條件

  • 確認應用程式的 minSdkVersion 至少設為 API 級別 21。
  • 在應用程式中，新增最新版本 AMAPI SDK 的依附元件。如要查看最新可用程式庫的版本，以及如何將其新增至應用程式，請參閱 AMAPI SDK 的版本資訊頁面。

新增查詢元素

如果應用程式指定 SDK 30 以上版本，則必須在 AndroidManifest.xml 中加入查詢元素，指定與 ADP 互動。

<queries>
    <package android:name="com.google.android.apps.work.clouddpc" />
</queries>

詳情請參閱「在 Android 上篩選套件瀏覽權限」。

實作 NotificationReceiverService

部分功能需要建立 NotificationReceiverService，有些功能則可選擇是否使用。如要使用，請定義擴充 NotificationReceiverService 的類別，將其新增為 AndroidManifest.xml 的 service，並確保其已匯出。


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

...

public final class MyAppNotificationReceiverService extends NotificationReceiverService {

  @Override
  protected void setupInjection() {
    // This method can be optionally used to inject dependencies at the
    // beginning of the service lifecycle.
  }
}

您必須為 ADP 應用程式提供 NotificationReceiverService 類別的 ComponentName。有兩種方法可以做到這一點。每項功能的說明文件都會指定要使用的方法。

Explicit API

在這種情況下，ComponentName 會透過合適的 API 傳遞至 ADP 應用程式。詳情請參閱相關功能的說明文件。在 AndroidManifest.xml 中新增：

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

自動探索

採用這種方法時，您必須為服務加上標記，以便系統自動偵測。在 AndroidManifest.xml 中新增：

<service
 android:name = ".MyAppNotificationReceiverService"
 android:exported = "true" >
    <meta-data android:name="Insert name here" android:value=""/>
</service>

meta-data 的 android:name 應使用的特定字串，會記錄在採用這種方法的各項功能中 (請參閱「管理應用程式角色」範例)。為確保標記有效，應用程式必須只有一項已啟用的服務，且該服務的 meta-data 具有此特定字串的 android:name，而 android:value 則為空字串。您可以將多個 meta-data 新增至同一服務。