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

InstrumentationTest

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, CodeCoverageTest

AndroidJUnitTest	Test qui exécute un package de test d'instrumentation sur un appareil donné à l'aide d'android.support.test.runner.AndroidJUnitRunner.
CodeCoverageTest	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 d'autres écouteurs personnalisés au coureur
`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 l'`IConfiguration` pour ce test.
`String`	`getCoverageTarget()` Récupérez le coverageTarget précédemment défini via `setCoverageTarget(String)`.
`boolean`	`getDebug()` Obtenez le paramètre de débogage d'instrumentation.
`ITestDevice`	`getDevice()` Obtenez l'appareil à tester.
`String`	`getForceAbi()`
`long`	`getMaxTimeout()` Renvoie le délai avant expiration maximal défini pour l'instrumentation.
`String`	`getPackageName()` Exécutez le package de fichier manifeste Android.
`String`	`getRunName()` Obtenir le nom de l'exécution de test personnalisée qui sera fourni à l'écouteur
`String`	`getRunnerName()` Récupère le programme d'exécution d'instrumentation Android à utiliser.
`boolean`	`isOrchestrator()` Renvoie 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 transmet les résultats à l'écouteur.
`void`	`setAbi(IAbi abi)`
`void`	`setClassName(String testClassName)` Vous pouvez éventuellement définir le nom de la classe de test à exécuter.
`void`	`setCollectTestsOnly(boolean shouldCollectTest)` Active ou désactive le mode de collecte de test
`void`	`setCollectsTestsShellTimeout(int timeout)` Cette méthode est obsolète. Cette méthode est une opération sans effet.
`void`	`setConfiguration(IConfiguration config)` Injecte le `IConfiguration` utilisé.
`void`	`setCoverageTarget(String coverageTarget)` Définissez la cible de couverture de ce test.
`void`	`setDebug(boolean debug)` Définissez le paramètre de débogage d'instrumentation.
`void`	`setDevice(ITestDevice device)` Injectez l'appareil testé.
`void`	`setEnforceFormat(boolean enforce)` Définissez la valeur sur "True" si nous appliquons le format de sortie AJUR de l'instrumentation.
`void`	`setForceAbi(String abi)` Définit l'option force-abi.
`void`	`setInstallFile(File installFile)` Définissez le fichier facultatif à installer contenant les tests.
`void`	`setIsolatedStorage(boolean isolatedStorage)` Définissez si vous souhaitez utiliser le stockage isolé.
`void`	`setMethodName(String testMethodName)` Vous pouvez éventuellement définir la méthode de test à exécuter.
`void`	`setMetricCollectors( collectors)` Définit la liste des `IMetricCollector` définis pour l'exécution de test.
`void`	`setOrchestrator(boolean useOrchestrator)` Définit l'option --orchestrator
`void`	`setPackageName(String packageName)` Définissez le package de fichier 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 rediffusion.
`void`	`setRunName(String runName)` Définissez le nom de l'exécution de test personnalisée qui sera fourni à l'écouteur.
`void`	`setRunnerName(String runnerName)` Vous pouvez éventuellement définir le programme d'exécution d'instrumentation Android à utiliser.
`void`	`setShellTimeout(long timeout)` Vous pouvez également définir la durée maximale (en millisecondes) d'attente de la sortie du shell de l'appareil.
`void`	`setTestFilePathOnDevice(String testFilePathOnDevice)` Vous pouvez également définir le chemin d'accès à un fichier situé sur l'appareil qui doit contenir une liste de classes et de méthodes de test (format: com.foo.Class#method) à exécuter.
`void`	`setTestPackageName(String testPackageName)` Définit le filtre du package de test.
`void`	`setTestSize(String size)` Vous pouvez également définir la taille du test à exécuter.
`void`	`setTestTimeout(long timeout)` Vous pouvez éventuellement définir la durée maximale (en millisecondes) pour chaque exécution de test.
`void`	`setTestsToRun( tests)` Définissez la collection de tests qui doivent être exécutés par cet InstrumentationTest.
`void`	`setWindowAnimation(boolean windowAnimation)`

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

Champs

RUN_TESTS_AS_USER_KEY

public static final String RUN_TESTS_AS_USER_KEY

RUN_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

InstrumentationTest

public InstrumentationTest ()

Méthodes publiques

addDeviceListeners

public void addDeviceListeners ( extraListeners)

Permet d'ajouter d'autres écouteurs personnalisés au coureur

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 l'IConfiguration pour ce test.

Renvoie
`IConfiguration`

getCoverageTarget

public String getCoverageTarget ()

Récupérez le coverageTarget précédemment défini via setCoverageTarget(String).

Renvoie
`String`

getDebug

public boolean getDebug ()

Obtenez le paramètre de débogage d'instrumentation.

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

getDevice

public ITestDevice getDevice ()

Obtenez l'appareil à tester.

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

getForceAbi

public String getForceAbi ()

Renvoie
`String`

getMaxTimeout

public long getMaxTimeout ()

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

Renvoie
`long`

getPackageName

public String getPackageName ()

Exécutez le package de fichier manifeste Android.

Renvoie
`String`

getRunName

public String getRunName ()

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

Renvoie
`String`

getRunnerName

public String getRunnerName ()

Récupère le programme d'exécution d'instrumentation Android à utiliser.

Renvoie
`String`

isOrchestrator

public boolean isOrchestrator ()

Renvoie 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 transmet les résultats à l'écouteur.

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

Génère
`DeviceNotAvailableException`

setAbi

public void setAbi (IAbi abi)

Paramètres
`abi`	`IAbi`

setClassName

public void setClassName (String testClassName)

Vous pouvez éventuellement 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 de test

setCollectsTestsShellTimeout

public void setCollectsTestsShellTimeout (int timeout)

Cette méthode est obsolète.
Cette méthode est une opération sans effet

Définissez la durée maximale en millisecondes pour permettre la "durée maximale de la réponse de sortie de shell" lors de la collecte des tests.

Paramètres
`timeout`	`int`

setConfiguration

public void setConfiguration (IConfiguration config)

Injecte le IConfiguration utilisé.

Paramètres
`config`	`IConfiguration`

setCoverageTarget

public void setCoverageTarget (String coverageTarget)

Définissez la cible de couverture de ce test.

Actuellement inutilisé. Cette méthode est simplement présente pour que coverageTarget puisse être récupéré ultérieurement via getCoverageTarget().

Paramètres
`coverageTarget`	`String`

setDebug

public void setDebug (boolean debug)

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

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

setDevice

public void setDevice (ITestDevice device)

Injectez l'appareil testé.

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

setEnforceFormat

public void setEnforceFormat (boolean enforce)

Définissez la valeur sur "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 force-abi.

setInstallFile

public void setInstallFile (File installFile)

Définissez le fichier facultatif à installer contenant les tests.

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

setIsolatedStorage

public void setIsolatedStorage (boolean isolatedStorage)

Définissez si vous souhaitez utiliser le stockage isolé.

Paramètres
`isolatedStorage`	`boolean`

setMethodName

public void setMethodName (String testMethodName)

Vous pouvez éventuellement définir la méthode de test à exécuter.

Paramètres
`testMethodName`	`String`

setMetricCollectors

public void setMetricCollectors ( collectors)

Définit la liste des IMetricCollector définis pour l'exécution de 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 de fichier 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`

setRerunMode

public void setRerunMode (boolean rerun)

Vous pouvez également définir le mode de rediffusion.

Paramètres
`rerun`	`boolean`

setRunName

public void setRunName (String runName)

Définissez le nom de l'exécution de test personnalisée qui sera fourni à l'écouteur.

Paramètres
`runName`	`String`

setRunnerName

public void setRunnerName (String runnerName)

Vous pouvez éventuellement définir le programme d'exécution d'instrumentation Android à utiliser.

Paramètres
`runnerName`	`String`

setShellTimeout

public void setShellTimeout (long timeout)

Vous pouvez également définir la durée maximale (en millisecondes) d'attente de la sortie du shell de l'appareil.

Paramètres
`timeout`	`long`

setTestFilePathOnDevice

public void setTestFilePathOnDevice (String testFilePathOnDevice)

Vous pouvez également définir le chemin d'accès à un fichier situé sur l'appareil qui doit contenir une liste de classes et de méthodes de test (format: com.foo.Class#method) à exécuter. Si elle est définie, elle tente automatiquement de réexécuter les tests à l'aide de ce fichier de test via InstrumentationFileTest au lieu d'exécuter des commandes adb distinctes pour chaque test restant via une nouvelle exécution.

Paramètres
`testFilePathOnDevice`	`String`

setTestPackageName

public void setTestPackageName (String testPackageName)

Définit le filtre du package de test.

Si la valeur n'est pas nulle, 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 éventuellement définir la durée maximale (en millisecondes) pour chaque exécution de test.

Paramètres
`timeout`	`long`

setTestsToRun

public void setTestsToRun ( tests)

Définissez la collection de tests qui doivent être exécutés par cet InstrumentationTest.

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

setWindowAnimation

public void setWindowAnimation (boolean windowAnimation)

Paramètres
`windowAnimation`	`boolean`

Méthodes protégées

excludeNonExecuted

protected static  excludeNonExecuted (TestRunResult results)

Filtrez les valeurs "NOT_EXECUTED" et "Skiped" afin de suivre 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 ()

Obtenez l'ListInstrumentationParser utilisé pour analyser les requêtes "pm list instrumentation".

Renvoie
`ListInstrumentationParser`

getMethodName

protected String getMethodName ()

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

Renvoie
`String`

getTestPackageName

protected String getTestPackageName ()

Exécutez le package Java de test.

Renvoie
`String`

queryRunnerName

protected String queryRunnerName ()

Interrogez l'appareil pour trouver un lanceur de test à utiliser.

Renvoie
`String`	le premier nom de lanceur de test qui correspond au package ou "null" si aucun n'est trouvé.

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

setRunnerArgs

protected void setRunnerArgs (IRemoteAndroidTestRunner runner)

Paramètres
`runner`	`IRemoteAndroidTestRunner`