<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>. يمكن أن يحدد كل مسار مسارًا واحدًا فقط، باستخدام إحدى السمات الثلاث المحتملة.

للحصول على معلومات حول كيفية منح الإذن، يمكنك الاطّلاع على عنصر <intent-filter> السمة grantUriPermissions.

:
android:path
android:pathPrefix
android:pathPattern
مسار يحدّد المجموعة الفرعية من البيانات أو المجموعات الفرعية التي يمكن السماح باستخدامها ممنوح من أجله. تحدد السمة path مسارًا كاملاً. لا يمكن منح الإذن إلا لمجموعة فرعية معيّنة من البيانات المحدّدة. عبر هذا المسار.

تحدد السمة pathPrefix الجزء الأولي من المسار. يمكن منح الإذن لجميع مجموعات البيانات الفرعية التي تتضمن مسارات تشترك في والجزء الأولي. تحدد السمة pathPattern مسارًا كاملاً، إلا أنّ مسارًا واحدًا التي يمكن أن تحتوي على أحرف البدل التالية:

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

لأنّ \ يتم استخدامه كحرف إلغاء عند قراءة السلسلة من XML، يجب تخطي علامة الجمع قبل أن يتم تحليلها كنمط. على سبيل المثال، تتم كتابة الحرف * بالصيغة \\* تتم كتابة \ الحرفية بالصيغة \\\.

لمزيد من المعلومات حول هذه الأنواع من الأنماط، يمكنك الاطلاع على أوصاف PATTERN_LITERAL, PATTERN_PREFIX و PATTERN_SIMPLE_GLOB في صف واحد (PatternMatcher).

تم تقديمها في:
المستوى 1 من واجهة برمجة التطبيقات
راجِع أيضًا:
grantUriPermissions سمة <provider> العنصر