<grant-uri-permission>
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
- Sintaxe:
<grant-uri-permission android:path="string"
android:pathPattern="string"
android:pathPrefix="string" />- contido em:
<provider>- descrição:
- Especifica os subconjuntos de dados do app para os quais o provedor de conteúdo pai
tem permissão de acesso. Subconjuntos de dados são indicados pela parte do caminho de um
URI de
content:. A parte de autoridade do URI identifica o
provedor de conteúdo.
A concessão de permissão é uma forma de autorizar os clientes do provedor que
normalmente não têm permissão para acessar os dados dele ignorarem essa restrição
uma única vez.
Se o atributo grantUriPermissions
de um provedor de conteúdo for true, a permissão poderá ser concedida para qualquer dado
do provedor. No entanto, se esse atributo for false, a permissão
será concedida somente a subconjuntos de dados especificados por esse elemento.
Um provedor pode ter quantos elementos <grant-uri-permission> quiser.
Cada um pode especificar apenas um caminho, ou seja, apenas um dos três atributos possíveis.
Para mais informações sobre como a permissão é concedida, consulte o
atributo
grantUriPermissions do elemento
<intent-filter>.
- atributos:
android:path
android:pathPrefix
android:pathPattern- Um caminho que identifica os subconjuntos de dados para os quais a permissão
pode ser concedida. O atributo
path especifica um caminho completo.
A permissão pode ser concedida apenas ao subconjunto de dados específico identificado
por esse caminho.
O atributo pathPrefix especifica a parte inicial de um caminho.
A permissão pode ser concedida a todos os subconjuntos de dados com caminhos que compartilham essa
parte inicial.
O atributo pathPattern especifica um caminho completo, mas
que pode conter os caracteres curinga abaixo:
Como \ é usado como caractere de escape quando a string é lida
do XML, antes de fazer a análise como padrão, você precisa do escape duplo.
Por exemplo, um * literal é escrito como \\* e um
\ literal é escrito como \\\.
Para mais informações sobre esses tipos de padrões, consulte as descrições de
PATTERN_LITERAL,
PATTERN_PREFIX e
PATTERN_SIMPLE_GLOB na classe
PatternMatcher.
- introduzido no:
- Nível 1 da API
- confira também:
-
grantUriPermissions
atributo do
elemento
<provider>
O conteúdo e os exemplos de código nesta página estão sujeitos às licenças descritas na Licença de conteúdo. Java e OpenJDK são marcas registradas da Oracle e/ou suas afiliadas.
Última atualização 2025-07-27 UTC.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 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"]]
