- sintaksis:
<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" />
- terdapat dalam:
<manifest>
- deskripsi:
- Mendeklarasikan class
Instrumentation
yang memungkinkan Anda memantau interaksi aplikasi dengan sistem. ObjekInstrumentation
dibuat sebelum komponen aplikasi apa pun. - atribut:
android:functionalTest
- Apakah class
Instrumentation
berjalan sebagai pengujian fungsional. Nilainya adalahtrue
jika ya danfalse
jika tidak. Nilai default-nya adalahfalse
. android:handleProfiling
- Apakah objek
Instrumentation
mengaktifkan dan menonaktifkan pembuatan profil. Nilainya adalahtrue
jika menentukan kapan pembuatan profil dimulai dan berhenti, danfalse
jika pembuatan profil berlanjut sepanjang waktu berjalan. Nilaitrue
memungkinkan objek untuk menargetkan pembuatan profil pada sekumpulan operasi tertentu. Nilai default-nya adalahfalse
. android:icon
- Ikon yang merepresentasikan class
Instrumentation
. Atribut ini harus ditetapkan sebagai referensi ke resource drawable. android:label
- Label dapat dibaca oleh pengguna untuk class
Instrumentation
tersebut. Label dapat ditetapkan sebagai string mentah atau referensi ke resource string. android:name
- Nama dari subclass
Instrumentation
. Gunakan nama class yang sepenuhnya memenuhi syarat, seperticom.example.project.StringInstrumentation
. Namun, sebagai singkatan, jika karakter pertamanya adalah titik, karakter ini akan ditambahkan ke nama paket yang ditetapkan dalam elemen<manifest>
.Tidak ada default untuknya. Nama ini harus ditetapkan.
android:targetPackage
- Aplikasi yang dijalankan oleh objek
Instrumentation
. Aplikasi diidentifikasi dengan nama paket yang ditetapkan dalam file manifesnya oleh elemen<manifest>
. android:targetProcesses
Proses yang dijalankan oleh objek
Instrumentation
. Daftar yang dipisahkan koma menunjukkan bahwa instrumentasi dijalankan pada proses khusus tersebut. Nilai"*"
menunjukkan bahwa instrumentasi dijalankan pada semua proses aplikasi yang ditentukan dalamandroid:targetPackage
.Jika nilai ini tidak diberikan dalam manifes, instrumentasi hanya akan dijalankan pada proses utama aplikasi yang ditentukan dalam
android:targetPackage
.Atribut ini ditambahkan di API level 26.
- diperkenalkan di:
- API level 1
<instrumentasi>
Konten dan contoh kode di halaman ini tunduk kepada lisensi yang dijelaskan dalam Lisensi Konten. Java dan OpenJDK adalah merek dagang atau merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-07-27 UTC.
[null,null,["Terakhir diperbarui pada 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"]]