- Syntax:
<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" />
- enthalten in:
<manifest>
- description:
- Deklariert eine
Instrumentation
-Klasse, mit der Sie die Interaktion einer Anwendung mit dem System überwachen. DasInstrumentation
-Objekt vor einer der Anwendungskomponenten instanziiert wird. - Attribute:
android:functionalTest
- Ob die Klasse
Instrumentation
als Funktionstest ausgeführt wird. Ist dies der Fall, lautet der Werttrue
und andernfallsfalse
. Die Der Standardwert istfalse
. android:handleProfiling
- Gibt an, ob das
Instrumentation
-Objekt die Profilerstellung aktiviert und deaktiviert. Dieser Wert isttrue
, wenn er angibt, wann die Profilerstellung beginnt und stoppt undfalse
, wenn die Profilerstellung während der gesamten Laufzeit fortgesetzt wird. ausgeführt wird. Durch den Werttrue
kann das Objekt eine Zielprofilerstellung vornehmen einer bestimmten Reihe von Operationen. Der Standardwert istfalse
. android:icon
- Ein Symbol, das die Klasse
Instrumentation
repräsentiert. Dieses Attribut muss als Verweis auf eine Drawable-Ressource festgelegt werden. android:label
- Ein für Nutzer lesbares Label für die Klasse
Instrumentation
. Das Label kann als Rohstring oder als Verweis auf eine Stringressource festgelegt werden. android:name
- Der Name der abgeleiteten Klasse
Instrumentation
. Verwenden Sie einen voll qualifizierten Klassennamen wiecom.example.project.StringInstrumentation
Kurz gesagt: Wenn das erste Zeichen des Namens ein Punkt ist, wird er an das Paket angehängt. Name, der im<manifest>
-Element angegeben ist.Es gibt keine Standardeinstellung. Der Name muss angegeben werden.
android:targetPackage
- Die Anwendung, die das
Instrumentation
-Objekt ausführt zu vergleichen. Eine Anwendung wird durch den Paketnamen identifiziert, der in ihrer Manifestdatei durch das Element<manifest>
. android:targetProcesses
Die Prozesse, mit denen das
Instrumentation
-Objekt gegeneinander antreten. Eine durch Kommas getrennte Liste gibt an, dass die Instrumentierung ausgeführt wird gegen diese spezifischen Prozesse. Der Wert"*"
gibt an, dass der wird die Instrumentierung für alle Prozesse der App ausgeführt,android:targetPackage
.Wenn dieser Wert nicht im Manifest angegeben ist, wird die Instrumentierung ausgeführt nur gegen den Hauptprozess der App,
android:targetPackage
Dieses Attribut wurde in API-Ebene 26 hinzugefügt.
- eingeführt in:
- API-Level 1
<Instrumentierung>
Alle Inhalte und Codebeispiele auf dieser Seite unterliegen den Lizenzen wie im Abschnitt Inhaltslizenz beschrieben. Java und OpenJDK sind Marken oder eingetragene Marken von Oracle und/oder seinen Tochtergesellschaften.
Zuletzt aktualisiert: 2025-07-27 (UTC).
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Benötigte Informationen nicht gefunden","missingTheInformationINeed","thumb-down"],["Zu umständlich/zu viele Schritte","tooComplicatedTooManySteps","thumb-down"],["Nicht mehr aktuell","outOfDate","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Problem mit Beispielen/Code","samplesCodeIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 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"]]