DpcMigrationClient

Kotlin |Java

interface DpcMigrationClient

---

Klien untuk membuat permintaan terkait migrasi dpc.

Ringkasan

Fungsi publik
ListenableFuture<DpcMigrationAttempt?>	getMigrationAttempt(     getMigrationAttemptRequest: GetDpcMigrationAttemptRequest ) Mendapatkan upaya migrasi.
suspend DpcMigrationAttempt?	getMigrationAttemptAwait(     getMigrationAttemptRequest: GetDpcMigrationAttemptRequest ) Mendapatkan upaya migrasi.
ListenableFuture<List<DpcMigrationAttempt>>	listMigrationAttempts() Menampilkan daftar semua upaya migrasi.
suspend List<DpcMigrationAttempt>	listMigrationAttemptsAwait() Menampilkan daftar semua upaya migrasi.
ListenableFuture<DpcMigrationAttempt>	migrateDeviceManagementToAndroidManagementApi(     notificationServiceComponentName: ComponentName,     adminComponentName: ComponentName,     migrationRequest: DpcMigrationRequest ) Migrasikan perangkat ini agar dikelola oleh Android Management API.
suspend DpcMigrationAttempt	migrateDeviceManagementToAndroidManagementApiAwait(     notificationServiceComponentName: ComponentName,     adminComponentName: ComponentName,     migrationRequest: DpcMigrationRequest ) Migrasikan perangkat ini agar dikelola oleh Android Management API.

Fungsi publik

getMigrationAttempt

fun getMigrationAttempt(
    getMigrationAttemptRequest: GetDpcMigrationAttemptRequest
): ListenableFuture<DpcMigrationAttempt?>

Mendapatkan upaya migrasi.

Jika tidak ada nama yang ditentukan di GetDpcMigrationAttemptRequest, DpcMigrationAttempt terbaru akan ditampilkan.

Metode ini hanya dapat dipanggil oleh Pemilik Perangkat atau Pemilik Profil, atau Pemilik Perangkat atau Pemilik Profil sebelumnya yang dimigrasikan ke Android Management API.

Hasil

ListenableFuture<DpcMigrationAttempt?>

ListenableFuture yang menggabungkan hasil. Dapat berupa Masa depan yang sukses dalam menggabungkan DpcMigrationAttempt, jika berhasil. Menggabungkan null yang berhasil di masa mendatang, jika DpcMigrationAttempt tidak ditemukan. Gagal menggabungkan SecurityException di masa mendatang, jika pemanggil bukan Pemilik Perangkat atau Pemilik Profil, atau Pemilik Perangkat atau Pemilik Profil sebelumnya yang bermigrasi ke Android Management API. Penggabungan mendatang yang gagal DpcMigrationException Jika panggilan terkait migrasi dpc gagal. Pesan dan subjenis pengecualian berisi detail selengkapnya tentang kegagalan tersebut.

getMigrationAttemptAwait

suspend fun getMigrationAttemptAwait(
    getMigrationAttemptRequest: GetDpcMigrationAttemptRequest
): DpcMigrationAttempt?

Mendapatkan upaya migrasi.

Jika tidak ada nama yang ditentukan di GetDpcMigrationAttemptRequest, DpcMigrationAttempt terbaru akan ditampilkan.

Metode ini hanya dapat dipanggil oleh Pemilik Perangkat atau Pemilik Profil, atau Pemilik Perangkat atau Pemilik Profil sebelumnya yang dimigrasikan ke Android Management API.

Hasil
DpcMigrationAttempt?	DpcMigrationAttempt atau null yang diminta, jika tidak dapat ditemukan

Menampilkan
java.lang.SecurityException	Jika pemanggil bukan Pemilik Perangkat atau Pemilik Profil, atau Pemilik Perangkat atau Pemilik Profil sebelumnya yang dimigrasikan ke Android Management API.
com.google.android.managementapi.dpcmigration.DpcMigrationException	Jika panggilan terkait migrasi dpc gagal. Pesan dan subjenis pengecualian berisi detail selengkapnya tentang kegagalan tersebut.

listMigrationAttempts

fun listMigrationAttempts(): ListenableFuture<List<DpcMigrationAttempt>>

Menampilkan daftar semua upaya migrasi.

Metode ini hanya dapat dipanggil oleh Pemilik Perangkat atau Pemilik Profil, atau Pemilik Perangkat atau Pemilik Profil sebelumnya yang dimigrasikan ke Android Management API. Catatan: upaya migrasi lama akan otomatis dihapus dan tidak ditampilkan.

Hasil

ListenableFuture<List<DpcMigrationAttempt>>

ListenableFuture yang menggabungkan hasil. Dapat berupa Masa depan yang sukses dalam menggabungkan daftar DpcMigrationAttempt, jika berhasil. Gagal menggabungkan SecurityException di masa mendatang, jika pemanggil bukan Pemilik Perangkat atau Pemilik Profil, atau Pemilik Perangkat atau Pemilik Profil sebelumnya yang bermigrasi ke Android Management API. Penggabungan mendatang yang gagal DpcMigrationException Jika panggilan terkait migrasi dpc gagal. Pesan dan subjenis pengecualian berisi detail selengkapnya tentang kegagalan tersebut.

listMigrationAttemptsAwait

suspend fun listMigrationAttemptsAwait(): List<DpcMigrationAttempt>

Menampilkan daftar semua upaya migrasi.

Metode ini hanya dapat dipanggil oleh Pemilik Perangkat atau Pemilik Profil, atau Pemilik Perangkat atau Pemilik Profil sebelumnya yang dimigrasikan ke Android Management API. Catatan: upaya migrasi lama akan otomatis dihapus dan tidak ditampilkan.

Hasil
List<DpcMigrationAttempt>	Daftar DpcMigrationAttempt

Menampilkan
java.lang.SecurityException	Jika pemanggil bukan Pemilik Perangkat atau Pemilik Profil, atau Pemilik Perangkat atau Pemilik Profil sebelumnya yang dimigrasikan ke Android Management API.
com.google.android.managementapi.dpcmigration.DpcMigrationException	Jika panggilan terkait migrasi dpc gagal. Pesan dan subjenis pengecualian berisi detail selengkapnya tentang kegagalan tersebut.

migrateDeviceManagementToAndroidManagementApi

fun migrateDeviceManagementToAndroidManagementApi(
    notificationServiceComponentName: ComponentName,
    adminComponentName: ComponentName,
    migrationRequest: DpcMigrationRequest
): ListenableFuture<DpcMigrationAttempt>

Migrasikan perangkat ini agar dikelola oleh Android Management API.

Setelah migrasi selesai, aplikasi panggilan akan kehilangan hak istimewa Pemilik Perangkat atau Pemilik Profil, karena keduanya ditransfer ke Android Device Policy.

Peringatan: Tindakan ini tidak dapat dibatalkan! ListenableFuture yang ditampilkan selesai saat Android Device Policy telah menerima permintaan dan menyelesaikan pemeriksaan awal pada token migrasi. Jika gagal, ListenableFuture akan menggabungkan Exception.

Metode ini hanya dapat dipanggil oleh Pemilik Perangkat atau Pemilik Profil. Di Android 10 dan yang lebih lama, tindakan ini tidak boleh dipanggil di perangkat yang memiliki Pemilik Perangkat dan Pemilik Profil.

Jaringan Wi-Fi yang dikonfigurasi harus diteruskan di DpcMigrationRequest oleh Pemilik Profil (kecuali di Android 12) di perangkat milik pribadi jika telah mengonfigurasi jaringan Wi-Fi apa pun. Data tersebut tidak boleh diteruskan di perangkat milik perusahaan. Perhatikan bahwa jaringan Wi-Fi ini akan dihapus tepat sebelum pengelolaan perangkat dimigrasikan ke Android Device Policy. Jika terjadi kegagalan untuk menghapus jaringan, migrasi juga akan gagal dan karena penghapusan jaringan bukan merupakan operasi atomik, beberapa jaringan mungkin telah dihapus.

Di perangkat milik pribadi dengan profil kerja yang menjalankan Android 12, semua jaringan Wi-Fi yang dikonfigurasi oleh DPC panggilan akan dihapus tepat sebelum pengelolaan perangkat dimigrasikan ke Android Device Policy, terlepas dari jaringan Wi-Fi yang diteruskan migrationRequest.

Parameter
notificationServiceComponentName: ComponentName	ComponentName layanan memperluas NotificationReceiverService. Ini harus berupa komponen valid milik aplikasi panggilan, dan diekspor dalam manifes. Jika tidak, IllegalArgumentException akan ditampilkan.
adminComponentName: ComponentName	ComponentName admin DeviceAdminReceiver dari DPC yang memanggil.
migrationRequest: DpcMigrationRequest	DpcMigrationRequest yang berisi token migrasi dan jaringan Wi-Fi yang dikonfigurasi. Opsi kedua hanya diperlukan jika pemanggil adalah Pemilik Profil di perangkat milik pribadi dan telah mengonfigurasi jaringan apa pun.

Hasil

ListenableFuture<DpcMigrationAttempt>

ListenableFuture yang menggabungkan hasil. Dapat berupa Masa depan yang sukses dalam menggabungkan DpcMigrationAttempt, jika berhasil. Masa mendatang yang gagal menggabungkan SecurityException, jika pemanggil bukan Pemilik Perangkat atau Pemilik Profil. Gagal menggabungkan IllegalArgumentException di masa mendatang, jika token migrasi kosong, atau jika notificationServiceComponentName tidak merujuk pada komponen valid yang memperluas NotificationReceiverService yang diekspor dalam manifes, atau jika adminComponentName bukan admin aktif yang termasuk dalam paket saat ini. Gagal menggabungkan DpcMigrationException di masa mendatang, jika panggilan terkait migrasi dpc gagal. Pesan dan subjenis pengecualian berisi detail selengkapnya tentang kegagalan tersebut.

migrateDeviceManagementToAndroidManagementApiAwait

suspend fun migrateDeviceManagementToAndroidManagementApiAwait(
    notificationServiceComponentName: ComponentName,
    adminComponentName: ComponentName,
    migrationRequest: DpcMigrationRequest
): DpcMigrationAttempt

Migrasikan perangkat ini agar dikelola oleh Android Management API.

Setelah migrasi selesai, aplikasi panggilan akan kehilangan hak istimewa Pemilik Perangkat atau Pemilik Profil, karena keduanya ditransfer ke Android Device Policy.

Peringatan: Tindakan ini tidak dapat dibatalkan! Penangguhan ini akan muncul kembali saat Android Device Policy telah menerima permintaan dan menyelesaikan pemeriksaan awal pada token migrasi. Jika gagal, Exception akan ditampilkan.

Metode ini hanya dapat dipanggil oleh Pemilik Perangkat atau Pemilik Profil. Di Android 10 dan yang lebih lama, tindakan ini tidak boleh dipanggil di perangkat yang memiliki Pemilik Perangkat dan Pemilik Profil.

Jaringan Wi-Fi yang dikonfigurasi harus diteruskan di DpcMigrationRequest oleh Pemilik Profil (kecuali di Android 12) di perangkat milik pribadi jika telah mengonfigurasi jaringan Wi-Fi apa pun. Data tersebut tidak boleh diteruskan di perangkat milik perusahaan. Perhatikan bahwa jaringan Wi-Fi ini akan dihapus tepat sebelum pengelolaan perangkat dimigrasikan ke Android Device Policy. Jika terjadi kegagalan untuk menghapus jaringan, migrasi juga akan gagal dan karena penghapusan jaringan bukan merupakan operasi atomik, beberapa jaringan mungkin telah dihapus.

Di perangkat milik pribadi dengan profil kerja yang menjalankan Android 12, semua jaringan Wi-Fi yang dikonfigurasi oleh DPC panggilan akan dihapus tepat sebelum pengelolaan perangkat dimigrasikan ke Android Device Policy, terlepas dari jaringan Wi-Fi yang diteruskan migrationRequest.

Parameter
notificationServiceComponentName: ComponentName	ComponentName layanan memperluas NotificationReceiverService. Ini harus berupa komponen valid milik aplikasi panggilan, dan diekspor dalam manifes. Jika tidak, IllegalArgumentException akan ditampilkan.
adminComponentName: ComponentName	ComponentName admin DeviceAdminReceiver dari DPC yang memanggil.
migrationRequest: DpcMigrationRequest	DpcMigrationRequest yang berisi token migrasi dan jaringan Wi-Fi yang dikonfigurasi. Opsi kedua hanya diperlukan jika pemanggil adalah Pemilik Profil di perangkat milik pribadi dan telah mengonfigurasi jaringan apa pun.

Hasil
DpcMigrationAttempt	DpcMigrationException dengan status migrasi saat ini jika berhasil.

Menampilkan
java.lang.SecurityException	Jika pemanggil bukan Pemilik Perangkat atau Pemilik Profil.
java.lang.IllegalArgumentException	Jika token migrasi kosong, atau jika notificationServiceComponentName tidak merujuk pada komponen valid yang memperluas NotificationReceiverService yang diekspor dalam manifes, atau jika adminComponentName bukan admin aktif yang termasuk dalam paket saat ini.
com.google.android.managementapi.dpcmigration.DpcMigrationException	Jika panggilan terkait migrasi dpc gagal. Pesan dan subjenis pengecualian berisi detail selengkapnya tentang kegagalan tersebut.