<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>
العنصر
يخضع كل من المحتوى وعيّنات التعليمات البرمجية في هذه الصفحة للتراخيص الموضحّة في ترخيص استخدام المحتوى. إنّ Java وOpenJDK هما علامتان تجاريتان مسجَّلتان لشركة Oracle و/أو الشركات التابعة لها.
تاريخ التعديل الأخير: 2025-07-27 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-07-27 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# <grant-uri-permission\u003e\n\nsyntax:\n:\n\n ```xml\n \u003cgrant-uri-permission android:path=\"string\"\n android:pathPattern=\"string\"\n android:pathPrefix=\"string\" /\u003e\n ```\n\ncontained in:\n: [\u003cprovider\u003e](/guide/topics/manifest/provider-element)\n\ndescription:\n: Specifies the subsets of app data that the parent content provider\n has permission to access. Data subsets are indicated by the path part of a\n `content:` URI. The authority part of the URI identifies the\n content provider.\n Granting permission is a way of enabling clients of the provider that don't\n normally have permission to access its data to overcome that restriction on\n a one-time basis.\n\n\n If a content provider's [grantUriPermissions](/guide/topics/manifest/provider-element#gprmsn)\n attribute is `true`, permission can be granted for any of the data under\n the provider's purview. However, if that attribute is `false`, permission\n is granted only to data subsets that are specified by this element.\n A provider can contain any number of `\u003cgrant-uri-permission\u003e` elements.\n Each one can specify only one path, using one of the three possible attributes.\n\n\n For information about how permission is granted, see the\n [\u003cintent-filter\u003e](/guide/topics/manifest/intent-filter-element) element's\n [grantUriPermissions](/guide/topics/manifest/provider-element#gprmsn) attribute.\n\nattributes:\n:\n\n `android:path`\n\n `android:pathPrefix`\n\n `android:pathPattern`\n : A path identifying the data subset or subsets that permission can be\n granted for. The `path` attribute specifies a complete path.\n Permission can granted only to the particular data subset identified\n by that path.\n\n \u003cbr /\u003e\n\n\n The `pathPrefix` attribute specifies the initial part of a path.\n Permission can be granted to all data subsets with paths that share that\n initial part.\n The `pathPattern` attribute specifies a complete path, but one\n that can contain the following wildcards:\n\n - An asterisk (`*`) matches a sequence of zero to many occurrences of the immediately preceding character.\n - A period followed by an asterisk (`.*`) matches any sequence of\n zero to many characters.\n\n\n Because `\\` is used as an escape character when the string is read\n from XML, before it is parsed as a pattern, you need to double-escape.\n For example, a literal `*` is written as `\\\\*` and a\n literal `\\` is written as `\\\\\\`.\n\n\n For more information about these types of patterns, see the descriptions of\n [PATTERN_LITERAL](/reference/android/os/PatternMatcher#PATTERN_LITERAL),\n [PATTERN_PREFIX](/reference/android/os/PatternMatcher#PATTERN_PREFIX), and\n [PATTERN_SIMPLE_GLOB](/reference/android/os/PatternMatcher#PATTERN_SIMPLE_GLOB) in the\n [PatternMatcher](/reference/android/os/PatternMatcher) class.\n\nintroduced in:\n: API level 1\n\nsee also:\n:\n [grantUriPermissions](/guide/topics/manifest/provider-element#gprmsn)\n attribute of the\n [\u003cprovider\u003e](/guide/topics/manifest/provider-element)\n element"]]
