- sintaxis:
<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" />
- se incluye en:
<manifest>
- descripción:
- Declara una clase
Instrumentation
que te permite supervisar la interacción de una aplicación con el sistema. Se crean instancias del objetoInstrumentation
antes que cualquiera de los componentes de la aplicación. - atributos:
android:functionalTest
- Indica si la clase
Instrumentation
se ejecuta como una prueba funcional. Esto estrue
si lo hace yfalse
si no. El valor predeterminado esfalse
. android:handleProfiling
- Indica si el objeto
Instrumentation
activa o desactiva la generación de perfiles. Este valor estrue
si determina cuándo se inicia y se detiene la generación de perfiles, yfalse
si la generación de perfiles continúa durante todo el tiempo en que se ejecuta. Un valor detrue
permite al objeto orientar la generación de perfiles a un conjunto específico de operaciones. El valor predeterminado esfalse
. android:icon
- Es un ícono que representa la clase
Instrumentation
. Este atributo se debe establecer como una referencia a un recurso de elementos de diseño. android:label
- Etiqueta de la actividad que los usuarios pueden leer para la clase
Instrumentation
. La etiqueta se puede establecer como una cadena sin procesar o como una referencia a un recurso de cadenas. android:name
- Es el nombre de la subclase
Instrumentation
. Usa un nombre de clase completamente calificado, comocom.example.project.StringInstrumentation
. Sin embargo, como atajo, si el primer carácter del nombre es un punto, se agregará al nombre del paquete especificado en el elemento<manifest>
.No hay ningún valor predeterminado. Se debe especificar el nombre.
android:targetPackage
- La aplicación con la que se ejecuta el objeto
Instrumentation
. Una app se identifica mediante el nombre de paquete que el elemento<manifest>
asignó en su archivo de manifiesto. android:targetProcesses
Los procesos en los que se ejecuta el objeto
Instrumentation
. Una lista separada por comas indica que la instrumentación se ejecutará en esos procesos específicos. Un valor de"*"
indica que la instrumentación se ejecutará en todos los procesos de la app definida enandroid:targetPackage
.Si este valor no se proporciona en el manifiesto, la instrumentación solo se ejecutará en el proceso principal de la app definida en
android:targetPackage
.Este atributo se agregó en el nivel de API 26.
- primera inclusión:
- Nivel de API 1
<instrumentación>
El contenido y las muestras de código que aparecen en esta página están sujetas a las licencias que se describen en la Licencia de Contenido. Java y OpenJDK son marcas registradas de Oracle o sus afiliados.
Última actualización: 2025-07-27 (UTC)
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Falta la información que necesito","missingTheInformationINeed","thumb-down"],["Muy complicado o demasiados pasos","tooComplicatedTooManySteps","thumb-down"],["Desactualizado","outOfDate","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Problema con las muestras o los códigos","samplesCodeIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 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"]]