<grant-uri-permission>

بناء الجملة:
<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> العنصر