<grant-uri-permission>

תחביר:
<grant-uri-permission android:path="string"
                      android:pathPattern="string"
                      android:pathPrefix="string" />
בתוך:
<provider>
תיאור:
קביעת קבוצות המשנה של נתוני האפליקציה שספק התוכן הראשי יש הרשאת גישה. קבוצות משנה של נתונים מסומנות על ידי החלק בנתיב של URI של content:. חלק הרשות ב-URI מזהה את ספק תוכן. הענקת הרשאה היא דרך לאפשר ללקוחות של הספק שלא בדרך כלל מקבלים הרשאה לגשת לנתונים כדי להתגבר על ההגבלה הזו באופן חד-פעמי.

אם grantUriPermissions של ספק תוכן הוא true, ניתן להעניק הרשאה לכל אחד מהנתונים שתחת תפקידו של הספק. עם זאת, אם הערך של המאפיין הוא false, ההרשאה מוענק רק לקבוצות משנה של נתונים שמצוינות על ידי הרכיב הזה. ספק יכול להכיל כל מספר של רכיבי <grant-uri-permission>. כל סוג יכול לציין נתיב אחד בלבד, באמצעות אחד משלושת המאפיינים האפשריים.

למידע נוסף על הענקת הרשאה, אפשר לעיין ב של רכיב <intent-filter> grantUriPermissions.

:
android:path
android:pathPrefix
android:pathPattern
נתיב המזהה את קבוצות המשנה או קבוצות המשנה של הנתונים שאפשר להגדיר את ההרשאה שניתנה עבורה. המאפיין path מציין נתיב מלא. ניתן להעניק הרשאה רק לקבוצת המשנה הספציפית של הנתונים שזוהתה בנתיב הזה.

המאפיין pathPrefix מציין את החלק הראשוני של הנתיב. אפשר לתת הרשאה לכל קבוצות המשנה של הנתונים שיש להן נתיבים שחולקים של החלק הראשוני. המאפיין pathPattern מציין נתיב מלא, אבל יכול להכיל את התווים הכלליים לחיפוש הבאים:

  • כוכבית (*) מתאימה רצף של אפס למופעים רבים של את התו הקודם.

  • נקודה ואחריה כוכבית (.*) תואמת לכל רצף של בין אפס להרבה תווים.

כי \ משמש כתו בריחה כשהמחרוזת נקראת מ-XML, לפני שהוא מנתח כדפוס, עליכם לסמן בתו בריחה (escape) פעמיים. לדוגמה, * בליטרל נכתב כך: \\*, וגם הליטרל \ נכתב כך: \\\.

למידע נוסף על סוגי הדפוסים האלה, אפשר לקרוא את התיאורים של PATTERN_LITERAL, PATTERN_PREFIX, וגם PATTERN_SIMPLE_GLOB ב כיתה אחת (PatternMatcher).

הושקו ב:
רמת API 1
למידע נוסף:
grantUriPermissions של התכונה <provider> רכיב