À partir de 2026, pour nous aligner sur notre modèle de développement stable et garantir la stabilité de la plate-forme pour l'écosystème, nous publierons le code source sur AOSP au deuxième et au quatrième trimestre. Pour créer et contribuer à AOSP, nous vous recommandons d'utiliser android-latest-release au lieu de aosp-main. La branche de fichier manifeste android-latest-release fera toujours référence à la version la plus récente envoyée à AOSP. Pour en savoir plus, consultez Modifications apportées à AOSP.

NativeDeviceStateMonitor

public class NativeDeviceStateMonitor
extends Object implements IDeviceStateMonitor

java.lang.Object
↳	com.android.tradefed.device.NativeDeviceStateMonitor

Sous-classes directes connues

DeviceStateMonitor

DeviceStateMonitor Classe d'assistance pour surveiller l'état d'un IDevice.

Sous-classes indirectes connues

NestedDeviceStateMonitor

NestedDeviceStateMonitor Moniteur d'état de l'appareil qui exécute des vérifications supplémentaires sur l'appareil imbriqué pour tenir compte des spécificités de l'environnement virtualisé.

Classe d'assistance pour surveiller l'état d'un IDevice sans compatibilité avec le framework.

Résumé

Constantes
`long`	`MAX_CHECK_POLL_TIME`
`int`	`MAX_OP_TIME` Durée maximale de l'opération en millisecondes pour une commande "poll for responsiveness" (interroger pour vérifier la réactivité)
`String`	`PERM_DENIED_ERROR_PATTERN`

Constructeurs publics
`NativeDeviceStateMonitor(IDeviceManager mgr, IDevice device, boolean fastbootEnabled)`

Méthodes publiques
`void`	`attachFinalState(TestDeviceState finalState)` Associez un état final pour annuler waitForDeviceState si cet état est atteint.
`void`	`clearTcpFastbootMonitor()` Effacez tout état dans le gestionnaire d'appareils.
`TestDeviceState`	`getDeviceState()` Obtient l'état de l'appareil.
`String`	`getFastbootSerialNumber()` Récupère le numéro de série du mode Fastboot.
`String`	`getMountPoint(String mountName)` Renvoie un point de montage.
`String`	`getSerialNumber()` Obtient le numéro de série de l'appareil.
`boolean`	`isAdbTcp()`
`void`	`setDefaultAvailableTimeout(long timeoutMs)` Définissez le délai d'attente en millisecondes pour qu'un appareil soit disponible dans `waitForDeviceAvailable()`.
`void`	`setDefaultOnlineTimeout(long timeoutMs)` Définissez le temps d'attente en millisecondes pour qu'un appareil soit en ligne dans `waitForDeviceOnline()`.
`void`	`setFastbootSerialNumber(String serial)` Définissez le numéro de série du mode Fastboot.
`void`	`setIDevice(IDevice newDevice)` Met à jour l'iDevice actuel.
`void`	`setSkipBootComplete(boolean skipBootComplete)`
`void`	`setState(TestDeviceState deviceState)` Définit l'état actuel de l'appareil.
`boolean`	`waitForBootComplete(long waitTime)` Bloque l'exécution jusqu'à ce que l'indicateur de démarrage complet de l'appareil soit défini.
`IDevice`	`waitForDeviceAvailable(long waitTime)` Attend que l'appareil soit réactif et disponible pour les tests.
`IDevice`	`waitForDeviceAvailable()` Attend que l'appareil soit réactif et disponible pour les tests.
`IDevice`	`waitForDeviceAvailableInRecoverPath(long waitTime)` Variante spéciale de `waitForDeviceAvailable(long)` à appeler pendant le chemin de récupération pour adapter la gestion.
`boolean`	`waitForDeviceBootloader(long time)` Attend que l'appareil soit dans le bootloader.
`void`	`waitForDeviceBootloaderStateUpdate()` Attend que l'état du bootloader de l'appareil soit actualisé
`boolean`	`waitForDeviceFastbootd(String fastbootPath, long time)` Attend que l'appareil soit en mode fastbootd.
`IDevice`	`waitForDeviceInRecovery()` Attend que l'appareil soit en mode Récupération en utilisant le délai d'attente de démarrage standard.
`boolean`	`waitForDeviceInRecovery(long waitTime)` Attend que l'appareil soit en état "adb recovery"
`boolean`	`waitForDeviceInSideload(long waitTime)` Attend que l'appareil soit en état "adb sideload"
`boolean`	`waitForDeviceNotAvailable(long waitTime)` Attend que l'appareil ne soit plus disponible
`IDevice`	`waitForDeviceOnline()` Attend que l'appareil soit en ligne en utilisant le délai d'attente de démarrage standard.
`IDevice`	`waitForDeviceOnline(long waitTime)` Attend que l'appareil soit en ligne.
`boolean`	`waitForDeviceShell(long waitTime)` Attend que l'appareil réponde à une commande shell adb de base.

Méthodes protégées
`CollectingOutputReceiver`	`createOutputReceiver()` Exposé pour les tests
`long`	`getCheckPollTime()` Exposé pour les tests
`long`	`getCurrentTime()` Exposé pour les tests
`IDevice`	`getIDevice()`
`boolean`	`postOnlineCheck(long waitTime)` Vérifications supplémentaires à effectuer sur un appareil en ligne
`boolean`	`waitForStoreMount(long waitTime)` Attend que la mémoire externe de l'appareil soit installée.

Constantes

MAX_CHECK_POLL_TIME

protected static final long MAX_CHECK_POLL_TIME

Valeur constante : 3000 (0x0000000000000bb8)

MAX_OP_TIME

protected static final int MAX_OP_TIME

Durée maximale de l'opération en millisecondes pour une commande "poll for responsiveness" (interroger pour vérifier la réactivité)

Valeur constante : 10000 (0x00002710)

PERM_DENIED_ERROR_PATTERN

protected static final String PERM_DENIED_ERROR_PATTERN

Valeur constante : "Permission denied"

Constructeurs publics

NativeDeviceStateMonitor

public NativeDeviceStateMonitor (IDeviceManager mgr, 
                IDevice device, 
                boolean fastbootEnabled)

Paramètres
`mgr`	`IDeviceManager`
`device`	`IDevice`
`fastbootEnabled`	`boolean`

Méthodes publiques

attachFinalState

public void attachFinalState (TestDeviceState finalState)

Associez un état final pour annuler waitForDeviceState si cet état est atteint.

Paramètres
`finalState`	`TestDeviceState`

clearTcpFastbootMonitor

public void clearTcpFastbootMonitor ()

Effacez tout état dans le gestionnaire d'appareils.

getDeviceState

public TestDeviceState getDeviceState ()

Obtient l'état de l'appareil.

Renvoie
`TestDeviceState`	le `TestDeviceState` de l'appareil

getFastbootSerialNumber

public String getFastbootSerialNumber ()

Récupère le numéro de série du mode Fastboot.

Renvoie
`String`

getMountPoint

public String getMountPoint (String mountName)

Renvoie un point de montage.

Interroge directement l'appareil si les informations mises en cache dans IDevice ne sont pas disponibles.

À FAIRE : déplacer ce comportement vers IDevice.getMountPoint(String)

Paramètres
`mountName`	`String` : nom du point de montage

Renvoie
`String`	le point d'installation ou `null`

Génère
`DeviceNotAvailableException`

getSerialNumber

public String getSerialNumber ()

Obtient le numéro de série de l'appareil.

Renvoie
`String`

isAdbTcp

public boolean isAdbTcp ()

Renvoie
`boolean`

setDefaultAvailableTimeout

public void setDefaultAvailableTimeout (long timeoutMs)

Définissez le délai d'attente en millisecondes pour qu'un appareil soit disponible dans waitForDeviceAvailable().

Paramètres
`timeoutMs`	`long`

setDefaultOnlineTimeout

public void setDefaultOnlineTimeout (long timeoutMs)

Définissez le temps d'attente en millisecondes pour qu'un appareil soit en ligne dans waitForDeviceOnline().

Paramètres
`timeoutMs`	`long`

setFastbootSerialNumber

public void setFastbootSerialNumber (String serial)

Définissez le numéro de série du mode Fastboot.

Paramètres
`serial`	`String`

setIDevice

public void setIDevice (IDevice newDevice)

Met à jour l'iDevice actuel.

setSkipBootComplete

public void setSkipBootComplete (boolean skipBootComplete)

Paramètres
`skipBootComplete`	`boolean`

setState

public void setState (TestDeviceState deviceState)

Définit l'état actuel de l'appareil.

waitForBootComplete

public boolean waitForBootComplete (long waitTime)

Bloque l'exécution jusqu'à ce que l'indicateur de démarrage complet de l'appareil soit défini.

Paramètres
`waitTime`	`long` : délai d'attente en ms

Renvoie
`boolean`

waitForDeviceAvailable

public IDevice waitForDeviceAvailable (long waitTime)

Attend que l'appareil soit réactif et disponible pour les tests. Actuellement, cela signifie que le gestionnaire de packages et le stockage externe sont disponibles.

Paramètres
`waitTime`	`long` : temps d'attente en ms.

Renvoie
`IDevice`	le `IDevice` si l'appareil se reconnecte avant l'expiration du délai. `null` dans les autres cas.

waitForDeviceAvailable

public IDevice waitForDeviceAvailable ()

Attend que l'appareil soit réactif et disponible pour les tests.

Équivalent à waitForDeviceAvailable(long), mais utilise le délai d'expiration du démarrage de l'appareil par défaut.

Renvoie
`IDevice`	le `IDevice` si l'appareil se reconnecte avant l'expiration du délai. `null` dans les autres cas.

waitForDeviceAvailableInRecoverPath

public IDevice waitForDeviceAvailableInRecoverPath (long waitTime)

Variante spéciale de waitForDeviceAvailable(long) à appeler pendant le chemin de récupération pour adapter la gestion.

Paramètres
`waitTime`	`long`

Renvoie
`IDevice`

Génère
`DeviceNotAvailableException`

waitForDeviceBootloader

public boolean waitForDeviceBootloader (long time)

Attend que l'appareil soit dans le bootloader.

Paramètres
`time`	`long` : durée d'attente maximale en ms

Renvoie
`boolean`	`true` si l'appareil est dans le bootloader avant l'expiration du délai

waitForDeviceBootloaderStateUpdate

public void waitForDeviceBootloaderStateUpdate ()

Attend que l'état du bootloader de l'appareil soit actualisé

waitForDeviceFastbootd

public boolean waitForDeviceFastbootd (String fastbootPath, 
                long time)

Attend que l'appareil soit en mode fastbootd.

Paramètres
`fastbootPath`	`String` : chemin d'accès au binaire fastboot à utiliser.
`time`	`long` : durée d'attente maximale en ms

Renvoie
`boolean`	`true` si l'appareil est en mode fastbootd avant l'expiration du délai

waitForDeviceInRecovery

public IDevice waitForDeviceInRecovery ()

Attend que l'appareil soit en mode Récupération en utilisant le délai d'attente de démarrage standard.

Renvoie
`IDevice`	`IDevice` si l'appareil est récupéré avant l'expiration du délai. `null` dans le cas contraire.

waitForDeviceInRecovery

public boolean waitForDeviceInRecovery (long waitTime)

Attend que l'appareil soit en état "adb recovery"

Paramètres
`waitTime`	`long` : durée d'attente maximale en ms

Renvoie
`boolean`	"True" si l'appareil est en mode Récupération avant le délai d'expiration, "False" dans le cas contraire.

waitForDeviceInSideload

public boolean waitForDeviceInSideload (long waitTime)

Attend que l'appareil soit en état "adb sideload"

Paramètres
`waitTime`	`long` : durée d'attente maximale en ms

Renvoie
`boolean`	"True" si l'appareil est en mode Sideload avant le délai d'expiration, "False" dans le cas contraire.

waitForDeviceNotAvailable

public boolean waitForDeviceNotAvailable (long waitTime)

Attend que l'appareil ne soit plus disponible

Paramètres
`waitTime`	`long` : durée d'attente maximale en ms

Renvoie
`boolean`	`true` si l'appareil devient indisponible

waitForDeviceOnline

public IDevice waitForDeviceOnline ()

Attend que l'appareil soit en ligne en utilisant le délai d'attente de démarrage standard.

Remarque : Cette méthode sera renvoyée une fois que l'appareil sera visible via DDMS. Cela ne garantit pas que l'appareil répond effectivement aux commandes adb. Utilisez plutôt waitForDeviceAvailable().

Renvoie
`IDevice`	le `IDevice` si l'appareil se reconnecte avant l'expiration du délai. `null` dans les autres cas.

waitForDeviceOnline

public IDevice waitForDeviceOnline (long waitTime)

Attend que l'appareil soit en ligne.

Paramètres
`waitTime`	`long` : durée d'attente maximale en ms

Renvoie
`IDevice`	le `IDevice` si l'appareil se reconnecte avant l'expiration du délai. `null` dans les autres cas.

waitForDeviceShell

public boolean waitForDeviceShell (long waitTime)

Attend que l'appareil réponde à une commande shell adb de base.

Paramètres
`waitTime`	`long` : temps d'attente en ms.

Renvoie
`boolean`	`true` si l'appareil redevient réactif avant l'expiration de `waitTime`.

Méthodes protégées

createOutputReceiver

protected CollectingOutputReceiver createOutputReceiver ()

Exposé pour les tests

Renvoie
`CollectingOutputReceiver`	`CollectingOutputReceiver`

getCheckPollTime

protected long getCheckPollTime ()

Exposé pour les tests

Renvoie
`long`

getCurrentTime

protected long getCurrentTime ()

Exposé pour les tests

Renvoie
`long`

getIDevice

protected IDevice getIDevice ()

Renvoie
`IDevice`	Associer `IDevice` au moniteur d'état

postOnlineCheck

protected boolean postOnlineCheck (long waitTime)

Vérifications supplémentaires à effectuer sur un appareil en ligne

Paramètres
`waitTime`	`long` : délai d'attente en ms avant l'abandon.

Renvoie
`boolean`	`true` si les vérifications réussissent avant l'expiration de waitTime. Sinon, `false`.

Génère
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

waitForStoreMount

protected boolean waitForStoreMount (long waitTime)

Attend que la mémoire externe de l'appareil soit installée.

Paramètres
`waitTime`	`long` : délai d'attente en ms avant l'abandon.

Renvoie
`boolean`	`true` si le magasin externe est monté avant l'expiration de waitTime. Sinon, `false`.

Génère
`DeviceNotAvailableException`