DpcMigrationClient

public interface DpcMigrationClient

Client per effettuare richieste relative alla migrazione Dpc.

Riepilogo

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

Riceve un tentativo di migrazione.
abstract DpcMigrationAttempt
getMigrationAttemptAwait(
    @NonNull GetDpcMigrationAttemptRequest getMigrationAttemptRequest
)

Riceve un tentativo di migrazione.
abstract @NonNull ListenableFuture<@NonNull List<@NonNull DpcMigrationAttempt>>

Restituisce un elenco di tutti i tentativi di migrazione.
abstract @NonNull List<@NonNull DpcMigrationAttempt>

Restituisce un elenco di tutti i tentativi di migrazione.
abstract @NonNull ListenableFuture<@NonNull DpcMigrationAttempt>
migrateDeviceManagementToAndroidManagementApi(
    @NonNull ComponentName notificationServiceComponentName,
    @NonNull ComponentName adminComponentName,
    @NonNull DpcMigrationRequest migrationRequest
)

Esegui la migrazione di questo dispositivo alla gestione tramite l'API Android Management.
abstract @NonNull DpcMigrationAttempt
migrateDeviceManagementToAndroidManagementApiAwait(
    @NonNull ComponentName notificationServiceComponentName,
    @NonNull ComponentName adminComponentName,
    @NonNull DpcMigrationRequest migrationRequest
)

Esegui la migrazione di questo dispositivo alla gestione tramite l'API Android Management.

Metodi pubblici

getMigrationAttempt

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

Riceve un tentativo di migrazione.

Se non viene specificato alcun nome in GetDpcMigrationAttemptRequest, viene restituito il DpcMigrationAttempt più recente.

Questo metodo può essere chiamato solo da un proprietario del dispositivo o del profilo oppure da un proprietario del dispositivo o profilo precedente di cui è stata eseguita la migrazione all'API Android Management.

Resi
@NonNull ListenableFuture<DpcMigrationAttempt>

Un elemento ListenableFuture che aggrega il risultato. Può essere

  • In caso di successo, avrai a disposizione un DpcMigrationAttempt finale per il futuro.

  • Un valore nullo per il wrapping futuro riuscito, nel caso in cui DpcMigrationAttempt non venga trovato.

  • Un futuro non riuscito per il wrapping di un SecurityException, nel caso in cui il chiamante non sia un proprietario del dispositivo o del profilo oppure un proprietario precedente del dispositivo o del profilo di cui è stata eseguita la migrazione all'API Android Management.

  • Un wrapping futuro non riuscito per DpcMigrationException in caso di chiamata relativa alla migrazione Dpc non riuscita. Il messaggio e il sottotipo dell'eccezione contengono ulteriori dettagli sull'errore.

getMigrationAttemptAwait

abstract DpcMigrationAttempt getMigrationAttemptAwait(
    @NonNull GetDpcMigrationAttemptRequest getMigrationAttemptRequest
)

Riceve un tentativo di migrazione.

Se non viene specificato alcun nome in GetDpcMigrationAttemptRequest, viene restituito il DpcMigrationAttempt più recente.

Questo metodo può essere chiamato solo da un proprietario del dispositivo o del profilo oppure da un proprietario del dispositivo o profilo precedente di cui è stata eseguita la migrazione all'API Android Management.

Resi
DpcMigrationAttempt

Il valore DpcMigrationAttempt richiesto o nullo, se non è possibile trovarlo
Lanci
java.lang.SecurityException

Se il chiamante non è un proprietario del dispositivo o del profilo oppure un proprietario precedente del dispositivo o del profilo di cui è stata eseguita la migrazione all'API Android Management.
com.google.android.managementapi.dpcmigration.DpcMigrationException

Se la chiamata relativa alla migrazione Dpc non è riuscita. Il messaggio e il sottotipo dell'eccezione contengono ulteriori dettagli sull'errore.

listMigrationAttempts

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

Restituisce un elenco di tutti i tentativi di migrazione.

Questo metodo può essere chiamato solo da un proprietario del dispositivo o del profilo oppure da un proprietario del dispositivo o profilo precedente di cui è stata eseguita la migrazione all'API Android Management. Nota: i tentativi di migrazione meno recenti vengono eliminati automaticamente e non vengono restituiti.

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

Un elemento ListenableFuture che aggrega il risultato. Può essere

  • In caso di successo, un futuro aggrega un elenco di DpcMigrationAttempt.

  • Un futuro non riuscito per il wrapping di un SecurityException, nel caso in cui il chiamante non sia un proprietario del dispositivo o del profilo oppure un proprietario precedente del dispositivo o del profilo di cui è stata eseguita la migrazione all'API Android Management.

  • Un wrapping futuro non riuscito per DpcMigrationException in caso di chiamata relativa alla migrazione Dpc non riuscita. Il messaggio e il sottotipo dell'eccezione contengono ulteriori dettagli sull'errore.

listMigrationAttemptsAwait

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

Restituisce un elenco di tutti i tentativi di migrazione.

Questo metodo può essere chiamato solo da un proprietario del dispositivo o del profilo oppure da un proprietario del dispositivo o profilo precedente di cui è stata eseguita la migrazione all'API Android Management. Nota: i tentativi di migrazione meno recenti vengono eliminati automaticamente e non vengono restituiti.

Resi
@NonNull List<@NonNull DpcMigrationAttempt>

Un elenco di DpcMigrationAttempt
Lanci
java.lang.SecurityException

Se il chiamante non è un proprietario del dispositivo o del profilo oppure un proprietario precedente del dispositivo o del profilo di cui è stata eseguita la migrazione all'API Android Management.
com.google.android.managementapi.dpcmigration.DpcMigrationException

Se la chiamata relativa alla migrazione Dpc non è riuscita. Il messaggio e il sottotipo dell'eccezione contengono ulteriori dettagli sull'errore.

migrateDeviceManagementToAndroidManagementApi

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

Esegui la migrazione di questo dispositivo alla gestione tramite l'API Android Management.

Al termine della migrazione, l'app per le chiamate perderà i privilegi di Proprietario dispositivo o Proprietario del profilo, che vengono trasferiti ad Android Device Policy.

Attenzione: questa operazione non può essere annullata. AscoltaableFuture restituito viene completato quando Android Device Policy ha ricevuto la richiesta e completato i controlli preliminari sul token di migrazione. In caso di errore, ListenableFuture aggrega un Exception.

Questo metodo può essere chiamato solo da un proprietario del dispositivo o del profilo. Su Android 10 e versioni precedenti, questa funzionalità non deve essere chiamata su un dispositivo con un proprietario del dispositivo e un proprietario del profilo.

Le reti Wi-Fi configurate devono essere trasmesse in DpcMigrationRequest dal proprietario del profilo (ad eccezione di Android 12) su un dispositivo di proprietà personale se sono state configurate reti Wi-Fi. Questi dati non devono essere trasmessi su un dispositivo di proprietà dell'azienda. Tieni presente che queste reti Wi-Fi verranno rimosse poco prima della migrazione della gestione dispositivi ad Android Device Policy. In caso di errore della rimozione di una rete, anche la migrazione avrà esito negativo e, poiché la rimozione delle reti non è un'operazione atomica, alcune reti potrebbero essere già state rimosse.

Sui dispositivi di proprietà personale con un profilo di lavoro su cui è installato Android 12, tutte le reti Wi-Fi configurate dal DPC per le chiamate verranno rimosse poco prima della migrazione della gestione dispositivi ad Android Device Policy, indipendentemente dalle reti Wi-Fi trasmesse in migrationRequest.

Parametri
@NonNull ComponentName notificationServiceComponentName

Il ComponentName del servizio che estende NotificationReceiverService. Deve essere un componente valido appartenente all'app chiamante ed esportato nel file manifest, altrimenti verrà generato un IllegalArgumentException.
@NonNull ComponentName adminComponentName

Il ComponentName dell'amministratore DeviceAdminReceiver del DPC chiamante.
@NonNull DpcMigrationRequest migrationRequest

Lo strumento DpcMigrationRequest contenente il token di migrazione e le reti Wi-Fi configurate. Questi ultimi sono necessari solo se il chiamante è il proprietario del profilo su un dispositivo di proprietà personale e ha configurato qualsiasi rete.
Resi
@NonNull ListenableFuture<@NonNull DpcMigrationAttempt>

Un elemento ListenableFuture che aggrega il risultato. Può essere

  • In caso di successo, avrai a disposizione un DpcMigrationAttempt finale per il futuro.

  • Un tentativo futuro non riuscito per il wrapping di un SecurityException, se il chiamante non è un proprietario del dispositivo o del profilo.

  • Un futuro wrapping di IllegalArgumentException non riuscito per il wrapping, se il token di migrazione è vuoto o se notificationServiceComponentName non fa riferimento a un componente valido che estende NotificationReceiverService esportato nel manifest o se adminComponentName non è un amministratore attivo appartenente al pacchetto attuale.

  • Un tentativo futuro non riuscito per il wrapping di un DpcMigrationException, se la chiamata relativa alla migrazione Compute Engine non è andata a buon fine. Il messaggio e il sottotipo dell'eccezione contengono ulteriori dettagli sull'errore.

migrateDeviceManagementToAndroidManagementApiAwait

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

Esegui la migrazione di questo dispositivo alla gestione tramite l'API Android Management.

Al termine della migrazione, l'app per le chiamate perderà i privilegi di Proprietario dispositivo o Proprietario del profilo, che vengono trasferiti ad Android Device Policy.

Attenzione: questa operazione non può essere annullata. Questa funzionalità sospende i resi divertenti quando Android Device Policy ha ricevuto la richiesta e completato i controlli preliminari sul token di migrazione. In caso di errore, viene generato un valore Exception.

Questo metodo può essere chiamato solo da un proprietario del dispositivo o del profilo. Su Android 10 e versioni precedenti, questa funzionalità non deve essere chiamata su un dispositivo con un proprietario del dispositivo e un proprietario del profilo.

Le reti Wi-Fi configurate devono essere trasmesse in DpcMigrationRequest dal proprietario del profilo (ad eccezione di Android 12) su un dispositivo di proprietà personale se sono state configurate reti Wi-Fi. Questi dati non devono essere trasmessi su un dispositivo di proprietà dell'azienda. Tieni presente che queste reti Wi-Fi verranno rimosse poco prima della migrazione della gestione dispositivi ad Android Device Policy. In caso di errore della rimozione di una rete, anche la migrazione avrà esito negativo e, poiché la rimozione delle reti non è un'operazione atomica, alcune reti potrebbero essere già state rimosse.

Sui dispositivi di proprietà personale con un profilo di lavoro su cui è installato Android 12, tutte le reti Wi-Fi configurate dal DPC per le chiamate verranno rimosse poco prima della migrazione della gestione dispositivi ad Android Device Policy, indipendentemente dalle reti Wi-Fi trasmesse in migrationRequest.

Parametri
@NonNull ComponentName notificationServiceComponentName

Il ComponentName del servizio che estende NotificationReceiverService. Deve essere un componente valido appartenente all'app chiamante ed esportato nel file manifest, altrimenti verrà generato un IllegalArgumentException.
@NonNull ComponentName adminComponentName

Il ComponentName dell'amministratore DeviceAdminReceiver del DPC chiamante.
@NonNull DpcMigrationRequest migrationRequest

Lo strumento DpcMigrationRequest contenente il token di migrazione e le reti Wi-Fi configurate. Questi ultimi sono necessari solo se il chiamante è il proprietario del profilo su un dispositivo di proprietà personale e ha configurato qualsiasi rete.
Resi
@NonNull DpcMigrationAttempt

DpcMigrationException con lo stato attuale della migrazione in caso di esito positivo.
Lanci
java.lang.SecurityException

Se il chiamante non è il proprietario di un dispositivo o di un profilo.
java.lang.IllegalArgumentException

Se il token di migrazione è vuoto o se notificationServiceComponentName non fa riferimento a un componente valido che estende NotificationReceiverService che viene esportato nel manifest o se adminComponentName non è un amministratore attivo appartenente al pacchetto attuale.
com.google.android.managementapi.dpcmigration.DpcMigrationException

Se la chiamata relativa alla migrazione Dpc non è riuscita. Il messaggio e il sottotipo dell'eccezione contengono ulteriori dettagli sull'errore.