- بناء الجملة:
<path-permission android:path="string" android:pathPrefix="string" android:pathPattern="string" android:permission="string" android:readPermission="string" android:writePermission="string" />
- المضمَّنة في:
<provider>
- description:
- تحدّد هذه السياسة المسار والأذونات المطلوبة لمجموعة فرعية معيّنة من البيانات ضمن موفِّر محتوى. يمكن تحديد هذا العنصر عدة مرات لتوفير مسارات متعددة.
- السمات:
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
- إذن يحتاج إليه العملاء لإجراء تغييرات على البيانات التي يتحكّم فيها موفّر المحتوى.
- تم تقديمه في:
- المستوى 4 لواجهة برمجة التطبيقات
- راجِع أيضًا:
SearchManager
Manifest.permission
- نصائح حول الأمان
يخضع كل من المحتوى وعيّنات التعليمات البرمجية في هذه الصفحة للتراخيص الموضحّة في ترخيص استخدام المحتوى. إنّ Java وOpenJDK هما علامتان تجاريتان مسجَّلتان لشركة Oracle و/أو الشركات التابعة لها.
تاريخ التعديل الأخير: 2023-10-18 (حسب التوقيت العالمي المتفَّق عليه)
[]
[]