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

Test d'instrumentation

public class InstrumentationTest
extends Object implements IAbiReceiver, IConfigurationReceiver, IDeviceTest, IMetricCollectorReceiver, IRemoteTest, ITestCollector

java.lang.Object
↳	com.android.tradefed.testtype.InstrumentationTest.

Sous-classes directes connues

AndroidJUnitTest et CodeCoverageTest

AndroidJUnitTest	Test qui exécute un package de test d'instrumentation sur un appareil donné à l'aide de la classe android.support.test.runner.AndroidJUnitRunner
Tests de la couverture de code	Un test qui exécute un package de test d'instrumentation sur un appareil donné et génère le rapport de couverture de code.

Test qui exécute un package de test d'instrumentation sur un appareil donné.

Résumé

Champs
`public static final String`	`RUN_TESTS_AS_USER_KEY`
`public static final String`	`RUN_TESTS_ON_SDK_SANDBOX`
`protected boolean`	`mDebug`
`protected boolean`	`mInstrumentSdkInSandbox`
`protected boolean`	`mInstrumentSdkSandbox`

Constructeurs publics
`InstrumentationTest()`

Méthodes publiques
`void`	`addDeviceListeners( extraListeners)` Permet d'ajouter des écouteurs personnalisés à l'exécuteur.
`void`	`addInstrumentationArg(String key, String value)` Ajoutez un argument à fournir lors de l'exécution des tests d'instrumentation.
`IAbi`	`getAbi()`
`IConfiguration`	`getConfiguration()` Récupère les `IConfiguration` pour ce test.
`String`	`getCoverageTarget()` Obtenez la couvertureTarget précédemment définie via `setCoverageTarget(String)`.
`boolean`	`getDebug()` Obtenir le paramètre de débogage d'instrumentation
`ITestDevice`	`getDevice()` Faites tester l'appareil.
`String`	`getForceAbi()`
`long`	`getMaxTimeout()` Renvoie le délai d'expiration maximal défini pour l'instrumentation.
`String`	`getPackageName()` Obtenez le package manifeste Android à exécuter.
`String`	`getRunName()` Obtenir le nom d'exécution de test personnalisé qui sera fourni à l'écouteur
`String`	`getRunnerName()` Récupère l'exécuteur d'instrumentation Android à utiliser.
`boolean`	`isOrchestrator()` Affiche la valeur de `ERROR(InstrumentationTest#mOrchestrator/com.android.tradefed.testtype.InstrumentationTest#mOrchestrator InstrumentationTest#mOrchestrator)`.
`void`	`run(TestInformation testInfo, ITestInvocationListener listener)` Exécute les tests et communique les résultats à l'écouteur.
`void`	`setAbi(IAbi abi)`
`void`	`setClassName(String testClassName)` Vous pouvez également définir le nom de la classe de test à exécuter.
`void`	`setCollectTestsOnly(boolean shouldCollectTest)` Active ou désactive le mode de collecte test
`void`	`setCollectsTestsShellTimeout(int timeout)` Cette méthode est obsolète. Cette méthode est une opération no-op
`void`	`setConfiguration(IConfiguration config)` Il injecte les `IConfiguration` en cours d'utilisation.
`void`	`setCoverageTarget(String coverageTarget)` Définissez la couverture cible de ce test.
`void`	`setDebug(boolean debug)` Définissez le paramètre de débogage de l'instrumentation.
`void`	`setDevice(ITestDevice device)` Injectez l'appareil testé.
`void`	`setEnforceFormat(boolean enforce)` Définissez "True" si nous appliquons le format de sortie AJUR de l'instrumentation.
`void`	`setForceAbi(String abi)` Définit l'option de force-abi.
`void`	`setInstallFile(File installFile)` Définissez le fichier facultatif à installer qui contient les tests.
`void`	`setIsolatedStorage(boolean isolatedStorage)` Indiquez si vous souhaitez utiliser le stockage isolé.
`void`	`setMethodName(String testMethodName)` Si vous le souhaitez, définissez la méthode de test à exécuter.
`void`	`setMetricCollectors( collectors)` Définit la liste des objets `IMetricCollector` définis pour l'exécution du test.
`void`	`setOrchestrator(boolean useOrchestrator)` Définit l'option --orchestrator
`void`	`setPackageName(String packageName)` Définissez le package manifeste Android à exécuter.
`void`	`setReRunUsingTestFile(boolean reRunUsingTestFile)` Définit l'option "--rerun-from-file".
`void`	`setRerunMode(boolean rerun)` Vous pouvez également définir le mode de réexécution.
`void`	`setRunName(String runName)` Définit le nom d'exécution de test personnalisé qui sera fourni à l'écouteur
`void`	`setRunnerName(String runnerName)` Si vous le souhaitez, définissez l'exécuteur d'instrumentation Android à utiliser.
`void`	`setShellTimeout(long timeout)` Vous pouvez également définir le délai maximal (en millisecondes) attendu pour la sortie de l'interface système de l'appareil.
`void`	`setTestFilePathOnDevice(String testFilePathOnDevice)` Si vous le souhaitez, définissez le chemin d'accès à un fichier situé sur le périphérique qui doit contenir une liste de lignes méthodes et classes de test séparées (format: com.foo.Class#method) à exécuter.
`void`	`setTestPackageName(String testPackageName)` Définit le filtre de package de test.
`void`	`setTestSize(String size)` Vous pouvez également définir la taille du test à exécuter.
`void`	`setTestTimeout(long timeout)` Vous pouvez également définir la durée maximale (en millisecondes) de chaque exécution de test.
`void`	`setTestsToRun( tests)` Définissez la collection de tests à exécuter par cet InstrumentationTest.
`void`	`setWindowAnimation(boolean windowAnimation)`

Méthodes protégées
`static`	`excludeNonExecuted(TestRunResult results)` Filtrer "NOT_EXECUTED" et "Ignoré" pour déterminer ce qui doit être réexécuté.
`String`	`getClassName()` Obtenez le nom de la classe à exécuter.
`ListInstrumentationParser`	`getListInstrumentationParser()` Obtenir le `ListInstrumentationParser` utilisé pour analyser "pm list instrumentation" requêtes.
`String`	`getMethodName()` Obtenez la méthode de test à exécuter.
`String`	`getTestPackageName()` Obtenez le package Java de test à exécuter.
`String`	`queryRunnerName()` Interrogez l'appareil pour qu'un lanceur de test puisse l'utiliser.
`void`	`setRunnerArgs(IRemoteAndroidTestRunner runner)`

Champs

EXÉCUTER_TESTS_AS_USER_KEY

public static final String RUN_TESTS_AS_USER_KEY

EXÉCUTER_TESTS_ON_SDK_SANDBOX

public static final String RUN_TESTS_ON_SDK_SANDBOX

mDebug

protected boolean mDebug

mInstrumentSdkInSandbox

protected boolean mInstrumentSdkInSandbox

mInstrumentSdkSandbox

protected boolean mInstrumentSdkSandbox

Constructeurs publics

Test d'instrumentation

public InstrumentationTest ()

Méthodes publiques

addDeviceListeners

public void addDeviceListeners ( extraListeners)

Permet d'ajouter d'autres écouteurs personnalisés à l'exécuteur.

Paramètres
`extraListeners`

addInstrumentationArg

public void addInstrumentationArg (String key, 
                String value)

Ajoutez un argument à fournir lors de l'exécution des tests d'instrumentation.

Paramètres
`key`	`String`: nom de l'argument
`value`	`String`: valeur de l'argument

getAbi

public IAbi getAbi ()

Renvoie
`IAbi`

getConfiguration

public IConfiguration getConfiguration ()

Récupère les IConfiguration pour ce test.

Renvoie
`IConfiguration`

getcoverTarget

public String getCoverageTarget ()

Obtenez la couvertureTarget précédemment définie via setCoverageTarget(String).

Renvoie
`String`

getDebug

public boolean getDebug ()

Obtenir le paramètre de débogage d'instrumentation

Renvoie
`boolean`	Paramètre de débogage booléen.

getDevice

public ITestDevice getDevice ()

Faites tester l'appareil.

Renvoie
`ITestDevice`	l'/le/la `ITestDevice`

getForceAbi

public String getForceAbi ()

Renvoie
`String`

getMaxTimeout

public long getMaxTimeout ()

Renvoie le délai d'expiration maximal défini pour l'instrumentation.

Renvoie
`long`

getPackageName

public String getPackageName ()

Obtenez le package manifeste Android à exécuter.

Renvoie
`String`

getRunName

public String getRunName ()

Obtenir le nom d'exécution de test personnalisé qui sera fourni à l'écouteur

Renvoie
`String`

NomgetRunner

public String getRunnerName ()

Récupère l'exécuteur d'instrumentation Android à utiliser.

Renvoie
`String`

isOrchestrator

public boolean isOrchestrator ()

Affiche la valeur de ERROR(InstrumentationTest#mOrchestrator/com.android.tradefed.testtype.InstrumentationTest#mOrchestrator InstrumentationTest#mOrchestrator).

Renvoie
`boolean`

Exécuter

public void run (TestInformation testInfo, 
                ITestInvocationListener listener)

Exécute les tests et communique les résultats à l'écouteur.

Paramètres
`testInfo`	`TestInformation`: objet `TestInformation` contenant des informations utiles à exécuter tests.
`listener`	`ITestInvocationListener`: `ITestInvocationListener` des résultats du test

Génère
`DeviceNotAvailableException`

setAbi

public void setAbi (IAbi abi)

Paramètres
`abi`	`IAbi`

setClassName

public void setClassName (String testClassName)

Vous pouvez également définir le nom de la classe de test à exécuter.

Paramètres
`testClassName`	`String`

setCollectTestsOnly

public void setCollectTestsOnly (boolean shouldCollectTest)

Active ou désactive le mode de collecte test

setCollectsTestsShellTimeout

public void setCollectsTestsShellTimeout (int timeout)

Cette méthode est obsolète.
Cette méthode est une opération no-op

Définissez le délai maximal en ms pour autoriser le "délai maximal de réponse de l'interface système" lors de la collecte tests.

Paramètres
`timeout`	`int`

Définir une configuration

public void setConfiguration (IConfiguration config)

Il injecte les IConfiguration en cours d'utilisation.

Paramètres
`config`	`IConfiguration`

setcoverTarget

public void setCoverageTarget (String coverageTarget)

Définissez la couverture cible de ce test.

Actuellement inutilisé. Cette méthode est simplement présente, ce qui permet de récupérer la valeur couvertureTarget ultérieurement via getCoverageTarget()

Paramètres
`coverageTarget`	`String`

setDebug

public void setDebug (boolean debug)

Définissez le paramètre de débogage de l'instrumentation.

Paramètres
`debug`	`boolean`: valeur booléenne sur laquelle définir le paramètre de débogage d'instrumentation.

Définir l'appareil

public void setDevice (ITestDevice device)

Injectez l'appareil testé.

Paramètres
`device`	`ITestDevice`: `ITestDevice` à utiliser

setEnforceFormat

public void setEnforceFormat (boolean enforce)

Définissez "True" si nous appliquons le format de sortie AJUR de l'instrumentation.

Paramètres
`enforce`	`boolean`

setForceAbi

public void setForceAbi (String abi)

Définit l'option de force-abi.

setInstallFile

public void setInstallFile (File installFile)

Définissez le fichier facultatif à installer qui contient les tests.

Paramètres
`installFile`	`File`: `ERROR(/File)` installable

setIsolatedStorage

public void setIsolatedStorage (boolean isolatedStorage)

Indiquez si vous souhaitez utiliser le stockage isolé.

Paramètres
`isolatedStorage`	`boolean`

setMethodName

public void setMethodName (String testMethodName)

Si vous le souhaitez, définissez la méthode de test à exécuter.

Paramètres
`testMethodName`	`String`

setMetricCollectors

public void setMetricCollectors ( collectors)

Définit la liste des objets IMetricCollector définis pour l'exécution du test.

Paramètres
`collectors`

setOrchestrator

public void setOrchestrator (boolean useOrchestrator)

Définit l'option --orchestrator

Paramètres
`useOrchestrator`	`boolean`

setPackageName

public void setPackageName (String packageName)

Définissez le package manifeste Android à exécuter.

Paramètres
`packageName`	`String`

setReRunUsingTestFile

public void setReRunUsingTestFile (boolean reRunUsingTestFile)

Définit l'option "--rerun-from-file".

Paramètres
`reRunUsingTestFile`	`boolean`

Définir le mode de réexécution

public void setRerunMode (boolean rerun)

Vous pouvez également définir le mode de réexécution.

Paramètres
`rerun`	`boolean`

setRunName

public void setRunName (String runName)

Définit le nom d'exécution de test personnalisé qui sera fourni à l'écouteur

Paramètres
`runName`	`String`

Nom de l'exécuteur (setRunner)

public void setRunnerName (String runnerName)

Si vous le souhaitez, définissez l'exécuteur d'instrumentation Android à utiliser.

Paramètres
`runnerName`	`String`

setShellTimeout

public void setShellTimeout (long timeout)

Vous pouvez également définir le délai maximal (en millisecondes) attendu pour la sortie de l'interface système de l'appareil.

Paramètres
`timeout`	`long`

setTestFilePathOnDevice

public void setTestFilePathOnDevice (String testFilePathOnDevice)

Si vous le souhaitez, définissez le chemin d'accès à un fichier situé sur le périphérique qui doit contenir une liste de lignes méthodes et classes de test séparées (format: com.foo.Class#method) à exécuter. S'il est défini, tentera automatiquement d'exécuter de nouveau des tests avec ce fichier de test via InstrumentationFileTest au lieu d'exécuter des commandes adb distinctes pour chaque test restant. via une réexécution.

Paramètres
`testFilePathOnDevice`	`String`

setTestPackageName

public void setTestPackageName (String testPackageName)

Définit le filtre de package de test.

Si la valeur n'est pas "null", seuls les tests du package Java donné seront exécutés.

Sera ignoré si une valeur non nulle a été fournie à setClassName(String)

Paramètres
`testPackageName`	`String`

setTestSize

public void setTestSize (String size)

Vous pouvez également définir la taille du test à exécuter.

Paramètres
`size`	`String`

setTestTimeout

public void setTestTimeout (long timeout)

Vous pouvez également définir la durée maximale (en millisecondes) de chaque exécution de test.

Paramètres
`timeout`	`long`

setTestsToRun

public void setTestsToRun ( tests)

Définissez la collection de tests à exécuter par cet InstrumentationTest.

Paramètres
`tests`	: tests à exécuter

setWindowAnimation

public void setWindowAnimation (boolean windowAnimation)

Paramètres
`windowAnimation`	`boolean`

Méthodes protégées

ExclureNonExécuté

protected static  excludeNonExecuted (TestRunResult results)

Filtrer "NOT_EXECUTED" et "Ignoré" pour déterminer ce qui doit être réexécuté.

Paramètres
`results`	`TestRunResult`

Renvoie

getClassName

protected String getClassName ()

Obtenez le nom de la classe à exécuter.

Renvoie
`String`

getListInstrumentationParser

protected ListInstrumentationParser getListInstrumentationParser ()

Obtenir le ListInstrumentationParser utilisé pour analyser "pm list instrumentation" requêtes.

Renvoie
`ListInstrumentationParser`

getMethodName

protected String getMethodName ()

Obtenez la méthode de test à exécuter.

Renvoie
`String`

GetTestPackageName

protected String getTestPackageName ()

Obtenez le package Java de test à exécuter.

Renvoie
`String`

Nom de l'exécuteur de requête

protected String queryRunnerName ()

Interrogez l'appareil pour qu'un lanceur de test puisse l'utiliser.

Renvoie
`String`	le nom du premier lanceur de test correspondant au package ou la valeur "null" si nous n'en trouvons pas.

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

setRunnerArgs

protected void setRunnerArgs (IRemoteAndroidTestRunner runner)

Paramètres
`runner`	`IRemoteAndroidTestRunner`