<macation>
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
- بناء الجملة:
<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>.
android:targetProcessesيشير هذا المصطلح إلى العمليات التي يستخدمها الكائن Instrumentation.
يركض ضده. تشير القائمة المفصولة بفواصل إلى أنه يتم تشغيل الأدوات
مقابل تلك العمليات المحددة. تشير القيمة "*" إلى أن
على جميع عمليات التطبيق المحددة
android:targetPackage
في حال عدم توفير هذه القيمة في البيان، يتم تشغيل الأداة
فقط مقابل العملية الرئيسية للتطبيق المحددة في
android:targetPackage
تمّت إضافة هذه السمة في المستوى 26 من واجهة برمجة التطبيقات.
- تم تقديمها في:
- المستوى 1 من واجهة برمجة التطبيقات
يخضع كل من المحتوى وعيّنات التعليمات البرمجية في هذه الصفحة للتراخيص الموضحّة في ترخيص استخدام المحتوى. إنّ Java وOpenJDK هما علامتان تجاريتان مسجَّلتان لشركة Oracle و/أو الشركات التابعة لها.
تاريخ التعديل الأخير: 2025-07-27 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","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 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],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"]]
