DpcMigrationClient

Kotlin |Java

public interface DpcMigrationClient

---

İstemcinin, dpc taşımayla ilgili isteklerde bulunacak.

Özet

Herkese açık yöntemler
abstract @NonNull ListenableFuture<DpcMigrationAttempt>	getMigrationAttempt(     @NonNull GetDpcMigrationAttemptRequest getMigrationAttemptRequest ) Taşıma denemesi yapılır.
abstract DpcMigrationAttempt	getMigrationAttemptAwait(     @NonNull GetDpcMigrationAttemptRequest getMigrationAttemptRequest ) Taşıma denemesi yapılır.
abstract @NonNull ListenableFuture<@NonNull List<@NonNull DpcMigrationAttempt>>	listMigrationAttempts() Tüm taşıma denemelerinin listesini döndürür.
abstract @NonNull List<@NonNull DpcMigrationAttempt>	listMigrationAttemptsAwait() Tüm taşıma denemelerinin listesini döndürür.
abstract @NonNull ListenableFuture<@NonNull DpcMigrationAttempt>	migrateDeviceManagementToAndroidManagementApi(     @NonNull ComponentName notificationServiceComponentName,     @NonNull ComponentName adminComponentName,     @NonNull DpcMigrationRequest migrationRequest ) Bu cihazı Android Management API tarafından yönetilecek yere taşıyın.
abstract @NonNull DpcMigrationAttempt	migrateDeviceManagementToAndroidManagementApiAwait(     @NonNull ComponentName notificationServiceComponentName,     @NonNull ComponentName adminComponentName,     @NonNull DpcMigrationRequest migrationRequest ) Bu cihazı Android Management API tarafından yönetilecek yere taşıyın.

Herkese açık yöntemler

getMigrationAttempt

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

Taşıma denemesi yapılır.

GetDpcMigrationAttemptRequest içinde herhangi bir ad belirtilmezse en son DpcMigrationAttempt döndürülür.

Bu yöntem yalnızca Android Management API'ye taşınmış bir Cihaz Sahibi veya Profil Sahibi ya da önceki bir Cihaz Sahibi veya Profil Sahibi tarafından çağrılabilir.

İlerlemeler

@NonNull ListenableFuture<DpcMigrationAttempt>

Sonucu sarmalayan bir ListenableFuture. Bu, şunlardan biri olabilir: Başarılı olmak koşuluyla, başarılı bir gelecek DpcMigrationAttempt sarmalaması. DpcMigrationAttempt bulunmaması durumunda, başarılı bir gelecek sarmalama boş değeri. Arayanın Cihaz Sahibi veya Profil Sahibi olmaması ya da Android Management API'ye taşınmış eski bir Cihaz Sahibi veya Profil Sahibi olmaması halinde gelecekte SecurityException sarmalanması başarısız oldu. Gelecekteki sarmalama başarısız DpcMigrationException Dpc taşımayla ilgili çağrı başarısız olduysa. İleti ve istisnanın alt türü, hatayla ilgili daha fazla ayrıntı içerir.

getMigrationAttemptAwait

abstract DpcMigrationAttempt getMigrationAttemptAwait(
    @NonNull GetDpcMigrationAttemptRequest getMigrationAttemptRequest
)

Taşıma denemesi yapılır.

GetDpcMigrationAttemptRequest içinde herhangi bir ad belirtilmezse en son DpcMigrationAttempt döndürülür.

Bu yöntem yalnızca Android Management API'ye taşınmış bir Cihaz Sahibi veya Profil Sahibi ya da önceki bir Cihaz Sahibi veya Profil Sahibi tarafından çağrılabilir.

İlerlemeler
DpcMigrationAttempt	İstenen DpcMigrationAttempt veya bulunamazsa null

Dekoratif yastıklar
java.lang.SecurityException	Arayan kişi bir Cihaz Sahibi veya Profil Sahibi değilse ya da Android Management API'ye taşınmış eski bir Cihaz Sahibi veya Profil Sahibi değilse.
com.google.android.managementapi.dpcmigration.DpcMigrationException	Dpc taşımayla ilgili arama başarısız olduysa. İleti ve istisnanın alt türü, hatayla ilgili daha fazla ayrıntı içerir.

listMigrationAttempts

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

Tüm taşıma denemelerinin listesini döndürür.

Bu yöntem yalnızca Android Management API'ye taşınmış bir Cihaz Sahibi veya Profil Sahibi ya da önceki bir Cihaz Sahibi veya Profil Sahibi tarafından çağrılabilir. Not: Eski taşıma denemeleri otomatik olarak silinir ve geri getirilmez.

İlerlemeler

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

Sonucu sarmalayan bir ListenableFuture. Bu, şunlardan biri olabilir: Başarılı bir şekilde sonuçlanması halinde DpcMigrationAttempt listesini sarmalayan başarılı bir gelecek. Arayanın Cihaz Sahibi veya Profil Sahibi olmaması ya da Android Management API'ye taşınmış eski bir Cihaz Sahibi veya Profil Sahibi olmaması halinde gelecekte SecurityException sarmalanması başarısız oldu. Gelecekteki sarmalama başarısız DpcMigrationException Dpc taşımayla ilgili çağrı başarısız olduysa. İleti ve istisnanın alt türü, hatayla ilgili daha fazla ayrıntı içerir.

listMigrationAttemptsAwait

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

Tüm taşıma denemelerinin listesini döndürür.

Bu yöntem yalnızca Android Management API'ye taşınmış bir Cihaz Sahibi veya Profil Sahibi ya da önceki bir Cihaz Sahibi veya Profil Sahibi tarafından çağrılabilir. Not: Eski taşıma denemeleri otomatik olarak silinir ve geri getirilmez.

İlerlemeler
@NonNull List<@NonNull DpcMigrationAttempt>	DpcMigrationAttempt listesi

Dekoratif yastıklar
java.lang.SecurityException	Arayan kişi bir Cihaz Sahibi veya Profil Sahibi değilse ya da Android Management API'ye taşınmış eski bir Cihaz Sahibi veya Profil Sahibi değilse.
com.google.android.managementapi.dpcmigration.DpcMigrationException	Dpc taşımayla ilgili arama başarısız olduysa. İleti ve istisnanın alt türü, hatayla ilgili daha fazla ayrıntı içerir.

migrateDeviceManagementToAndroidManagementApi

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

Bu cihazı Android Management API tarafından yönetilecek yere taşıyın.

Taşıma işlemi tamamlandıktan sonra, arama uygulaması Android Device Policy'ye aktarıldığı için Cihaz Sahibi veya Profil Sahibi ayrıcalıklarını kaybeder.

Uyarı: Bu işlem geri alınamaz. Döndürülen ListenableFuture, Android Device Policy isteği alıp taşıma jetonuyla ilgili ön kontrolleri tamamladığında tamamlanır. Hata durumunda ListenableFuture bir Exception öğesini sarmalar.

Bu yöntem yalnızca Cihaz Sahibi veya Profil Sahibi tarafından çağrılabilir. Android 10 ve önceki sürümlerde bu çağrı, hem cihaz sahibi hem de profil sahibi olan cihazlarda çağrılmamalıdır.

Kişiye ait bir cihazda, yapılandırılmış kablosuz ağların DpcMigrationRequest uygulamasında Profil Sahibi tarafından (Android 12 hariç) iletilmesi gerekir (cihazda kablosuz ağ yapılandırıldıysa). Bu kimlikler şirkete ait cihazlarda verilmemelidir. Bu kablosuz ağların, cihaz yönetimi Android Device Policy'ye taşınmasından hemen önce kaldırılacağını unutmayın. Bir ağın kaldırılamaması durumunda taşıma işlemi de başarısız olur. Ağların kaldırılması atomik bir işlem olmadığından bazı ağlar zaten kaldırılmış olabilir.

Android 12 çalıştıran bir iş profiline sahip şahsa ait cihazlarda, migrationRequest ürününde iletilen kablosuz ağlardan bağımsız olarak, çağrı yapan DPC tarafından yapılandırılan tüm kablosuz ağlar cihaz yönetiminin Android Device Policy'ye taşınmasından hemen önce kaldırılır.

Parametreler
@NonNull ComponentName notificationServiceComponentName	NotificationReceiverService süresini kapsayan hizmetin ComponentName. Bu, çağrı uygulamasına ait olan ve manifest dosyasında dışa aktarılan geçerli bir bileşen olmalıdır. Aksi takdirde bir IllegalArgumentException yayınlanır.
@NonNull ComponentName adminComponentName	Arayan DPC'nin ComponentName yöneticisinin DeviceAdminReceiver.
@NonNull DpcMigrationRequest migrationRequest	Taşıma jetonunu ve yapılandırılmış kablosuz ağları içeren DpcMigrationRequest. İkinci yöntem yalnızca, arayan kişi kendisine ait bir cihazda Profil Sahibi ise ve herhangi bir ağı yapılandırmışsa gereklidir.

İlerlemeler

@NonNull ListenableFuture<@NonNull DpcMigrationAttempt>

Sonucu sarmalayan bir ListenableFuture. Bu, şunlardan biri olabilir: Başarılı olmak koşuluyla, başarılı bir gelecek DpcMigrationAttempt sarmalaması. Arayan cihaz Sahibi veya Profil Sahibi değilse SecurityException için sarmalama yapılamadı. Taşıma jetonu boşsa, notificationServiceComponentName, manifest'te dışa aktarılan NotificationReceiverService öğesini genişleten geçerli bir bileşene işaret etmiyorsa ya da adminComponentName, geçerli pakete ait etkin bir yönetici değilse IllegalArgumentException gelecekteki sarmalama başarısız oldu. dpc taşımayla ilgili çağrı başarısız olduysa DpcMigrationException gelecekteki sarmalama başarısız oldu. İleti ve istisnanın alt türü, hatayla ilgili daha fazla ayrıntı içerir.

migrateDeviceManagementToAndroidManagementApiAwait

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

Bu cihazı Android Management API tarafından yönetilecek yere taşıyın.

Taşıma işlemi tamamlandıktan sonra, arama uygulaması Android Device Policy'ye aktarıldığı için Cihaz Sahibi veya Profil Sahibi ayrıcalıklarını kaybeder.

Uyarı: Bu işlem geri alınamaz. Bu askıya alma eğlencesi, Android Device Policy isteği alıp taşıma jetonuyla ilgili ön kontrolleri tamamladığında geri gelir. Başarısızlık durumunda bir Exception atılır.

Bu yöntem yalnızca Cihaz Sahibi veya Profil Sahibi tarafından çağrılabilir. Android 10 ve önceki sürümlerde bu çağrı, hem cihaz sahibi hem de profil sahibi olan cihazlarda çağrılmamalıdır.

Kişiye ait bir cihazda, yapılandırılmış kablosuz ağların DpcMigrationRequest uygulamasında Profil Sahibi tarafından (Android 12 hariç) iletilmesi gerekir (cihazda kablosuz ağ yapılandırıldıysa). Bu kimlikler şirkete ait cihazlarda verilmemelidir. Bu kablosuz ağların, cihaz yönetimi Android Device Policy'ye taşınmasından hemen önce kaldırılacağını unutmayın. Bir ağın kaldırılamaması durumunda taşıma işlemi de başarısız olur. Ağların kaldırılması atomik bir işlem olmadığından bazı ağlar zaten kaldırılmış olabilir.

Android 12 çalıştıran bir iş profiline sahip şahsa ait cihazlarda, migrationRequest ürününde iletilen kablosuz ağlardan bağımsız olarak, çağrı yapan DPC tarafından yapılandırılan tüm kablosuz ağlar cihaz yönetiminin Android Device Policy'ye taşınmasından hemen önce kaldırılır.

Parametreler
@NonNull ComponentName notificationServiceComponentName	NotificationReceiverService süresini kapsayan hizmetin ComponentName. Bu, çağrı uygulamasına ait olan ve manifest dosyasında dışa aktarılan geçerli bir bileşen olmalıdır. Aksi takdirde bir IllegalArgumentException yayınlanır.
@NonNull ComponentName adminComponentName	Arayan DPC'nin ComponentName yöneticisinin DeviceAdminReceiver.
@NonNull DpcMigrationRequest migrationRequest	Taşıma jetonunu ve yapılandırılmış kablosuz ağları içeren DpcMigrationRequest. İkinci yöntem yalnızca, arayan kişi kendisine ait bir cihazda Profil Sahibi ise ve herhangi bir ağı yapılandırmışsa gereklidir.

İlerlemeler
@NonNull DpcMigrationAttempt	Başarılı olması durumunda taşımanın mevcut durumuyla birlikte DpcMigrationException.

Dekoratif yastıklar
java.lang.SecurityException	Arayan kişi bir Cihaz Sahibi veya Profil Sahibi değilse.
java.lang.IllegalArgumentException	Taşıma jetonu boşsa veya notificationServiceComponentName, manifestte dışa aktarılan NotificationReceiverService öğesini genişleten geçerli bir bileşene işaret etmiyorsa ya da adminComponentName, geçerli pakete ait etkin bir yönetici değilse.
com.google.android.managementapi.dpcmigration.DpcMigrationException	Dpc taşımayla ilgili arama başarısız olduysa. İleti ve istisnanın alt türü, hatayla ilgili daha fazla ayrıntı içerir.