DpcMigrationClient

Kotlin |Java

public interface DpcMigrationClient

---

Klien untuk membuat permintaan terkait migrasi DPC.

Ringkasan

Metode publik
abstract @NonNull ListenableFuture<DpcMigrationAttempt>	getMigrationAttempt(     @NonNull GetDpcMigrationAttemptRequest getMigrationAttemptRequest ) Mendapatkan upaya migrasi.
abstract DpcMigrationAttempt	getMigrationAttemptAwait(     @NonNull GetDpcMigrationAttemptRequest getMigrationAttemptRequest ) Mendapatkan upaya migrasi.
abstract @NonNull ListenableFuture<@NonNull List<@NonNull DpcMigrationAttempt>>	listMigrationAttempts() Menampilkan daftar semua upaya migrasi.
abstract @NonNull List<@NonNull DpcMigrationAttempt>	listMigrationAttemptsAwait() Menampilkan daftar semua upaya migrasi.
abstract @NonNull ListenableFuture<@NonNull DpcMigrationAttempt>	migrateDeviceManagementToAndroidManagementApi(     @NonNull ComponentName notificationServiceComponentName,     @NonNull ComponentName adminComponentName,     @NonNull DpcMigrationRequest migrationRequest ) Memigrasikan perangkat ini agar dikelola oleh Android Management API.
abstract @NonNull DpcMigrationAttempt	migrateDeviceManagementToAndroidManagementApiAwait(     @NonNull ComponentName notificationServiceComponentName,     @NonNull ComponentName adminComponentName,     @NonNull DpcMigrationRequest migrationRequest ) Memigrasikan perangkat ini agar dikelola oleh Android Management API.

Metode publik

getMigrationAttempt

abstract @NonNull ListenableFuture<DpcMigrationAttempt> getMigrationAttempt(
    @NonNull GetDpcMigrationAttemptRequest getMigrationAttemptRequest
)

Mendapatkan upaya migrasi.

Jika tidak ada nama yang ditentukan dalam 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

@NonNull ListenableFuture<DpcMigrationAttempt>

ListenableFuture yang menggabungkan hasilnya. Dapat berupa Masa depan yang berhasil menggabungkan DpcMigrationAttempt, jika berhasil. Masa depan yang berhasil menggabungkan null, jika DpcMigrationAttempt tidak ditemukan. Masa depan yang gagal menggabungkan SecurityException, jika pemanggil bukan Pemilik Perangkat atau Pemilik Profil, atau Pemilik Perangkat atau Pemilik Profil sebelumnya yang dimigrasikan ke Android Management API. Masa depan yang gagal menggabungkan DpcMigrationException Jika panggilan terkait migrasi DPC gagal. Pesan dan subjenis pengecualian berisi detail selengkapnya tentang kegagalan tersebut.

getMigrationAttemptAwait

abstract DpcMigrationAttempt getMigrationAttemptAwait(
    @NonNull GetDpcMigrationAttemptRequest getMigrationAttemptRequest
)

Mendapatkan upaya migrasi.

Jika tidak ada nama yang ditentukan dalam 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 yang diminta atau null, 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

abstract @NonNull ListenableFuture<@NonNull List<@NonNull DpcMigrationAttempt>> listMigrationAttempts()

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 yang lebih lama akan otomatis dihapus dan tidak ditampilkan.

Hasil

@NonNull ListenableFuture<@NonNull List<@NonNull DpcMigrationAttempt>>

ListenableFuture yang menggabungkan hasilnya. Dapat berupa Masa depan yang berhasil menggabungkan daftar DpcMigrationAttempt, jika berhasil. Masa depan yang gagal menggabungkan SecurityException, jika pemanggil bukan Pemilik Perangkat atau Pemilik Profil, atau Pemilik Perangkat atau Pemilik Profil sebelumnya yang dimigrasikan ke Android Management API. Masa depan yang gagal menggabungkan DpcMigrationException Jika panggilan terkait migrasi DPC gagal. Pesan dan subjenis pengecualian berisi detail selengkapnya tentang kegagalan tersebut.

listMigrationAttemptsAwait

abstract @NonNull List<@NonNull DpcMigrationAttempt> listMigrationAttemptsAwait()

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 yang lebih lama akan otomatis dihapus dan tidak ditampilkan.

Hasil
@NonNull List<@NonNull 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

abstract @NonNull ListenableFuture<@NonNull DpcMigrationAttempt> migrateDeviceManagementToAndroidManagementApi(
    @NonNull ComponentName notificationServiceComponentName,
    @NonNull ComponentName adminComponentName,
    @NonNull DpcMigrationRequest migrationRequest
)

Memigrasikan perangkat ini agar dikelola oleh Android Management API.

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

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

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

Jaringan Wi-Fi yang dikonfigurasi harus diteruskan dalam DpcMigrationRequest oleh Pemilik Profil (kecuali di Android 12) di perangkat milik pribadi jika telah mengonfigurasi jaringan Wi-Fi. Jaringan ini 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 penghapusan jaringan gagal, migrasi juga akan gagal dan karena penghapusan jaringan bukan operasi atomik, beberapa jaringan mungkin sudah 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 di migrationRequest.

Parameter
@NonNull ComponentName notificationServiceComponentName	ComponentName layanan yang memperluas NotificationReceiverService. Komponen ini harus merupakan komponen valid milik aplikasi panggilan, dan diekspor dalam manifes, jika tidak, IllegalArgumentException akan ditampilkan.
@NonNull ComponentName adminComponentName	ComponentName dari DeviceAdminReceiver admin DPC panggilan.
@NonNull DpcMigrationRequest migrationRequest	DpcMigrationRequest yang berisi token migrasi dan jaringan Wi-Fi yang dikonfigurasi. Yang terakhir hanya diperlukan jika pemanggil adalah Pemilik Profil di perangkat milik pribadi dan telah mengonfigurasi jaringan.

Hasil

@NonNull ListenableFuture<@NonNull DpcMigrationAttempt>

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

migrateDeviceManagementToAndroidManagementApiAwait

abstract @NonNull DpcMigrationAttempt migrateDeviceManagementToAndroidManagementApiAwait(
    @NonNull ComponentName notificationServiceComponentName,
    @NonNull ComponentName adminComponentName,
    @NonNull DpcMigrationRequest migrationRequest
)

Memigrasikan perangkat ini agar dikelola oleh Android Management API.

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

Peringatan: Tindakan ini tidak dapat dibatalkan. Fungsi penangguhan ini akan ditampilkan saat Android Device Policy menerima permintaan dan menyelesaikan pemeriksaan awal pada token migrasi. Jika terjadi kegagalan, Exception akan ditampilkan.

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

Jaringan Wi-Fi yang dikonfigurasi harus diteruskan dalam DpcMigrationRequest oleh Pemilik Profil (kecuali di Android 12) di perangkat milik pribadi jika telah mengonfigurasi jaringan Wi-Fi. Jaringan ini 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 penghapusan jaringan gagal, migrasi juga akan gagal dan karena penghapusan jaringan bukan operasi atomik, beberapa jaringan mungkin sudah 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 di migrationRequest.

Parameter
@NonNull ComponentName notificationServiceComponentName	ComponentName layanan yang memperluas NotificationReceiverService. Komponen ini harus merupakan komponen valid milik aplikasi panggilan, dan diekspor dalam manifes, jika tidak, IllegalArgumentException akan ditampilkan.
@NonNull ComponentName adminComponentName	ComponentName dari DeviceAdminReceiver admin DPC panggilan.
@NonNull DpcMigrationRequest migrationRequest	DpcMigrationRequest yang berisi token migrasi dan jaringan Wi-Fi yang dikonfigurasi. Yang terakhir hanya diperlukan jika pemanggil adalah Pemilik Profil di perangkat milik pribadi dan telah mengonfigurasi jaringan.

Hasil
@NonNull 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 ke komponen valid yang memperluas NotificationReceiverService yang diekspor dalam manifes, atau jika adminComponentName bukan admin aktif milik 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.