Catatan rilis Android Management SDK

Proses rilis Android Management SDK (AMAPI SDK) dapat mencakup tahap kandidat rilis sebagai bagian dari proses rilis standar.

Poin Penting: Kandidat rilis adalah calon rilis yang mengimplementasikan platform API akhir.

Update Terbaru

	Rilis Stabil	Kandidat Rilis
28 Oktober 2026	1.9.0

Mendeklarasikan dependensi

Untuk menambahkan dependensi pada AMAPI SDK, Anda harus menambahkan repositori Maven Google ke project Anda:

repositories {
  ...
  google()
}

Tambahkan dependensi untuk artefak yang diperlukan dalam file build.gradle bagi aplikasi atau modul Anda:

dependencies {
    def amapi_version = "1.9.0"

    implementation "com.google.android.libraries.enterprise.amapi:amapi:$amapi_version"
}

Untuk informasi dependensi selengkapnya, lihat Menambahkan dependensi build.

Poin Penting: Selalu gunakan library versi stabil terbaru yang tersedia untuk memanfaatkan perbaikan bug dan peningkatan yang tersedia.

Versi 1.9.0

28 Oktober 2026

Versi ini mencakup update berikut:

• Menambahkan antarmuka PolicyClient dan Policy.UnifiedUpdatePolicy untuk memungkinkan Pengontrol Kebijakan Perangkat (DPC) kustom mengonfigurasi, mengambil, dan menghapus kebijakan Unified Update Controls (UUC) di perangkat milik perusahaan melalui aplikasi Android Device Policy (ADP). Lihat Mengonfigurasi Unified Update Controls dengan AMAPI SDK.
• Memperkenalkan perintah Wipe lokal (IssueCommandRequest.Wipe) dan kemampuan tambahan LOCAL_DEVICE_WIPE_COMMAND_ALLOWED (Role.ExtraCapabilities), yang memungkinkan aplikasi pendamping yang diberi peran COMPANION_APP untuk menghapus total perangkat milik perusahaan atau profil kerja di perangkat milik pribadi secara lokal. Lihat Aplikasi ekstensi dan perintah lokal serta Mengelola peran aplikasi.
• Memperbaiki masalah yang menyebabkan komunikasi dengan aplikasi Kebijakan Perangkat Android dapat gagal dengan error PERMISSION_DENIED (misalnya, segera setelah pendaftaran perangkat atau update Layanan Google Play) hingga perangkat atau aplikasi klien dimulai ulang.
• Mengklarifikasi dokumentasi pengecualian dan penggantian untuk OemSystemUpdateClient dan OemSystemUpdateHandler.

Versi 1.8.4

10 September 2026

Versi ini mencakup update berikut:

• Mengupdate dependensi transitif SDK agar kompatibel dengan Kotlin 2.4.0. Tindakan ini memperbaiki error yang terjadi selama notifikasi peran aplikasi, yang memengaruhi v1.8.2 dan v1.8.3, saat aplikasi yang diintegrasikan tidak menentukan kotlinx-coroutines-core 1.11.0 atau yang lebih baru.

• Mengklarifikasi dokumentasi untuk Instruction.InstructionType#FORCE.

Versi 1.8.3

12 Agustus 2026

Versi ini mencakup update berikut:

• Memperbaiki masalah terkait SDK yang dapat menampilkan status 'diinstal, tetapi belum siap' yang sudah tidak berlaku saat menggunakan peran DEVICE_POLICY_CONTROLLER jika proses klien dimulai ulang setelah persiapan lingkungan berhasil.
• Level API Android minimum yang didukung kini adalah 24 (naik dari 23).

Versi 1.8.2

15 Juli 2026

Versi ini mencakup update berikut:

• Memperbaiki masalah saat memanggil prepareEnvironment dapat gagal mengupdate Google Play Store ke versi yang diperlukan, sehingga menyebabkan penginstalan kebijakan perangkat Android gagal.

Versi 1.8.1

2 Juni 2026

Versi ini mencakup update berikut:

• Peningkatan keandalan dan pelaporan error selama proses penginstalan aplikasi Kebijakan Perangkat Android.
• Meningkatkan alur persiapan lingkungan untuk meningkatkan kompatibilitas dan keandalan selama update Google Play Store.

Versi 1.8.0

15 April 2026

Versi ini memperkenalkan dukungan untuk partner OEM, yang memungkinkan klien Over-the-Air (OTA) OEM berkomunikasi dua arah dengan aplikasi kebijakan perangkat Android (ADP) terkait update sistem.

Versi ini mencakup update berikut:

• Tambahkan antarmuka OemSystemUpdateClient, yang memungkinkan klien OTA OEM memberi tahu ADP tentang update dan mengkueri petunjuk. Antarmuka ini mencakup metode untuk:
  • Membuat, mendapatkan, dan mencantumkan update sistem (misalnya, createSystemUpdate, getSystemUpdate, listSystemUpdates).
  • Laporkan berbagai tahap proses update (misalnya, reportSystemUpdateDownloading, reportSystemUpdateDownloaded, reportSystemUpdateApplied, reportSystemUpdateAborted).
  • Laporkan tindakan yang diambil saat mengganti petunjuk AMAPI atau saat dicegah untuk mematuhinya (misalnya, reportSystemUpdateDownloadingWithOverride, reportSystemUpdateDownloadPrevented).
  • Mengelola dan mengkueri status kontrol update (misalnya, updateUpdateControlState, getUpdateControlState).
• Tambahkan antarmuka OemSystemUpdateHandler, yang harus diterapkan oleh klien OTA OEM untuk menerima callback dari ADP. Hal ini mencakup:
  • onSystemUpdatesChanged: Memberi tahu klien OEM tentang perubahan pada petunjuk update.
  • listPendingSystemUpdates: Dipanggil oleh ADP untuk meminta daftar update yang tertunda.
  • getUpdateControlState: Dipanggil oleh ADP untuk mengambil status kontrol update saat ini dari klien OEM.

Catatan: ADP tidak akan memenuhi permintaan dari partner OEM saat ini, karena fungsi platform terkait diperkirakan akan dirilis dengan Android 17. Namun, partner dapat mulai berintegrasi dengannya sekarang, karena tidak ada perubahan yang diperlukan setelah fitur ini didukung sepenuhnya.

Versi 1.7.1

19 Januari 2026

Versi ini mencakup update berikut:

• Memperbaiki bug yang mencegah aplikasi memanggil prepareEnvironment di Android 8 atau yang lebih rendah saat menggunakan peran DEVICE_POLICY_CONTROLLER. Peran lainnya masih memerlukan Android 10 atau yang lebih baru.
• Logging yang ditingkatkan untuk diagnostik yang lebih baik. Sebaiknya partner menggunakan versi ini.

Versi 1.7.0

3 November 2025

Versi ini mencakup update berikut:

• Tambahkan ke sinyal kepercayaan perangkat yang tersedia, ManagementProviderInfo, yang berisi nama bisnis penyedia pengelolaan yang dapat dibaca manusia.
• Memperkenalkan perintah REQUEST_DEVICE_INFO untuk mengizinkan aplikasi DPC membaca EID perangkat. Panggil IssueCommandRequest dengan jenis RequestDeviceInfo dan tentukan DeviceInfo.EID sebagai ID perangkat yang diminta.
• Mengupdate dependensi untuk memperbaiki CVE-2023-2976.

Versi 1.7.0-rc01

29 September 2025

Versi ini mencakup update berikut:

• Tambahkan ke sinyal kepercayaan perangkat yang tersedia, ManagementProviderInfo, yang berisi nama bisnis penyedia pengelolaan yang dapat dibaca manusia.
• Memperkenalkan perintah REQUEST_DEVICE_INFO untuk mengizinkan aplikasi DPC membaca EID perangkat. Panggil IssueCommandRequest dengan jenis RequestDeviceInfo dan tentukan DeviceInfo.EID sebagai ID perangkat yang diminta.

Versi 1.6.0

11 September 2025

Versi ini mencakup update berikut:

• Memperkenalkan kemungkinan bagi EMM yang menggunakan Android Management API untuk menginstal aplikasi kustom. Lihat Mengelola aplikasi kustom dengan AMAPI.
• Memperkenalkan sistem baru untuk menetapkan peran ke aplikasi. Lihat Mengelola peran aplikasi.
• Tingkatkan minSDK ke level API 23.

Versi 1.6.0-rc01

28 Agustus 2025

Versi ini mencakup update berikut:

• Memperkenalkan kemungkinan bagi EMM yang menggunakan Android Management API untuk menginstal aplikasi kustom. Lihat Mengelola aplikasi kustom dengan AMAPI.
• Tingkatkan minSDK ke level API 23.

Versi 1.5.0

11 Agustus 2025

Versi ini mencakup update berikut:

• Alur pendaftaran perangkat yang ditingkatkan untuk Pengontrol Kebijakan Perangkat (DPC) kustom. Pendekatan yang disederhanakan ini menggunakan AMAPI SDK dan aplikasi kebijakan perangkat Android (ADP) untuk menyederhanakan pendaftaran perangkat.
• Peningkatan stabilitas dan performa dengan informasi tambahan yang tersedia dalam pengecualian kepercayaan perangkat; Lihat AmapiSdkException.

Versi 1.5.0-rc01

24 Juli 2025

Versi ini memperkenalkan alur pendaftaran perangkat yang ditingkatkan untuk Pengontrol Kebijakan Perangkat (DPC) kustom. Pendekatan yang disederhanakan ini menggunakan AMAPI SDK dan aplikasi Kebijakan Perangkat Android (ADP) untuk menyederhanakan pendaftaran perangkat.

Versi 1.4.0

18 Juni 2025

Versi ini menyertakan sinyal Device.WorkProfileState untuk mengidentifikasi status pengelolaan perangkat.

Tidak ada perbedaan dengan v1.4.0-rc01.

Penting: Akses ke sinyal kepercayaan perangkat dibatasi menggunakan daftar yang diizinkan untuk mencegah penggunaan yang tidak sah. Untuk informasi tambahan, lihat: Device Trust from Android Enterprise - API access.

Versi 1.4.0-rc01

2 Juni 2025

Versi ini menyertakan sinyal Device.WorkProfileState untuk mengidentifikasi status pengelolaan perangkat.

Versi 1.3.0

14 April 2025

Versi ini mencakup rilis pertama Device Trust from Android Enterprise.

Tidak ada perbedaan dengan v1.3.0-rc01.

Penting: Akses ke sinyal kepercayaan perangkat dibatasi menggunakan daftar yang diizinkan untuk mencegah penggunaan yang tidak sah. Untuk informasi tambahan, lihat: Device Trust from Android Enterprise - API access.

Versi 1.3.0-rc01

18 Februari 2025

Versi ini menyertakan kandidat rilis pertama untuk Device Trust dari Android Enterprise.

• Paket sinyal kepercayaan perangkat baru com.google.android.managementapi.device
• Paket Lingkungan Baru com.google.android.managementapi.environment untuk menyiapkan perangkat untuk Device Trust dari Android Enterprise dan, jika perlu, untuk menginstal atau mengupdate aplikasi Android Device Policy.

Versi 1.1.5

13 Mei 2024

Versi ini mencakup update berikut:

• Perbaikan bug dan peningkatan internal.

Versi 1.1.4

24 Januari 2024

Versi ini mencakup update berikut:

• Paket Migrasi DPC baru com.google.android.managementapi.dpcmigration untuk mendukung migrasi perangkat ke AMAPI. Untuk informasi tambahan, Anda dapat membaca panduan Memigrasikan perangkat yang ada ke AMAPI.

Versi 1.0.1

15 Februari 2022

Versi ini mencakup update berikut:

• Perbaikan bug dan peningkatan internal.

Versi 1.0.0

20 September 2021

Versi ini mencakup update berikut:

• Rilis awal.