À partir du 27 mars 2025, nous vous recommandons d'utiliser android-latest-release au lieu de aosp-main pour créer et contribuer à AOSP. Pour en savoir plus, consultez la section Modifications apportées à AOSP.

Cette page a été traduite par l'API Cloud Translation.

DeviceTestRunOptions

public class DeviceTestRunOptions
extends Object

java.lang.Object
↳	com.android.tradefed.testtype.junit4.DeviceTestRunOptions

Classe de compilateur pour les options liées à l'exécution de tests d'appareil via BaseHostJUnit4Test.

Résumé

Constructeurs publics
`DeviceTestRunOptions(String packageName)`

Méthodes publiques
`DeviceTestRunOptions`	`addExtraListener(ITestLifeCycleReceiver listener)` Ajoutez un écouteur supplémentaire à l'instrumentation en cours d'exécution.
`DeviceTestRunOptions`	`addInstrumentationArg(String key, String value)` Ajoutez un argument qui sera transmis à l'instrumentation.
`void`	`clearExtraListeners()`
`void`	`clearInstrumentationArgs()` Effacez tous les arguments d'instrumentation qui ont été définis précédemment avec `addInstrumentationArg(String, String)`.
`String`	`getApkFileName()` Renvoie le nom du fichier APK pour l'installation de l'APK.
`ITestDevice`	`getDevice()`
	`getExtraListeners()`
`String[]`	`getInstallArgs()` Affiche les options supplémentaires de la commande d'installation.
	`getInstrumentationArgs()`
`Long`	`getMaxInstrumentationTimeoutMs()`
`Long`	`getMaxTimeToOutputMs()`
`String`	`getPackageName()`
`String`	`getRunner()`
`String`	`getTestClassName()`
`String`	`getTestMethodName()`
`Long`	`getTestTimeoutMs()`
`Integer`	`getUserId()`
`boolean`	`isForceQueryable()` Indique si l'APK à installer doit être interrogeable ou non.
`boolean`	`isGrantPermission()` Indique si des autorisations doivent être accordées pour l'installation de l'APK.
`boolean`	`isHiddenApiCheckDisabled()`
`boolean`	`isIsolatedStorageDisabled()`
`boolean`	`isRestartDisabled()`
`boolean`	`isTestApiCheckDisabled()`
`boolean`	`isWindowAnimationDisabled()`
`DeviceTestRunOptions`	`setApkFileName(String apkFileName)` Définit le nom du fichier APK pour l'installation de l'APK.
`DeviceTestRunOptions`	`setCheckResults(boolean checkResults)` Indique si les résultats de l'exécution de l'instrumentation doivent être vérifiés et s'il faut s'assurer qu'aucun échec ne s'est produit.
`DeviceTestRunOptions`	`setDevice(ITestDevice device)`
`DeviceTestRunOptions`	`setDisableHiddenApiCheck(boolean disableHiddenApiCheck)` Indique si les vérifications d'API masquées doivent être ajoutées ou non à l'instrument "am" utilisé côté hôte.
`DeviceTestRunOptions`	`setDisableIsolatedStorage(boolean disableIsolatedStorage)` Définit si l'option --no-isolated-storage doit être ajoutée à l'instrument "am" utilisé côté hôte.
`DeviceTestRunOptions`	`setDisableRestart(boolean disableRestart)` Indique si --no-restart doit être ajouté à l'instrument "am" utilisé côté hôte.
`DeviceTestRunOptions`	`setDisableTestApiCheck(boolean disableTestApiCheck)` Détermine si l'option --no-test-api-access doit être ajoutée ou non à l'instrument "am" utilisé côté hôte.
`DeviceTestRunOptions`	`setDisableWindowAnimation(boolean disableWindowAnimation)` indique si l'option --no-window-animation doit être ajoutée ou non à l'instrument "am" utilisé côté hôte.
`DeviceTestRunOptions`	`setForceQueryable(boolean forceQueryable)` Définit `false` si l'APK à installer ne doit pas être interrogé.
`DeviceTestRunOptions`	`setGrantPermission(boolean grantPermission)` Accorde les autorisations pour l'installation de l'APK.
`DeviceTestRunOptions`	`setInstallArgs(String... installArgs)` Définit des options supplémentaires de la commande d'installation.
`DeviceTestRunOptions`	`setMaxInstrumentationTimeoutMs(Long maxInstrumentationTimeoutMs)` Définit la durée maximale (en millisecondes) pendant laquelle l'instrumentation complète doit s'exécuter et se terminer.
`DeviceTestRunOptions`	`setMaxTimeToOutputMs(Long maxTimeToOutputMs)` Définit la durée maximale (en millisecondes) pendant laquelle l'instrumentation peut arrêter la sortie avant d'être arrêtée.
`DeviceTestRunOptions`	`setRunner(String runner)` Définit le programme d'exécution d'instrumentation à utiliser pour exécuter l'instrumentation.
`DeviceTestRunOptions`	`setTestClassName(String testClassName)` Définit le nom de classe que l'instrumentation doit exécuter.
`DeviceTestRunOptions`	`setTestMethodName(String testMethodName)` Définit le nom de la méthode que l'instrumentation doit exécuter.
`DeviceTestRunOptions`	`setTestTimeoutMs(Long testTimeoutMs)` Définit la durée maximale (en millisecondes) pendant laquelle un test peut s'exécuter avant d'être interrompu.
`DeviceTestRunOptions`	`setUserId(Integer userId)` Définit l'ID utilisateur pour lequel l'instrumentation doit s'exécuter.
`boolean`	`shouldCheckResults()`

Constructeurs publics

DeviceTestRunOptions

public DeviceTestRunOptions (String packageName)

Paramètres
`packageName`	`String`

Méthodes publiques

addExtraListener

public DeviceTestRunOptions addExtraListener (ITestLifeCycleReceiver listener)

Ajoutez un écouteur supplémentaire à l'instrumentation en cours d'exécution.

Paramètres
`listener`	`ITestLifeCycleReceiver`

Renvoie
`DeviceTestRunOptions`

addInstrumentationArg

public DeviceTestRunOptions addInstrumentationArg (String key, 
                String value)

Ajoutez un argument qui sera transmis à l'instrumentation.

Paramètres
`key`	`String`
`value`	`String`

Renvoie
`DeviceTestRunOptions`

clearExtraListeners

public void clearExtraListeners ()

clearInstrumentationArgs

public void clearInstrumentationArgs ()

Effacez tous les arguments d'instrumentation qui ont été définis précédemment avec addInstrumentationArg(String, String).

getApkFileName

public String getApkFileName ()

Renvoie le nom du fichier APK pour l'installation de l'APK.

Renvoie
`String`

getDevice

public ITestDevice getDevice ()

Renvoie
`ITestDevice`

getExtraListeners

public  getExtraListeners ()

Renvoie

getInstallArgs

public String[] getInstallArgs ()

Affiche les options supplémentaires de la commande d'installation.

Renvoie
`String[]`

getInstrumentationArgs

public  getInstrumentationArgs ()

Renvoie

getMaxInstrumentationTimeoutMs

public Long getMaxInstrumentationTimeoutMs ()

Renvoie
`Long`

getMaxTimeToOutputMs

public Long getMaxTimeToOutputMs ()

Renvoie
`Long`

getPackageName

public String getPackageName ()

Renvoie
`String`

getRunner

public String getRunner ()

Renvoie
`String`

getTestClassName

public String getTestClassName ()

Renvoie
`String`

getTestMethodName

public String getTestMethodName ()

Renvoie
`String`

getTestTimeoutMs

public Long getTestTimeoutMs ()

Renvoie
`Long`

getUserId

public Integer getUserId ()

Renvoie
`Integer`

isForceQueryable

public boolean isForceQueryable ()

Indique si l'APK à installer doit être interrogeable ou non. La valeur par défaut est "true" (vrai).

Renvoie
`boolean`

isGrantPermission

public boolean isGrantPermission ()

Indique si des autorisations doivent être accordées pour l'installation de l'APK.

Renvoie
`boolean`

isHiddenApiCheckDisabled

public boolean isHiddenApiCheckDisabled ()

Renvoie
`boolean`

isIsolatedStorageDisabled

public boolean isIsolatedStorageDisabled ()

Renvoie
`boolean`

isRestartDisabled

public boolean isRestartDisabled ()

Renvoie
`boolean`

isTestApiCheckDisabled

public boolean isTestApiCheckDisabled ()

Renvoie
`boolean`

isWindowAnimationDisabled

public boolean isWindowAnimationDisabled ()

Renvoie
`boolean`

setApkFileName

public DeviceTestRunOptions setApkFileName (String apkFileName)

Définit le nom du fichier APK pour l'installation de l'APK.

Paramètres
`apkFileName`	`String`

Renvoie
`DeviceTestRunOptions`

setCheckResults

public DeviceTestRunOptions setCheckResults (boolean checkResults)

Indique si les résultats de l'exécution de l'instrumentation doivent être vérifiés et s'il faut s'assurer qu'aucun échec ne s'est produit.

Paramètres
`checkResults`	`boolean`

Renvoie
`DeviceTestRunOptions`

setDevice

public DeviceTestRunOptions setDevice (ITestDevice device)

Paramètres
`device`	`ITestDevice`

Renvoie
`DeviceTestRunOptions`

setDisableHiddenApiCheck

public DeviceTestRunOptions setDisableHiddenApiCheck (boolean disableHiddenApiCheck)

Indique si les vérifications d'API masquées doivent être ajoutées ou non à l'instrument "am" utilisé côté hôte.

Paramètres
`disableHiddenApiCheck`	`boolean`

Renvoie
`DeviceTestRunOptions`

setDisableIsolatedStorage

public DeviceTestRunOptions setDisableIsolatedStorage (boolean disableIsolatedStorage)

Définit si l'option --no-isolated-storage doit être ajoutée à l'instrument "am" utilisé côté hôte.

Paramètres
`disableIsolatedStorage`	`boolean`

Renvoie
`DeviceTestRunOptions`

setDisableRestart

public DeviceTestRunOptions setDisableRestart (boolean disableRestart)

Indique si --no-restart doit être ajouté à l'instrument "am" utilisé côté hôte.

Paramètres
`disableRestart`	`boolean`

Renvoie
`DeviceTestRunOptions`

setDisableTestApiCheck

public DeviceTestRunOptions setDisableTestApiCheck (boolean disableTestApiCheck)

Détermine si l'option --no-test-api-access doit être ajoutée ou non à l'instrument "am" utilisé côté hôte.

Paramètres
`disableTestApiCheck`	`boolean`

Renvoie
`DeviceTestRunOptions`

setDisableWindowAnimation

public DeviceTestRunOptions setDisableWindowAnimation (boolean disableWindowAnimation)

indique si l'option --no-window-animation doit être ajoutée ou non à l'instrument "am" utilisé côté hôte.

Paramètres
`disableWindowAnimation`	`boolean`

Renvoie
`DeviceTestRunOptions`

setForceQueryable

public DeviceTestRunOptions setForceQueryable (boolean forceQueryable)

Définit false si l'APK à installer ne doit pas être interrogé.

Paramètres
`forceQueryable`	`boolean`

Renvoie
`DeviceTestRunOptions`

setGrantPermission

public DeviceTestRunOptions setGrantPermission (boolean grantPermission)

Accorde les autorisations pour l'installation de l'APK.

Paramètres
`grantPermission`	`boolean`

Renvoie
`DeviceTestRunOptions`

setInstallArgs

public DeviceTestRunOptions setInstallArgs (String... installArgs)

Définit des options supplémentaires de la commande d'installation.

Paramètres
`installArgs`	`String`

Renvoie
`DeviceTestRunOptions`

setMaxInstrumentationTimeoutMs

public DeviceTestRunOptions setMaxInstrumentationTimeoutMs (Long maxInstrumentationTimeoutMs)

Définit la durée maximale (en millisecondes) pendant laquelle l'instrumentation complète doit s'exécuter et se terminer. Définissez la valeur sur 0 pour qu'il n'y ait pas de délai avant expiration. Facultatif.

Paramètres
`maxInstrumentationTimeoutMs`	`Long`

Renvoie
`DeviceTestRunOptions`

setMaxTimeToOutputMs

public DeviceTestRunOptions setMaxTimeToOutputMs (Long maxTimeToOutputMs)

Définit la durée maximale (en millisecondes) pendant laquelle l'instrumentation peut arrêter la sortie avant d'être arrêtée. Définissez la valeur sur 0 pour qu'il n'y ait pas de délai avant expiration. Facultatif.

Paramètres
`maxTimeToOutputMs`	`Long`

Renvoie
`DeviceTestRunOptions`

setRunner

public DeviceTestRunOptions setRunner (String runner)

Définit le programme d'exécution d'instrumentation à utiliser pour exécuter l'instrumentation. L'exécuteur par défaut est "android.support.test.runner.AndroidJUnitRunner". Facultatif.

Paramètres
`runner`	`String`

Renvoie
`DeviceTestRunOptions`

setTestClassName

public DeviceTestRunOptions setTestClassName (String testClassName)

Définit le nom de classe que l'instrumentation doit exécuter. L'instrumentation sera filtrée pour n'exécuter que la classe. Peut être utilisé avec setTestMethodName(String). Facultatif.

Paramètres
`testClassName`	`String`

Renvoie
`DeviceTestRunOptions`

setTestMethodName

public DeviceTestRunOptions setTestMethodName (String testMethodName)

Définit le nom de la méthode que l'instrumentation doit exécuter. setTestClassName(String) doit être défini pour que cette fonctionnalité fonctionne correctement. Facultatif.

Paramètres
`testMethodName`	`String`

Renvoie
`DeviceTestRunOptions`

setTestTimeoutMs

public DeviceTestRunOptions setTestTimeoutMs (Long testTimeoutMs)

Définit la durée maximale (en millisecondes) pendant laquelle un test peut s'exécuter avant d'être interrompu. Définissez la valeur sur 0 pour qu'il n'y ait pas de délai avant expiration. Facultatif.

Paramètres
`testTimeoutMs`	`Long`

Renvoie
`DeviceTestRunOptions`

setUserId

public DeviceTestRunOptions setUserId (Integer userId)

Définit l'ID utilisateur pour lequel l'instrumentation doit s'exécuter. Facultatif.

Paramètres
`userId`	`Integer`

Renvoie
`DeviceTestRunOptions`

shouldCheckResults

public boolean shouldCheckResults ()

Renvoie
`boolean`