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

InstrumentationTest

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

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

Sous-classes directes connues

AndroidJUnitTest , CodeCoverageTest

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

Un test qui exécute un package de tests d’instrumentation sur un appareil donné.

Résumé

Des champs
`public static final String`	`RUN_TESTS_AS_USER_KEY`
`public static final String`	`RUN_TESTS_ON_SDK_SANDBOX`
`protected boolean`	`mDebug`

Constructeurs publics
`InstrumentationTest ()`

Méthodes publiques
`void`	`addDeviceListeners ( extraListeners)` `addDeviceListeners ( extraListeners)` Permet d'ajouter plus d'é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 ()` Obtient la `IConfiguration` pour ce test.
`String`	`getCoverageTarget ()` Obtenez le coverTarget précédemment défini via `setCoverageTarget(String)` .
`boolean`	`getDebug ()` Obtenez le paramètre de débogage de l’instrumentation.
`ITestDevice`	`getDevice ()` Obtenez l'appareil en cours de test.
`String`	`getForceAbi ()`
`long`	`getMaxTimeout ()` Renvoie le délai d'expiration maximum défini pour l'instrumentation.
`String`	`getPackageName ()` Obtenez le package de manifeste Android à exécuter.
`String`	`getRunName ()` Obtenez le nom d'exécution de test personnalisé qui sera fourni à l'auditeur
`String`	`getRunnerName ()` Obtient le programme d'exécution d'instrumentation Android à utiliser.
`void`	`run ( TestInformation testInfo, ITestInvocationListener listener)` Exécute les tests et rapporte les résultats à l'auditeur.
`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 tests
`void`	`setCollectsTestsShellTimeout (int timeout)` Cette méthode est obsolète. Cette méthode est inutile
`void`	`setConfiguration ( IConfiguration config)` Injecte la `IConfiguration` utilisée.
`void`	`setCoverageTarget (String coverageTarget)` Définissez l’objectif de couverture de ce test.
`void`	`setDebug (boolean debug)` Définissez le paramètre de débogage de l’instrumentation.
`void`	`setDevice ( ITestDevice device)` Injectez le dispositif 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 force-abi.
`void`	`setInstallFile (File installFile)` Définissez le fichier facultatif à installer qui contient les tests.
`void`	`setIsolatedStorage (boolean isolatedStorage)` Définissez si vous souhaitez ou non utiliser le stockage isolé.
`void`	`setMethodName (String testMethodName)` Vous pouvez éventuellement définir la méthode de test à exécuter.
`void`	`setMetricCollectors ( collectors)` `setMetricCollectors ( collectors)` Définit la liste des `IMetricCollector` définis pour le test.
`void`	`setPackageName (String packageName)` Définissez le package de manifeste Android pour qu'il s'exécute.
`void`	`setReRunUsingTestFile (boolean reRunUsingTestFile)` Définit l'option --rerun-from-file.
`void`	`setRerunMode (boolean rerun)` Vous pouvez éventuellement définir le mode de réexécution.
`void`	`setRunName (String runName)` Définir le nom d'exécution de test personnalisé qui sera fourni à l'auditeur
`void`	`setRunnerName (String runnerName)` Vous pouvez éventuellement définir le programme d'exécution d'instrumentation Android à utiliser.
`void`	`setShellTimeout (long timeout)` Vous pouvez éventuellement définir la durée maximale (en millisecondes) d'attente de la sortie du shell du périphérique.
`void`	`setTestFilePathOnDevice (String testFilePathOnDevice)` Vous pouvez éventuellement 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 séparées par des lignes (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 éventuellement 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 individuel.
`void`	`setTestsToRun ( tests)` `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 "NOT_EXECUTED" afin de suivre ce qui doit être réexécuté.
`String`	`getClassName ()` Obtenez le nom de la classe à exécuter.
`ListInstrumentationParser`	`getListInstrumentationParser ()` Obtenez le `ListInstrumentationParser` utilisé pour analyser les requêtes « pm list instrumentation ».
`String`	`getMethodName ()` Obtenez la méthode de test à exécuter.
`String`	`getTestPackageName ()` Obtenez le package de test Java à exécuter.
`String`	`queryRunnerName ()` Interrogez l’appareil pour qu’un exécuteur de test l’utilise.
`void`	`setRunnerArgs (IRemoteAndroidTestRunner runner)`

Des 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

Constructeurs publics

InstrumentationTest

public InstrumentationTest ()

Méthodes publiques

addDeviceListeners

public void addDeviceListeners ( extraListeners)

Permet d'ajouter plus d'é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` : le nom de l'argument
`value`	`String` : la valeur de l'argument

obtenirAbi

public IAbi getAbi ()

Retour
`IAbi`

obtenirConfiguration

public IConfiguration getConfiguration ()

Obtient la IConfiguration pour ce test.

Retour
`IConfiguration`

getCoverageTarget

public String getCoverageTarget ()

Obtenez le coverTarget précédemment défini via setCoverageTarget(String) .

Retour
`String`

obtenirDebug

public boolean getDebug ()

Obtenez le paramètre de débogage de l’instrumentation.

Retour
`boolean`	Le paramètre de débogage booléen.

obtenirDevice

public ITestDevice getDevice ()

Obtenez l'appareil en cours de test.

Retour
`ITestDevice`	le `ITestDevice`

getForceAbi

public String getForceAbi ()

Retour
`String`

getMaxTimeout

public long getMaxTimeout ()

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

Retour
`long`

getPackageName

public String getPackageName ()

Obtenez le package de manifeste Android à exécuter.

Retour
`String`

getRunName

public String getRunName ()

Obtenez le nom d'exécution de test personnalisé qui sera fourni à l'auditeur

Retour
`String`

getRunnerName

public String getRunnerName ()

Obtient le programme d'exécution d'instrumentation Android à utiliser.

Retour
`String`

courir

public void run (TestInformation testInfo, 
                ITestInvocationListener listener)

Exécute les tests et rapporte les résultats à l'auditeur.

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

Jetés
`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 tests

setCollectsTestsShellTimeout

public void setCollectsTestsShellTimeout (int timeout)

Cette méthode est obsolète.
Cette méthode est inutile

Définissez le temps maximum en ms pour permettre le « temps maximum de réponse de sortie du shell » lors de la collecte des tests.

Paramètres
`timeout`	`int`

setConfiguration

public void setConfiguration (IConfiguration config)

Injecte la IConfiguration utilisée.

Paramètres
`config`	`IConfiguration`

setCoverageTarget

public void setCoverageTarget (String coverageTarget)

Définissez l’objectif de couverture de ce test.

Actuellement inutilisé. Cette méthode est juste présente afin que coverTarget 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 de l’instrumentation.

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

définirDevice

public void setDevice (ITestDevice device)

Injectez le dispositif testé.

Paramètres
`device`	`ITestDevice` : le `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 force-abi.

setInstallFile

public void setInstallFile (File installFile)

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

Paramètres
`installFile`	`File` : l' `ERROR(/File)`

setIsolatedStorage

public void setIsolatedStorage (boolean isolatedStorage)

Définissez si vous souhaitez ou non 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 le test.

Paramètres
`collectors`

setPackageName

public void setPackageName (String packageName)

Définissez le package de manifeste Android pour qu'il s'exécute.

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 éventuellement définir le mode de réexécution.

Paramètres
`rerun`	`boolean`

setRunName

public void setRunName (String runName)

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

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 éventuellement définir la durée maximale (en millisecondes) d'attente de la sortie du shell du périphérique.

Paramètres
`timeout`	`long`

setTestFilePathOnDevice

public void setTestFilePathOnDevice (String testFilePathOnDevice)

Vous pouvez éventuellement 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 séparées par des lignes (format : com.foo.Class#method) à exécuter. S'il est défini, tentera automatiquement de réexécuter les tests en utilisant 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 du package de test.

S'il n'est pas nul, 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 éventuellement 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 individuel.

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

exclureNonExecuted

protected static  excludeNonExecuted (TestRunResult results)

Filtrez "NOT_EXECUTED" afin de suivre ce qui doit être réexécuté.

Paramètres
`results`	`TestRunResult`

Retour

obtenirNomClasse

protected String getClassName ()

Obtenez le nom de la classe à exécuter.

Retour
`String`

getListInstrumentationParser

protected ListInstrumentationParser getListInstrumentationParser ()

Obtenez le ListInstrumentationParser utilisé pour analyser les requêtes « pm list instrumentation ».

Retour
`ListInstrumentationParser`

getMethodName

protected String getMethodName ()

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

Retour
`String`

getTestPackageName

protected String getTestPackageName ()

Obtenez le package de test Java à exécuter.

Retour
`String`

queryRunnerName

protected String queryRunnerName ()

Interrogez l’appareil pour qu’un programme d’exécution de test l’utilise.

Retour
`String`	le nom du premier programme d'exécution de test qui correspond au package ou null si nous n'en trouvons aucun.

Jetés
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

setRunnerArgs

protected void setRunnerArgs (IRemoteAndroidTestRunner runner)

Paramètres
`runner`	`IRemoteAndroidTestRunner`