- składnia:
<grant-uri-permission android:path="string" android:pathPattern="string" android:pathPrefix="string" />
- zawarte w:
<provider>
- description:
- Określa podzbiory danych aplikacji, które nadrzędny dostawca treści
ma pozwolenie na dostęp. Podzbiory danych są oznaczone przez część ścieżki
Identyfikator URI
content:
. Część autoryzacyjna identyfikatora URI określa dostawcy treści. Przyznanie uprawnień to sposób na umożliwienie klientom dostawcy, którzy nie zwykle mają dostęp do swoich danych, by przezwyciężyć to ograniczenie jednorazowo.Jeśli
grantUriPermissions
dostawcy treści ma wartośćtrue
, uprawnienie można przyznać dla dowolnych danych w w zakresie działania dostawcy. Jeśli jednak ten atrybut ma wartośćfalse
, uprawnienie jest przyznawana tylko do podzbiorów danych określonych przez ten element. Dostawca może zawierać dowolną liczbę elementów<grant-uri-permission>
. Każdy z nich może określać tylko jedną ścieżkę za pomocą jednego z trzech atrybutów.Informacje o sposobie przyznawania uprawnień znajdziesz tutaj: Element
<intent-filter>
grantUriPermissions
. - atrybuty:
android:path
android:pathPrefix
android:pathPattern
- Ścieżka identyfikująca podzbiory lub podzbiory danych, którym może być uprawnienie
na cześć. Atrybut
path
określa pełną ścieżkę. Uprawnienia można przyznawać tylko do określonego określonego podzbioru danych tą ścieżką.Atrybut
pathPrefix
określa początkową część ścieżki. Uprawnienia można przyznać wszystkim podzbiorom danych ze ścieżkami, które korzystają ze wspólnej ścieżki pierwszej części. AtrybutpathPattern
określa pełną ścieżkę, ale jeden adres które mogą zawierać te symbole wieloznaczne:- Gwiazdka (
*
) odpowiada sekwencji od 0 do wielu wystąpień bezpośrednio poprzedzający znak. Kropka z gwiazdką (
.*
) odpowiada dowolnej sekwencji od zera do wielu znaków.
Ponieważ
\
jest używany jako znak zmiany znaczenia podczas odczytywania ciągu z kodu XML, zanim zostanie on przetworzony jako wzorzec, musisz dwukrotnie zastosować zmianę znaczenia. Na przykład literał*
jest zapisany jako\\*
, a literał\
jest zapisany jako\\\
.Więcej informacji o tych wzorcach znajdziesz w opisach
PATTERN_LITERAL
,PATTERN_PREFIX
iPATTERN_SIMPLE_GLOB
w:PatternMatcher
zajęcia. - Gwiazdka (
- wprowadzone w:
- Poziom API 1
- zobacz też:
-
grantUriPermissions
atrybutu<provider>
.
<przyznaj-identyfikator-identyfikatora>
Treść strony i umieszczone na niej fragmenty kodu podlegają licencjom opisanym w Licencji na treści. Java i OpenJDK są znakami towarowymi lub zastrzeżonymi znakami towarowymi należącymi do firmy Oracle lub jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-07-27 UTC.
[null,null,["Ostatnia aktualizacja: 2025-07-27 UTC."],[],[],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"]]