<ابزارسازی>
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
- نحو:
<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> - توضیحات:
- یک کلاس
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> شناسایی می شود. -
android:targetProcesses فرآیندهایی که شی Instrumentation در برابر آنها اجرا می شود. یک لیست جدا شده با کاما نشان می دهد که ابزار دقیق در برابر آن فرآیندهای خاص اجرا می شود. مقدار "*" نشان می دهد که ابزار دقیق در برابر تمام فرآیندهای برنامه تعریف شده در android:targetPackage اجرا می شود.
اگر این مقدار در مانیفست ارائه نشده باشد، ابزار دقیق فقط در برابر فرآیند اصلی برنامه تعریف شده در android:targetPackage اجرا می‌شود.
این ویژگی در سطح 26 API اضافه شده است.
- معرفی شده در:
- API سطح 1
محتوا و نمونه کدها در این صفحه مشمول پروانههای توصیفشده در پروانه محتوا هستند. جاوا و OpenJDK علامتهای تجاری یا علامتهای تجاری ثبتشده Oracle و/یا وابستههای آن هستند.
تاریخ آخرین بهروزرسانی 2025-07-29 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","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-29 بهوقت ساعت هماهنگ جهانی."],[],[],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"]]
