<path-permission>

<path-permission android:path="string"
                 android:pathPrefix="string"
                 android:pathPattern="string"
                 android:permission="string"
                 android:readPermission="string"
                 android:writePermission="string" />

android:path

مسار معرّف موارد منتظم (URI) كامل لمجموعة فرعية من بيانات موفّري المحتوى. ولا يمكن منح الإذن إلا للبيانات المعيّنة التي يتم تحديدها من خلال هذا المسار. عند استخدامه لتقديم محتوى اقتراح البحث، يتم إلحاقه بـ /search_suggest_query.

android:pathPrefix

الجزء الأول من مسار معرّف الموارد المنتظم (URI) لمجموعة فرعية من بيانات موفِّر المحتوى. يمكن منح الإذن لكل مجموعات البيانات الفرعية التي تحتوي على مسارات تتشارك هذا الجزء الأول.

android:pathPattern

مسار معرّف موارد منتظم (URI) كامل لمجموعة فرعية من بيانات موفِّر المحتوى، ولكنه مسار يمكنه استخدام أحرف البدل التالية:

• علامة نجمية (*). يتطابق هذا مع تسلسل من صفر إلى العديد من تكرارات الحرف السابق مباشرةً.
• نقطة متبوعة بعلامة النجمة (.*). ويطابق هذا أي تسلسل من الأحرف الصفر أو أكثر.

بما أنّه يتم استخدام الشرطة المائلة للخلف (\) كحرف إلغاء عند قراءة السلسلة من XML، يجب استخدام مفتاح إلغاء مزدوج قبل تحليلها كنمط. على سبيل المثال، تتم كتابة * الحرفي على النحو التالي: "\\*"، بينما تتم كتابة قيمة \ الحرفية بالصيغة "\\\". وهذا ما يحدث تمامًا مع ما تكتبه إذا تم إنشاء السلسلة في لغة البرمجة Java.

لمزيد من المعلومات حول هذه الأنواع من الأنماط، يُرجى الاطّلاع على أوصاف PATTERN_LITERAL وPATTERN_PREFIX وPATTERN_SIMPLE_GLOB في الصف PatternMatcher.

android:permission

اسم التصريح الذي يحتاجه العملاء لقراءة أو كتابة بيانات موفّر المحتوى. هذه السمة هي طريقة ملائمة لتعيين إذن واحد لكل من القراءة والكتابة. في المقابل، يتم منح السمتَين readPermission وwritePermission الأولوية على هذه السمة.

android:readPermission

إذن يحتاج إليه العملاء للاستفسار عن موفّر المحتوى.

android:writePermission

إذن يحتاج إليه العملاء لإجراء تغييرات على البيانات التي يتحكّم فيها موفّر المحتوى.