Mengintegrasikan dengan AMAPI SDK

Android Management API (AMAPI) SDK memungkinkan aplikasi tertentu berkomunikasi langsung dengan Android Device Policy (ADP). API 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 API level 21.
  • Tambahkan dependensi untuk AMAPI SDK versi terbaru ke aplikasi Anda. Anda dapat menemukan versi library terbaru yang tersedia, dan cara menambahkannya ke aplikasi Anda, 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.

Menerapkan NotificationReceiverService

Beberapa fitur memerlukan pembuatan NotificationReceiverService, dan beberapa fitur membuat penggunaan opsionalnya. 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 ComponentName class NotificationReceiverService Anda untuk aplikasi ADP. 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 untuk contohnya). Agar pemberian tag ini valid, aplikasi Anda harus memiliki tepat satu layanan yang diaktifkan dan memiliki meta-data yang android:name-nya adalah string tertentu ini dan android:value-nya adalah string kosong. Anda dapat menambahkan beberapa meta-data ke layanan yang sama.