- ไวยากรณ์:
<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" />
- ที่อยู่ใน:
<manifest>
- description:
- ประกาศชั้นเรียน
Instrumentation
ที่ทำให้คุณสามารถ ติดตามดูการโต้ตอบของแอปพลิเคชันกับระบบInstrumentation
สร้างอินสแตนซ์ออบเจ็กต์ก่อนคอมโพเนนต์ใดๆ ของแอปพลิเคชัน - ดังนี้
android:functionalTest
- กำหนดว่าชั้นเรียน
Instrumentation
เป็นการทดสอบการทำงานหรือไม่ นี่คือtrue
หากใช่ และfalse
หากไม่ใช่ ค่าเริ่มต้นคือfalse
android:handleProfiling
- ระบุว่าออบเจ็กต์
Instrumentation
จะเปิดการทำโปรไฟล์และ ปิดอยู่ นี่คือtrue
หากระบุว่าการทำโปรไฟล์เริ่มต้นเมื่อใดและ จะหยุดและfalse
หากการทำโปรไฟล์ยังคงดำเนินต่อไปตลอดช่วงเวลาที่เป็นอยู่ วิ่งอยู่ ค่าtrue
ช่วยให้ออบเจ็กต์กำหนดเป้าหมายการทำโปรไฟล์ได้ ในชุดการดำเนินการที่เฉพาะเจาะจง ค่าเริ่มต้นคือfalse
android:icon
- ไอคอนที่แสดงถึงคลาส
Instrumentation
แอตทริบิวต์นี้ ต้องตั้งค่าเป็นการอ้างอิงไปยังทรัพยากรที่ถอนออกได้ android:label
- ป้ายกำกับที่ผู้ใช้อ่านได้สำหรับคลาส
Instrumentation
ป้ายกำกับ สามารถตั้งค่าเป็นสตริงดิบหรือการอ้างอิงไปยังทรัพยากรสตริงได้ android:name
- ชื่อคลาสย่อย
Instrumentation
ใช้ชื่อคลาสที่มีคุณสมบัติครบถ้วน เช่นcom.example.project.StringInstrumentation
แต่กล่าวสั้นๆ คือ หากอักขระตัวแรกของชื่อเป็นมหัพภาค ก็จะต่อท้ายแพ็กเกจ ชื่อที่ระบุในองค์ประกอบ<manifest>
ไม่มีค่าเริ่มต้น ต้องระบุชื่อ
android:targetPackage
- แอปพลิเคชันที่ออบเจ็กต์
Instrumentation
เรียกใช้ เทียบกับ แอปพลิเคชันจะถูกระบุโดยชื่อแพ็กเกจที่กำหนดไว้ใน ไฟล์ Manifest ตามองค์ประกอบ<manifest>
android:targetProcesses
กระบวนการที่ออบเจ็กต์
Instrumentation
ที่แข่งกับรถ รายการที่คั่นด้วยคอมมาระบุว่าเครื่องมือนั้นทำงานอยู่ เทียบกับกระบวนการเฉพาะเหล่านั้น ค่า"*"
บ่งชี้ว่าพารามิเตอร์ การใช้เครื่องมือจะทำงานกับกระบวนการทั้งหมดของแอปที่กำหนดไว้ในandroid:targetPackage
หากไม่ได้ระบุค่านี้ในไฟล์ Manifest เครื่องมือจะทำงาน ต่อกระบวนการหลักของแอปที่กำหนดไว้ใน
android:targetPackage
แอตทริบิวต์นี้เพิ่มขึ้นใน API ระดับ 26
- เปิดตัวใน
- API ระดับ 1
<เครื่องมือ>
ตัวอย่างเนื้อหาและโค้ดในหน้าเว็บนี้ขึ้นอยู่กับใบอนุญาตที่อธิบายไว้ในใบอนุญาตการใช้เนื้อหา Java และ OpenJDK เป็นเครื่องหมายการค้าหรือเครื่องหมายการค้าจดทะเบียนของ Oracle และ/หรือบริษัทในเครือ
อัปเดตล่าสุด 2025-07-27 UTC
[[["เข้าใจง่าย","easyToUnderstand","thumb-up"],["แก้ปัญหาของฉันได้","solvedMyProblem","thumb-up"],["อื่นๆ","otherUp","thumb-up"]],[["ไม่มีข้อมูลที่ฉันต้องการ","missingTheInformationINeed","thumb-down"],["ซับซ้อนเกินไป/มีหลายขั้นตอนมากเกินไป","tooComplicatedTooManySteps","thumb-down"],["ล้าสมัย","outOfDate","thumb-down"],["ปัญหาเกี่ยวกับการแปล","translationIssue","thumb-down"],["ตัวอย่าง/ปัญหาเกี่ยวกับโค้ด","samplesCodeIssue","thumb-down"],["อื่นๆ","otherDown","thumb-down"]],["อัปเดตล่าสุด 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"]]