- بناء الجملة:
<grant-uri-permission android:path="string" android:pathPattern="string" android:pathPrefix="string" />
- المضمَّنة في:
<provider>
- description:
- يحدد هذا الإعداد المجموعات الفرعية لبيانات التطبيق التي يمتلك موفِّر المحتوى الرئيسي
إذنًا بالوصول إليها. يُشار إلى المجموعات الفرعية للبيانات من خلال جزء المسار من معرّف الموارد المنتظم (URI)
content:
. ويحدد جزء المرجع من URI موفر المحتوى. يُعد منح الإذن إحدى طرق تمكين عملاء المزودين الذين لا يمتلكون عادةً الإذن بالوصول إلى بياناته للتغلب على هذا الحظر لمرة واحدة.إذا كانت سمة
grantUriPermissions
التابعة لموفّر المحتوى هيtrue
، يمكن منح الإذن لأي بيانات ضِمن اختصاص الموفّر. ومع ذلك، إذا كانت هذه السمة هيfalse
، يتم منح الإذن فقط لمجموعات البيانات الفرعية التي يتم تحديدها من خلال هذا العنصر. يمكن أن يحتوي الموفر على أي عدد من عناصر<grant-uri-permission>
. ويمكن لكل مسار أن يحدد مسارًا واحدًا فقط، باستخدام إحدى السمات الثلاث الممكنة.لمزيد من المعلومات حول طريقة منح الإذن، راجِع السمة
grantUriPermissions
لعنصر<intent-filter>
. - السمات:
android:path
android:pathPrefix
android:pathPattern
- مسار يحدد المجموعة الفرعية أو المجموعات الفرعية للبيانات التي يمكن
منح الإذن لها. تحدّد السمة
path
مسارًا كاملاً. يمكن منح الإذن فقط لمجموعة فرعية معينة من البيانات يتم تحديدها بواسطة هذا المسار.تحدد السمة
pathPrefix
الجزء الأول من المسار. يمكن منح الإذن لجميع مجموعات البيانات الفرعية التي تحتوي على مسارات تشترك في ذلك الجزء الأول. تحدد السمةpathPattern
مسارًا كاملاً، إلا أنه يمكن أن يحتوي على أحرف البدل التالية:- تتطابق علامة النجمة (
*
) مع تسلسل من صفر إلى العديد من تكرارات الحرف السابق مباشرةً. تتطابق النقطة متبوعة بعلامة النجمة (
.*
) مع أي تسلسل من صفر إلى عدة أحرف.
بما أنّه يتم استخدام
\
كحرف إلغاء عند قراءة السلسلة من ملف XML، يجب استخدام مفتاح إلغاء مزدوج قبل تحليلها كنمط. على سبيل المثال، تتم كتابة*
الحرفي على النحو\\*
بينما تتم كتابة\
الحرفي على النحو\\\
.لمزيد من المعلومات حول هذه الأنواع من الأنماط، يمكنك الاطّلاع على أوصاف
PATTERN_LITERAL
وPATTERN_PREFIX
وPATTERN_SIMPLE_GLOB
في فئةPatternMatcher
. - تتطابق علامة النجمة (
- تم تقديمه في:
- المستوى 1 من واجهة برمجة التطبيقات
- راجِع أيضًا:
-
grantUriPermissions
السمة<provider>
العنصر
يخضع كل من المحتوى وعيّنات التعليمات البرمجية في هذه الصفحة للتراخيص الموضحّة في ترخيص استخدام المحتوى. إنّ Java وOpenJDK هما علامتان تجاريتان مسجَّلتان لشركة Oracle و/أو الشركات التابعة لها.
تاريخ التعديل الأخير: 2023-10-18 (حسب التوقيت العالمي المتفَّق عليه)
[]
[]