- Syntaxe :
<instrumentation android:functionalTest=["true" | "false"] android:handleProfiling=["true" | "false"] android:icon="drawable resource" android:label="string resource" android:name="string" android:targetPackage="string" android:targetProcesses="string" />
- Contenu dans :
<manifest>
- Description :
- Déclare une classe
Instrumentation
qui vous permet pour surveiller l'interaction d'une application avec le système.Instrumentation
est instancié avant les composants de l'application. - Attributs :
android:functionalTest
- Indique si la classe
Instrumentation
s'exécute en tant que test fonctionnel.true
si tel est le cas, etfalse
dans le cas contraire. La la valeur par défaut estfalse
. android:handleProfiling
- Indique si l'objet
Instrumentation
active le profilage désactivée. Cette valeur esttrue
s'il détermine le début du profilage etfalse
si le profilage se poursuit pendant toute la durée en cours d'exécution. La valeurtrue
permet à l'objet de cibler le profilage. pour un ensemble d'opérations spécifique. La valeur par défaut estfalse
. android:icon
- Icône représentant la classe
Instrumentation
. Cet attribut doit être défini comme référence à une ressource drawable. android:label
- Libellé lisible pour la classe
Instrumentation
. L'étiquette peut être définie en tant que chaîne brute ou référence à une ressource de chaîne. android:name
- Nom de la sous-classe
Instrumentation
. Utilisez un nom de classe complet, tel quecom.example.project.StringInstrumentation
Toutefois, pour faire court, Si le premier caractère du nom est un point, il est ajouté au package spécifié dans l'élément<manifest>
.Il n'y a pas de valeur par défaut. Vous devez renseigner le nom.
android:targetPackage
- Application exécutée par l'objet
Instrumentation
par rapport à. Une application est identifiée par le nom de package attribué dans son par l'élément<manifest>
. android:targetProcesses
Processus que l'objet
Instrumentation
est exécutée. Une liste d'éléments séparés par une virgule indique que l'instrumentation s'exécute par rapport à ces processus spécifiques. Une valeur de"*"
indique que l'instrumentation s'exécute sur tous les processus de l'applicationandroid:targetPackage
Si cette valeur n'est pas fournie dans le fichier manifeste, l'instrumentation s'exécute uniquement en fonction du processus principal de l'application défini
android:targetPackage
Cet attribut a été ajouté au niveau d'API 26.
- Première apparition :
- Niveau d'API 1
<instrumentation>
Le contenu et les exemples de code de cette page sont soumis aux licences décrites dans la Licence de contenu. Java et OpenJDK sont des marques ou des marques déposées d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/27 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Il n'y a pas l'information dont j'ai besoin","missingTheInformationINeed","thumb-down"],["Trop compliqué/Trop d'étapes","tooComplicatedTooManySteps","thumb-down"],["Obsolète","outOfDate","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Mauvais exemple/Erreur de code","samplesCodeIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/07/27 (UTC)."],[],[],null,["# <instrumentation\u003e\n\nsyntax:\n:\n\n ```xml\n \u003cinstrumentation android:functionalTest=[\"true\" | \"false\"]\n android:handleProfiling=[\"true\" | \"false\"]\n android:icon=\"drawable resource\"\n android:label=\"string resource\"\n android:name=\"string\"\n android:targetPackage=\"string\"\n android:targetProcesses=\"string\" /\u003e\n ```\n\ncontained in:\n: [\u003cmanifest\u003e](/guide/topics/manifest/manifest-element)\n\ndescription:\n: Declares an [Instrumentation](/reference/android/app/Instrumentation) class that lets you\n monitor an application's interaction with the system. The `Instrumentation`\n object is instantiated before any of the application's components.\n\nattributes:\n:\n\n `android:functionalTest`\n : Whether the `Instrumentation` class runs as a functional test.\n This is `true` if it does and `false` if not. The\n default value is `false`.\n\n `android:handleProfiling`\n : Whether the `Instrumentation` object turns profiling on and\n off. This is `true` if it determines when profiling starts and\n stops and `false` if profiling continues the entire time it is\n running. A value of `true` enables the object to target profiling\n at a specific set of operations. The default value is `false`.\n\n `android:icon`\n : An icon that represents the `Instrumentation` class. This attribute\n must be set as a reference to a drawable resource.\n\n `android:label`\n : A user-readable label for the `Instrumentation` class. The label\n can be set as a raw string or a reference to a string resource.\n\n `android:name`\n : The name of the `Instrumentation` subclass.\n Use a fully qualified class name, such as\n `com.example.project.StringInstrumentation`. However, as a shorthand,\n if the first character of the name is a period, it is appended to the package\n name specified in the [\u003cmanifest\u003e](/guide/topics/manifest/manifest-element) element.\n\n\n There is no default. The name must be specified.\n\n `android:targetPackage`\n : The application that the `Instrumentation` object runs\n against. An application is identified by the package name assigned in its\n manifest file by the `\u003cmanifest\u003e` element.\n\n `android:targetProcesses`\n\n : The processes that the `Instrumentation` object\n runs against. A comma-separated list indicates that the instrumentation runs\n against those specific processes. A value of `\"*\"` indicates that the\n instrumentation runs against all processes of the app defined in\n `android:targetPackage`.\n\n If this value isn't provided in the manifest, the instrumentation runs\n only against the main process of the app defined in\n `android:targetPackage`.\n\n This attribute was added in API level 26.\n\nintroduced in:\n: API level 1"]]