- Sintaxe:
<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" />
- contido em:
<manifest>
- descrição:
- Declara uma classe
Instrumentation
que permite monitorar a interação de um aplicativo com o sistema. O objeto da classeInstrumentation
é instanciado antes de todos os outros componentes do aplicativo. - atributos:
android:functionalTest
- Define se a classe
Instrumentation
é executada como um teste funcional. Serátrue
se tiver, efalse
se não tiver. O valor padrão éfalse
. android:handleProfiling
- Se o objeto
Instrumentation
ativa ou desativa a criação de perfis. O atributo serátrue
se determinar quando a criação de perfis começa e para efalse
se a criação de perfis continuar durante toda a execução. Um valortrue
permite que o objeto seja destinado à criação de perfis em um conjunto específico de operações. O valor padrão éfalse
. android:icon
- Um ícone que representa a classe
Instrumentation
. Esse atributo precisa ser definido como referência a um recurso drawable. android:label
- Um rótulo legível pelo usuário para a classe
Instrumentation
. O rótulo pode ser definido como uma string bruta ou uma referência a um recurso de string. android:name
- O nome da subclasse
Instrumentation
. Use um nome de classe totalmente qualificado, comocom.example.project.StringInstrumentation
. No entanto, como abreviação, se o primeiro caractere do nome for um ponto, ele será anexado ao nome do pacote especificado no elemento<manifest>
.Não há um valor padrão. O nome precisa ser especificado.
android:targetPackage
- O aplicativo em que o objeto
Instrumentation
é executado. Os aplicativos são identificados pelo nome do pacote atribuído no arquivo de manifesto pelo elemento<manifest>
. android:targetProcesses
Os processos em que o objeto
Instrumentation
é executado. Uma lista separada por vírgulas indica que a instrumentação é executada nesses processos específicos. Um valor de"*"
indica que a instrumentação é executada em todos os processos do app definido emandroid:targetPackage
.Se esse valor não for fornecido no manifesto, a instrumentação será executada somente no processo principal do app definido em
android:targetPackage
.Esse atributo foi adicionado no nível 26 da API.
- introduzido em:
- Nível 1 da API
<instrumentação>
O conteúdo e os exemplos de código nesta página estão sujeitos às licenças descritas na Licença de conteúdo. Java e OpenJDK são marcas registradas da Oracle e/ou suas afiliadas.
Última atualização 2025-07-27 UTC.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 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"]]