- תחביר:
<path-permission android:path="string" android:pathPrefix="string" android:pathPattern="string" android:permission="string" android:readPermission="string" android:writePermission="string" />
- בתוך:
<provider>
- תיאור:
- הגדרת הנתיב וההרשאות הנדרשות לקבוצת משנה ספציפית של נתונים דרך ספק תוכן. הרכיב הזה יכול להיות לציין כמה פעמים כדי לספק נתיבים מרובים.
- :
android:path
- נתיב URI מלא לקבוצת משנה של נתונים של ספק תוכן.
ניתן להעניק הרשאה רק לנתונים הספציפיים שמזוהים בנתיב הזה.
כשהוא משמש להצגת תוכן של הצעה לחיפוש, הוא מצורף
עם
/search_suggest_query
. android:pathPrefix
- החלק הראשוני של נתיב URI לקבוצת משנה של נתונים של ספק תוכן. אפשר להעניק הרשאה לכל קבוצות המשנה של הנתונים שיש להן נתיבים שחולקים את החלק הראשוני הזה.
android:pathPattern
- נתיב URI מלא לקבוצת משנה של נתונים של ספק תוכן,
אבל אפשר להשתמש בתווים הכלליים לחיפוש הבאים:
- כוכבית (
*
). זה מתאים לרצף של אפס למופעים רבים של את התו הקודם. - נקודה ואחריה מופיעה כוכבית (
.*
). תואם לכל רצף של אפס תווים או יותר.
מפני שהקו הנטוי ההפוך (
\
) משמש כתו בריחה כשקוראים את המחרוזת. מ-XML, לפני שהוא מנתח כדפוס, עליכם לסמן בתו בריחה (escape) פעמיים. לדוגמה,*
בליטרל נכתב כך: "\\*
". וגם המילה\
כתובה כ-"\\\
". הדבר זהים לטקסט שכותבים אם יוצרים את המחרוזת בשפת התכנות Java.למידע נוסף על סוגי הדפוסים האלה, אפשר לקרוא את התיאורים של
PATTERN_LITERAL
PATTERN_PREFIX
, וגםPATTERN_SIMPLE_GLOB
ב-PatternMatcher
כיתה. - כוכבית (
android:permission
- שם ההרשאה שהלקוחות צריכים כדי לקרוא או לכתוב את
של ספק התוכן. המאפיין הזה הוא דרך נוחה להגדיר
הרשאה יחידה גם לקריאה וגם לכתיבה. אבל,
readPermission
והקבוצה מאפייניwritePermission
מקבלים עדיפות בסרטון הזה. android:readPermission
- הרשאה שהלקוחות זקוקים לה כדי לשלוח שאילתות על ספק התוכן.
android:writePermission
- הרשאה שהלקוחות זקוקים לה כדי לבצע שינויים בנתונים שנשלטים על ידי ספק התוכן.
- הושקו ב:
- רמת API 4
- למידע נוסף:
SearchManager
Manifest.permission
- טיפים בנושא אבטחה
<path-permission>
דוגמאות התוכן והקוד שבדף הזה כפופות לרישיונות המפורטים בקטע רישיון לתוכן. Java ו-OpenJDK הם סימנים מסחריים או סימנים מסחריים רשומים של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-07-27 (שעון UTC).
[[["התוכן קל להבנה","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 (שעון UTC)."],[],[],null,["# <path-permission\u003e\n\nsyntax:\n:\n\n ```xml\n \u003cpath-permission android:path=\"string\"\n android:pathPrefix=\"string\"\n android:pathPattern=\"string\"\n android:permission=\"string\"\n android:readPermission=\"string\"\n android:writePermission=\"string\" /\u003e\n ```\n\ncontained in:\n: [\u003cprovider\u003e](/guide/topics/manifest/provider-element)\n\ndescription:\n: Defines the path and required permissions for a specific subset of data\n within a content provider. This element can be\n specified multiple times to supply multiple paths.\n\nattributes:\n:\n\n `android:path`\n : A complete URI path for a subset of content provider data.\n Permission can be granted only to the particular data identified by this path.\n When used to provide search suggestion content, it is appended\n with `/search_suggest_query`.\n\n `android:pathPrefix`\n : The initial part of a URI path for a subset of content provider data.\n Permission can be granted to all data subsets with paths that share this initial part.\n\n `android:pathPattern`\n : A complete URI path for a subset of content provider data,\n but one that can use the following wildcards:\n\n - An asterisk (`*`). This matches a sequence of zero to many occurrences of the immediately preceding character.\n - A period followed by an asterisk (`.*`). This matches any sequence of zero or more characters.\n\n\n Because the backslash (`\\`) 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 \"`\\\\\\`\". This is\n the same as what you write if constructing the string in the Java programming language.\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\n `android:permission`\n : The name of a permission that clients need in order to read or write the\n content provider's data. This attribute is a convenient way of setting a\n single permission for both reading and writing. However, the\n `readPermission` and\n `writePermission` attributes take precedence\n over this one.\n\n `android:readPermission`\n : A permission that clients need in order to query the content provider.\n\n `android:writePermission`\n : A permission that clients need in order to make changes to the data controlled by the content provider.\n\nintroduced in:\n: API level 4\n\nsee also:\n: [SearchManager](/reference/android/app/SearchManager)\n: [Manifest.permission](/reference/android/Manifest.permission)\n: [Security tips](/guide/topics/security/security)"]]