Mengintegrasikan dengan AMAPI SDK

Android Management API (AMAPI) SDK memungkinkan aplikasi tertentu berkomunikasi langsung dengan Kebijakan Perangkat Android (ADP). Hal ini mencakup dukungan untuk:

Langkah-langkah berikut harus dilakukan untuk mengintegrasikan AMAPI SDK dengan aplikasi Anda:

  1. Tambahkan library AMAPI SDK.
  2. Tambahkan elemen kueri, jika SDK target >= 30.

Prasyarat

  • Pastikan minSdkVersion aplikasi Anda ditetapkan ke setidaknya level API 21.
  • Tambahkan dependensi untuk AMAPI SDK versi terbaru ke aplikasi Anda. Anda dapat menemukan versi library terbaru yang tersedia, dan cara menambahkannya ke aplikasi, di halaman catatan rilis AMAPI SDK.

Menambahkan elemen kueri

Jika aplikasi Anda menargetkan SDK 30 atau yang lebih baru, elemen kueri diperlukan di AndroidManifest.xml untuk menentukan bahwa aplikasi akan berinteraksi dengan ADP.

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

Lihat Pemfilteran visibilitas paket di Android untuk mengetahui informasi selengkapnya.

Mengimplementasikan NotificationReceiverService

Beberapa fitur memerlukan pembuatan NotificationReceiverService, dan beberapa fitur menggunakannya secara opsional. Untuk menggunakannya, tentukan class yang memperluas NotificationReceiverService, tambahkan sebagai service ke AndroidManifest.xml, dan pastikan class tersebut diekspor.


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

Anda harus menyediakan aplikasi ADP dengan ComponentName dari class NotificationReceiverService Anda. Ada dua pendekatan untuk melakukannya. Dokumentasi untuk setiap fitur menentukan pendekatan yang akan digunakan.

API Eksplisit

Dalam hal ini, ComponentName diteruskan ke aplikasi ADP melalui API yang sesuai. Dokumentasi fitur yang dimaksud memiliki detailnya. Di AndroidManifest.xml, tambahkan:

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

Penemuan otomatis

Dengan pendekatan ini, Anda harus memberi tag pada layanan agar dapat ditemukan secara otomatis. Di AndroidManifest.xml, tambahkan:

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

String spesifik yang akan digunakan untuk android:name dari meta-data didokumentasikan untuk setiap fitur yang menggunakan pendekatan ini (lihat Mengelola peran aplikasi sebagai contoh). Agar pemberian tag ini valid, aplikasi Anda harus memiliki tepat satu layanan yang diaktifkan dan memiliki meta-data yang android:name-nya adalah string spesifik ini dan android:value adalah string kosong. Anda dapat menambahkan beberapa meta-data ke layanan yang sama.