<permission-tree>
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
- بناء الجملة:
<permission-tree android:icon="drawable resource"
android:label="string resource"
android:name="string" />- الواردة في:
<manifest>- description:
- تعريف الاسم الأساسي لشجرة أذونات يأخذ التطبيق
ملكية جميع الأسماء داخل الشجرة. يمكنه إضافة أذونات جديدة ديناميكيًا
إلى الشجرة عن طريق طلب
PackageManager.addPermission().
يُفصل بين الأسماء داخل الشجرة بواسطة
النقاط ('.'). على سبيل المثال، إذا كان الاسم الأساسي هو
com.example.project.taxes، قد تكون الأذونات التالية
تمت إضافتها:
com.example.project.taxes.CALCULATE
com.example.project.taxes.deductions.STORE_RECEIPTS
com.example.project.taxes.deductions.ACCESS_RECORDS
هذا العنصر لا يفصح عن الإذن نفسه، بل هو
مساحة الاسم التي يمكن وضع الأذونات فيها. لمزيد من المعلومات عن إعلان الأذونات، يُرجى الاطّلاع على
<permission>
العنصر.
- :
android:icon- رمز يمثّل جميع الأذونات في العرض التدرّجي. هذه السمة
كمرجع لمورد قابل للرسم يحتوي على الصورة
التعريف.
android:label- اسم المجموعة سهل القراءة للمستخدم. للراحة، يجب تسمية
يمكن تعيينه مباشرة كسلسلة أولية أثناء التطوير. ومع ذلك،
عندما يكون التطبيق جاهزًا للنشر، يمكنك ضبطه
مرجعًا لمورد سلسلة، بحيث يمكن ترجمته مثل غيرها
السلاسل في واجهة المستخدم.
android:name- الاسم المستخدم في قاعدة شجرة الأذونات. إنها بمثابة
بادئة لجميع أسماء الأذونات في الشجرة. استخدام تحديد النطاق بنمط Java
فيكون الاسم فريدًا. يجب أن يحتوي الاسم على أكثر من
شريحتين مفصولتين بنقطة في مساره. على سبيل المثال:
com.example.base مقبول، ولكن com.example ليس كذلك.
- تم تقديمها في:
- المستوى 1 من واجهة برمجة التطبيقات
- راجِع أيضًا:
<permission>
<permission-group>
<uses-permission>
يخضع كل من المحتوى وعيّنات التعليمات البرمجية في هذه الصفحة للتراخيص الموضحّة في ترخيص استخدام المحتوى. إنّ Java وOpenJDK هما علامتان تجاريتان مسجَّلتان لشركة Oracle و/أو الشركات التابعة لها.
تاريخ التعديل الأخير: 2025-07-27 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-27 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# <permission-tree\u003e\n\nsyntax:\n:\n\n ```xml\n \u003cpermission-tree android:icon=\"drawable resource\"\n android:label=\"string resource\"\n android:name=\"string\" /\u003e\n ```\n\ncontained in:\n: [\u003cmanifest\u003e](/guide/topics/manifest/manifest-element)\n\ndescription:\n: Declares the base name for a tree of permissions. The application takes\n ownership of all names within the tree. It can dynamically add new permissions\n to the tree by calling [PackageManager.addPermission()](/reference/android/content/pm/PackageManager#addPermission(android.content.pm.PermissionInfo)).\n Names within the tree are separated by\n periods ('`.`'). For example, if the base name is\n `com.example.project.taxes`, permissions like the following might be\n added:\n\n `com.example.project.taxes.CALCULATE`\n\n `com.example.project.taxes.deductions.STORE_RECEIPTS`\n\n `com.example.project.taxes.deductions.ACCESS_RECORDS`\n\n\n This element doesn't declare a permission itself, only a\n namespace in which permissions can be placed. For more information about declaring permissions, see the\n [\u003cpermission\u003e](/guide/topics/manifest/permission-element)\n element.\n\nattributes:\n:\n\n `android:icon`\n : An icon representing all the permissions in the tree. This attribute\n must be set as a reference to a drawable resource containing the image\n definition.\n\n `android:label`\n : A user-readable name for the group. As a convenience, the label\n can be directly set as a raw string during development. However,\n when the application is ready to be published, set it as a\n reference to a string resource, so that it can be localized like other\n strings in the user interface.\n\n `android:name`\n : The name at the base of the permission tree. It serves as\n a prefix to all permission names in the tree. Use Java-style scoping\n so that the name is unique. The name must have more than\n two period-separated segments in its path. For example,\n `com.example.base` is OK, but `com.example` isn't.\n\nintroduced in:\n: API level 1\n\nsee also:\n: [\u003cpermission\u003e](/guide/topics/manifest/permission-element)\n\n [\u003cpermission-group\u003e](/guide/topics/manifest/permission-group-element)\n\n [\u003cuses-permission\u003e](/guide/topics/manifest/uses-permission-element)"]]
