DpcMigrationClient

public interface DpcMigrationClient

Client für Anfragen zur dpc-Migration.

Zusammenfassung

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

Ruft einen Migrationsversuch ab.
abstract DpcMigrationAttempt
getMigrationAttemptAwait(
    @NonNull GetDpcMigrationAttemptRequest getMigrationAttemptRequest
)

Ruft einen Migrationsversuch ab.
abstract @NonNull ListenableFuture<@NonNull List<@NonNull DpcMigrationAttempt>>

Gibt eine Liste aller Migrationsversuche zurück.
abstract @NonNull List<@NonNull DpcMigrationAttempt>

Gibt eine Liste aller Migrationsversuche zurück.
abstract @NonNull ListenableFuture<@NonNull DpcMigrationAttempt>
migrateDeviceManagementToAndroidManagementApi(
    @NonNull ComponentName notificationServiceComponentName,
    @NonNull ComponentName adminComponentName,
    @NonNull DpcMigrationRequest migrationRequest
)

Migrieren Sie dieses Gerät, sodass es über die Android Management API verwaltet wird.
abstract @NonNull DpcMigrationAttempt
migrateDeviceManagementToAndroidManagementApiAwait(
    @NonNull ComponentName notificationServiceComponentName,
    @NonNull ComponentName adminComponentName,
    @NonNull DpcMigrationRequest migrationRequest
)

Migrieren Sie dieses Gerät, sodass es über die Android Management API verwaltet wird.

Öffentliche Methoden

getMigrationAttempt

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

Ruft einen Migrationsversuch ab.

Wenn in GetDpcMigrationAttemptRequest kein Name angegeben ist, wird der neueste DpcMigrationAttempt zurückgegeben.

Diese Methode kann nur von einem Geräteinhaber oder Profilinhaber oder früheren Geräteinhabern oder Profilinhabern aufgerufen werden, die zur Android Management API migriert sind.

Rückgaben
@NonNull ListenableFuture<DpcMigrationAttempt>

Ein ListenableFuture, der das Ergebnis umschließt. Dies kann Folgendes sein:

  • Ein erfolgreiches Future, das bei Erfolg ein DpcMigrationAttempt verpackt.

  • Ein erfolgreicher zukünftiger Wrapping-Null-Wert, falls DpcMigrationAttempt nicht gefunden wird.

  • Ein fehlgeschlagener zukünftiger Wrapping eines SecurityException, falls der Aufrufer kein Geräteinhaber oder Profilinhaber oder ein früherer Geräteinhaber oder Profilinhaber ist, der zur Android Management API migriert ist.

  • Ein zukünftiges Wrapping ist fehlgeschlagen. DpcMigrationException Wenn der Aufruf in Verbindung mit der dpc-Migration fehlgeschlagen ist. Die Nachricht und der Untertyp der Ausnahme enthalten weitere Details zum Fehler.

getMigrationAttemptAwait

abstract DpcMigrationAttempt getMigrationAttemptAwait(
    @NonNull GetDpcMigrationAttemptRequest getMigrationAttemptRequest
)

Ruft einen Migrationsversuch ab.

Wenn in GetDpcMigrationAttemptRequest kein Name angegeben ist, wird der neueste DpcMigrationAttempt zurückgegeben.

Diese Methode kann nur von einem Geräteinhaber oder Profilinhaber oder früheren Geräteinhabern oder Profilinhabern aufgerufen werden, die zur Android Management API migriert sind.

Rückgaben
DpcMigrationAttempt

Die angeforderte DpcMigrationAttempt oder null, wenn sie nicht gefunden werden kann
Löst aus
java.lang.SecurityException

Der Aufrufer ist kein Geräteinhaber oder Profilinhaber oder ein früherer Geräteinhaber oder Profilinhaber, der zur Android Management API migriert ist.
com.google.android.managementapi.dpcmigration.DpcMigrationException

Wenn der Aufruf in Bezug auf die dpc-Migration fehlgeschlagen ist. Die Nachricht und der Untertyp der Ausnahme enthalten weitere Details zum Fehler.

listMigrationAttempts

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

Gibt eine Liste aller Migrationsversuche zurück.

Diese Methode kann nur von einem Geräteinhaber oder Profilinhaber oder früheren Geräteinhabern oder Profilinhabern aufgerufen werden, die zur Android Management API migriert sind. Hinweis: Ältere Migrationsversuche werden automatisch gelöscht und nicht zurückgegeben.

Rückgaben
@NonNull ListenableFuture<@NonNull List<@NonNull DpcMigrationAttempt>>

Ein ListenableFuture, der das Ergebnis umschließt. Dies kann Folgendes sein:

  • Ein erfolgreiches Future-Objekt, das bei Erfolg eine Liste von DpcMigrationAttempt umschließt.

  • Ein fehlgeschlagener zukünftiger Wrapping eines SecurityException, falls der Aufrufer kein Geräteinhaber oder Profilinhaber oder ein früherer Geräteinhaber oder Profilinhaber ist, der zur Android Management API migriert ist.

  • Ein zukünftiges Wrapping ist fehlgeschlagen. DpcMigrationException Wenn der Aufruf in Verbindung mit der dpc-Migration fehlgeschlagen ist. Die Nachricht und der Untertyp der Ausnahme enthalten weitere Details zum Fehler.

listMigrationAttemptsAwait

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

Gibt eine Liste aller Migrationsversuche zurück.

Diese Methode kann nur von einem Geräteinhaber oder Profilinhaber oder früheren Geräteinhabern oder Profilinhabern aufgerufen werden, die zur Android Management API migriert sind. Hinweis: Ältere Migrationsversuche werden automatisch gelöscht und nicht zurückgegeben.

Rückgaben
@NonNull List<@NonNull DpcMigrationAttempt>

Eine Liste von DpcMigrationAttempt
Löst aus
java.lang.SecurityException

Der Aufrufer ist kein Geräteinhaber oder Profilinhaber oder ein früherer Geräteinhaber oder Profilinhaber, der zur Android Management API migriert ist.
com.google.android.managementapi.dpcmigration.DpcMigrationException

Wenn der Aufruf in Bezug auf die dpc-Migration fehlgeschlagen ist. Die Nachricht und der Untertyp der Ausnahme enthalten weitere Details zum Fehler.

migrateDeviceManagementToAndroidManagementApi

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

Migrieren Sie dieses Gerät, sodass es über die Android Management API verwaltet wird.

Nach Abschluss der Migration verliert die aufrufende App die Berechtigungen „Geräteinhaber“ oder „Profilinhaber“, da diese an die Android Device Policy übertragen werden.

Achtung: Dieser Vorgang kann nicht rückgängig gemacht werden. Das zurückgegebene ListenableFuture wird abgeschlossen, wenn die Android Device Policy die Anfrage erhalten und vorläufige Prüfungen des Migrationstokens abgeschlossen hat. Im Falle eines Fehlers fasst ListenableFuture ein Exception zusammen.

Diese Methode kann nur von einem Geräteinhaber oder Profilinhaber aufgerufen werden. Unter Android 10 und niedriger darf diese Aktion nicht auf einem Gerät aufgerufen werden, das sowohl einen Geräteinhaber als auch einen Profilinhaber hat.

Konfigurierte WLANs müssen in DpcMigrationRequest vom Profilinhaber (außer unter Android 12) auf einem privaten Gerät übergeben werden, wenn dort WLANs konfiguriert wurden. Sie dürfen nicht auf einem unternehmenseigenen Gerät weitergegeben werden. Beachten Sie, dass diese WLAN-Netzwerke entfernt werden, kurz bevor die Geräteverwaltung zu Android Device Policy migriert wird. Sollte ein Netzwerk nicht entfernt werden, schlägt die Migration ebenfalls fehl. Da das Entfernen der Netzwerke kein atomarer Vorgang ist, wurden einige Netzwerke möglicherweise bereits entfernt.

Auf privaten Geräten mit einem Arbeitsprofil mit Android 12 werden alle vom aufrufenden DPC konfigurierten WLANs entfernt, bevor die Geräteverwaltung zu Android Device Policy migriert wird. Dies gilt unabhängig von den in migrationRequest übergebenen WLANs.

Parameter
@NonNull ComponentName notificationServiceComponentName

Der ComponentName des Dienstes, der NotificationReceiverService erweitert. Es muss eine gültige Komponente sein, die zur aufrufenden App gehört. Sie muss im Manifest exportiert werden. Andernfalls wird ein IllegalArgumentException ausgelöst.
@NonNull ComponentName adminComponentName

Die ComponentName des Administrators DeviceAdminReceiver des aufrufenden DPC.
@NonNull DpcMigrationRequest migrationRequest

Die DpcMigrationRequest mit dem Migrationstoken und den konfigurierten WLANs. Letztere sind nur erforderlich, wenn der Aufrufer der Profilinhaber auf einem privaten Gerät ist und Netzwerke konfiguriert hat.
Rückgaben
@NonNull ListenableFuture<@NonNull DpcMigrationAttempt>

Ein ListenableFuture, der das Ergebnis umschließt. Dies kann Folgendes sein:

  • Ein erfolgreiches Future, das bei Erfolg ein DpcMigrationAttempt verpackt.

  • Ein fehlgeschlagener zukünftiger Wrapping eines SecurityException, wenn der Aufrufer kein Geräteinhaber oder Profilinhaber ist.

  • Ein zukünftiges Wrapping eines IllegalArgumentException ist fehlgeschlagen, wenn das Migrationstoken leer ist, wenn notificationServiceComponentName nicht auf eine gültige Komponente verweist, die NotificationReceiverService erweitert und im Manifest exportiert wird, oder wenn adminComponentName kein aktiver Administrator ist, der zum aktuellen Paket gehört.

  • Ein fehlgeschlagener zukünftiger Wrapping eines DpcMigrationException, wenn der Aufruf in Bezug auf die dpc-Migration fehlgeschlagen ist. Die Nachricht und der Untertyp der Ausnahme enthalten weitere Details zum Fehler.

migrateDeviceManagementToAndroidManagementApiAwait

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

Migrieren Sie dieses Gerät, sodass es über die Android Management API verwaltet wird.

Nach Abschluss der Migration verliert die aufrufende App die Berechtigungen „Geräteinhaber“ oder „Profilinhaber“, da diese an die Android Device Policy übertragen werden.

Achtung: Dieser Vorgang kann nicht rückgängig gemacht werden. Dieser „Unterbrechungsspaß“ wird zurückgegeben, wenn die Android Device Policy die Anfrage erhalten und vorläufige Prüfungen des Migrationstokens abgeschlossen hat. Im Falle eines Fehlers wird ein Exception ausgegeben.

Diese Methode kann nur von einem Geräteinhaber oder Profilinhaber aufgerufen werden. Unter Android 10 und niedriger darf diese Aktion nicht auf einem Gerät aufgerufen werden, das sowohl einen Geräteinhaber als auch einen Profilinhaber hat.

Konfigurierte WLANs müssen in DpcMigrationRequest vom Profilinhaber (außer unter Android 12) auf einem privaten Gerät übergeben werden, wenn dort WLANs konfiguriert wurden. Sie dürfen nicht auf einem unternehmenseigenen Gerät weitergegeben werden. Beachten Sie, dass diese WLAN-Netzwerke entfernt werden, kurz bevor die Geräteverwaltung zu Android Device Policy migriert wird. Sollte ein Netzwerk nicht entfernt werden, schlägt die Migration ebenfalls fehl. Da das Entfernen der Netzwerke kein atomarer Vorgang ist, wurden einige Netzwerke möglicherweise bereits entfernt.

Auf privaten Geräten mit einem Arbeitsprofil mit Android 12 werden alle vom aufrufenden DPC konfigurierten WLANs entfernt, bevor die Geräteverwaltung zu Android Device Policy migriert wird. Dies gilt unabhängig von den in migrationRequest übergebenen WLANs.

Parameter
@NonNull ComponentName notificationServiceComponentName

Der ComponentName des Dienstes, der NotificationReceiverService erweitert. Es muss eine gültige Komponente sein, die zur aufrufenden App gehört. Sie muss im Manifest exportiert werden. Andernfalls wird ein IllegalArgumentException ausgelöst.
@NonNull ComponentName adminComponentName

Die ComponentName des Administrators DeviceAdminReceiver des aufrufenden DPC.
@NonNull DpcMigrationRequest migrationRequest

Die DpcMigrationRequest mit dem Migrationstoken und den konfigurierten WLANs. Letztere sind nur erforderlich, wenn der Aufrufer der Profilinhaber auf einem privaten Gerät ist und Netzwerke konfiguriert hat.
Rückgaben
@NonNull DpcMigrationAttempt

DpcMigrationException durch den aktuellen Status der Migration bei Erfolg.
Löst aus
java.lang.SecurityException

Der Aufrufer ist weder ein Geräteinhaber noch ein Profilinhaber.
java.lang.IllegalArgumentException

Das Migrationstoken ist leer oder notificationServiceComponentName verweist nicht auf eine gültige Komponente, die NotificationReceiverService erweitert und im Manifest exportiert wird, oder wenn adminComponentName kein aktiver Administrator ist, der zum aktuellen Paket gehört.
com.google.android.managementapi.dpcmigration.DpcMigrationException

Wenn der Aufruf in Bezug auf die dpc-Migration fehlgeschlagen ist. Die Nachricht und der Untertyp der Ausnahme enthalten weitere Details zum Fehler.