DpcMigrationClient

public interface DpcMigrationClient

Le client peut envoyer des demandes liées à la migration DPC.

Résumé

Méthodes publiques
abstract @NonNull ListenableFuture<DpcMigrationAttempt>
getMigrationAttempt(
    @NonNull GetDpcMigrationAttemptRequest getMigrationAttemptRequest
)

Récupère une tentative de migration.
abstract DpcMigrationAttempt
getMigrationAttemptAwait(
    @NonNull GetDpcMigrationAttemptRequest getMigrationAttemptRequest
)

Récupère une tentative de migration.
abstract @NonNull ListenableFuture<@NonNull List<@NonNull DpcMigrationAttempt>>

Renvoie la liste de toutes les tentatives de migration.
abstract @NonNull List<@NonNull DpcMigrationAttempt>

Renvoie la liste de toutes les tentatives de migration.
abstract @NonNull ListenableFuture<@NonNull DpcMigrationAttempt>
migrateDeviceManagementToAndroidManagementApi(
    @NonNull ComponentName notificationServiceComponentName,
    @NonNull ComponentName adminComponentName,
    @NonNull DpcMigrationRequest migrationRequest
)

Migrez cet appareil pour qu'il soit géré par l'API Android Management.
abstract @NonNull DpcMigrationAttempt
migrateDeviceManagementToAndroidManagementApiAwait(
    @NonNull ComponentName notificationServiceComponentName,
    @NonNull ComponentName adminComponentName,
    @NonNull DpcMigrationRequest migrationRequest
)

Migrez cet appareil pour qu'il soit géré par l'API Android Management.

Méthodes publiques

getMigrationAttempt

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

Récupère une tentative de migration.

Si aucun nom n'est spécifié dans GetDpcMigrationAttemptRequest, le DpcMigrationAttempt le plus récent est renvoyé.

Cette méthode ne peut être appelée que par un propriétaire de l'appareil ou du profil, ou par un ancien propriétaire de l'appareil ou du profil qui a migré vers l'API Android Management.

Renvoie
@NonNull ListenableFuture<DpcMigrationAttempt>

Un ListenableFuture encapsulant le résultat. Vous décidez

  • Un avenir réussi encapsulant un DpcMigrationAttempt, en cas de succès.

  • Un avenir réussi enveloppant null, au cas où DpcMigrationAttempt n'est pas trouvé.

  • Un échec futur encapsulant un SecurityException, au cas où l'appelant n'est pas un propriétaire de l'appareil ou un propriétaire du profil, ou un ancien propriétaire de l'appareil ou du profil qui a migré vers l'API Android Management.

  • Un futur échec encapsulant DpcMigrationException si l'appel lié à la migration DPC a échoué. Le message et le sous-type de l'exception contiennent plus de détails sur l'échec.

getMigrationAttemptAwait

abstract DpcMigrationAttempt getMigrationAttemptAwait(
    @NonNull GetDpcMigrationAttemptRequest getMigrationAttemptRequest
)

Récupère une tentative de migration.

Si aucun nom n'est spécifié dans GetDpcMigrationAttemptRequest, le DpcMigrationAttempt le plus récent est renvoyé.

Cette méthode ne peut être appelée que par un propriétaire de l'appareil ou du profil, ou par un ancien propriétaire de l'appareil ou du profil qui a migré vers l'API Android Management.

Renvoie
DpcMigrationAttempt

La valeur DpcMigrationAttempt demandée ou null si elle est introuvable
Génère
SecurityException

Si l'appelant n'est pas un propriétaire de l'appareil ou du profil, ou un ancien propriétaire de l'appareil ou du profil ayant migré vers l'API Android Management.
DpcMigrationException

Si l'appel lié à la migration du DPC a échoué. Le message et le sous-type de l'exception contiennent plus de détails sur l'échec.

listMigrationAttempts

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

Renvoie la liste de toutes les tentatives de migration.

Cette méthode ne peut être appelée que par un propriétaire de l'appareil ou du profil, ou par un ancien propriétaire de l'appareil ou du profil qui a migré vers l'API Android Management. Remarque : Les tentatives de migration plus anciennes sont supprimées automatiquement et ne sont pas renvoyées.

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

Un ListenableFuture encapsulant le résultat. Vous décidez

  • Un avenir réussi encapsulant une liste de DpcMigrationAttempt, en cas de succès.

  • Un échec futur encapsulant un SecurityException, au cas où l'appelant n'est pas un propriétaire de l'appareil ou un propriétaire du profil, ou un ancien propriétaire de l'appareil ou du profil qui a migré vers l'API Android Management.

  • Un futur échec encapsulant DpcMigrationException si l'appel lié à la migration DPC a échoué. Le message et le sous-type de l'exception contiennent plus de détails sur l'échec.

listMigrationAttemptsAwait

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

Renvoie la liste de toutes les tentatives de migration.

Cette méthode ne peut être appelée que par un propriétaire de l'appareil ou du profil, ou par un ancien propriétaire de l'appareil ou du profil qui a migré vers l'API Android Management. Remarque : Les tentatives de migration plus anciennes sont supprimées automatiquement et ne sont pas renvoyées.

Renvoie
@NonNull List<@NonNull DpcMigrationAttempt>

Liste des DpcMigrationAttempt
Génère
SecurityException

Si l'appelant n'est pas un propriétaire de l'appareil ou du profil, ou un ancien propriétaire de l'appareil ou du profil ayant migré vers l'API Android Management.
DpcMigrationException

Si l'appel lié à la migration du DPC a échoué. Le message et le sous-type de l'exception contiennent plus de détails sur l'échec.

migrateDeviceManagementToAndroidManagementApi

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

Migrez cet appareil pour qu'il soit géré par l'API Android Management.

Une fois la migration terminée, l'application d'appel perd ses droits de propriétaire de l'appareil ou du profil, car ils sont transférés à Android Device Policy.

Attention : Cette action est irréversible. La ListenableFuture renvoyée se termine lorsque Android Device Policy a reçu la requête et effectué les vérifications préliminaires sur le jeton de migration. En cas d'échec, ListenableFuture encapsule une Exception.

Cette méthode ne peut être appelée que par un propriétaire de l'appareil ou du profil. Sur Android 10 et versions antérieures, cette méthode ne doit pas être appelée sur un appareil avec un propriétaire de l'appareil et un propriétaire du profil.

Les réseaux Wi-Fi configurés doivent être transmis dans DpcMigrationRequest par le propriétaire du profil (sauf sur Android 12) sur un appareil personnel s'il a configuré des réseaux Wi-Fi. Ces valeurs ne doivent pas être transmises sur un appareil appartenant à l'entreprise. Notez que ces réseaux Wi-Fi seront supprimés juste avant la migration de la gestion des appareils vers Android Device Policy. Si la suppression d'un réseau échoue, la migration échouera également. Étant donné que la suppression des réseaux n'est pas une opération atomique, il est possible que certains réseaux aient déjà été supprimés.

Sur les appareils personnels disposant d'un profil professionnel et fonctionnant sous Android 12, tous les réseaux Wi-Fi configurés par le DPC appelant seront supprimés juste avant la migration de la gestion des appareils vers Android Device Policy, quels que soient les réseaux Wi-Fi transmis dans migrationRequest.

Paramètres
@NonNull ComponentName notificationServiceComponentName

Le ComponentName du service étendant NotificationReceiverService. Il doit s'agir d'un composant valide appartenant à l'application appelante et exporté dans le fichier manifeste. Sinon, une IllegalArgumentException sera générée.
@NonNull ComponentName adminComponentName

ComponentName de l'administrateur DeviceAdminReceiver du DPC appelant.
@NonNull DpcMigrationRequest migrationRequest

Le DpcMigrationRequest contenant le jeton de migration et les réseaux Wi-Fi configurés. Ces derniers ne sont requis que si l'appelant est le propriétaire du profil sur un appareil personnel et qu'il a configuré des réseaux.
Renvoie
@NonNull ListenableFuture<@NonNull DpcMigrationAttempt>

Un ListenableFuture encapsulant le résultat. Vous décidez

migrateDeviceManagementToAndroidManagementApiAwait

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

Migrez cet appareil pour qu'il soit géré par l'API Android Management.

Une fois la migration terminée, l'application d'appel perd ses droits de propriétaire de l'appareil ou du profil, car ils sont transférés à Android Device Policy.

Attention : Cette action est irréversible. Cette fonction de suspension renvoie une valeur lorsque Android Device Policy a reçu la requête et effectué les vérifications préliminaires sur le jeton de migration. En cas d'échec, une Exception est générée.

Cette méthode ne peut être appelée que par un propriétaire de l'appareil ou du profil. Sur Android 10 et versions antérieures, cette méthode ne doit pas être appelée sur un appareil avec un propriétaire de l'appareil et un propriétaire du profil.

Les réseaux Wi-Fi configurés doivent être transmis dans DpcMigrationRequest par le propriétaire du profil (sauf sur Android 12) sur un appareil personnel s'il a configuré des réseaux Wi-Fi. Ces valeurs ne doivent pas être transmises sur un appareil appartenant à l'entreprise. Notez que ces réseaux Wi-Fi seront supprimés juste avant la migration de la gestion des appareils vers Android Device Policy. Si la suppression d'un réseau échoue, la migration échouera également. Étant donné que la suppression des réseaux n'est pas une opération atomique, il est possible que certains réseaux aient déjà été supprimés.

Sur les appareils personnels disposant d'un profil professionnel et fonctionnant sous Android 12, tous les réseaux Wi-Fi configurés par le DPC appelant seront supprimés juste avant la migration de la gestion des appareils vers Android Device Policy, quels que soient les réseaux Wi-Fi transmis dans migrationRequest.

Paramètres
@NonNull ComponentName notificationServiceComponentName

Le ComponentName du service étendant NotificationReceiverService. Il doit s'agir d'un composant valide appartenant à l'application appelante et exporté dans le fichier manifeste. Sinon, une IllegalArgumentException sera générée.
@NonNull ComponentName adminComponentName

ComponentName de l'administrateur DeviceAdminReceiver du DPC appelant.
@NonNull DpcMigrationRequest migrationRequest

Le DpcMigrationRequest contenant le jeton de migration et les réseaux Wi-Fi configurés. Ces derniers ne sont requis que si l'appelant est le propriétaire du profil sur un appareil personnel et qu'il a configuré des réseaux.
Renvoie
@NonNull DpcMigrationAttempt

DpcMigrationException avec l'état actuel de la migration en cas de réussite.
Génère
SecurityException

Si l'appelant n'est pas le propriétaire de l'appareil ni celui du profil.
IllegalArgumentException

Si le jeton de migration est vide, ou si notificationServiceComponentName ne fait pas référence à un composant valide étendant NotificationReceiverService qui est exporté dans le fichier manifeste, ou si adminComponentName n'est pas un administrateur actif appartenant au package actuel.
DpcMigrationException

Si l'appel lié à la migration du DPC a échoué. Le message et le sous-type de l'exception contiennent plus de détails sur l'échec.