- Sintaxe:
<path-permission android:path="string" android:pathPrefix="string" android:pathPattern="string" android:permission="string" android:readPermission="string" android:writePermission="string" />
- contido em:
<provider>
- descrição:
- Define o caminho e as permissões necessárias para um subconjunto específico de dados em um provedor de conteúdo. Esse elemento pode ser especificado várias vezes para fornecer vários caminhos.
- atributos:
android:path
- Um caminho de URI completo para um subconjunto de dados do provedor de conteúdo.
A permissão pode ser concedida somente aos dados específicos identificados por esse caminho.
Quando usado para fornecer conteúdo de sugestão de pesquisa, ele é anexado
com
/search_suggest_query
. android:pathPrefix
- A parte inicial de um caminho de URI para um subconjunto de dados do provedor de conteúdo. A permissão pode ser concedida a todos os subconjuntos de dados com caminhos que compartilham essa parte inicial.
android:pathPattern
- Um caminho de URI completo para um subconjunto de dados do provedor de conteúdo,
mas que pode usar estes caracteres curingas:
- Um asterisco (
*
) corresponde a uma sequência de zero a várias ocorrências do caractere imediatamente anterior. - Um ponto seguido por um asterisco (
.*
) corresponde a qualquer sequência de zero ou mais caracteres.
Como a barra invertida (
\
) é usada como caractere de escape quando a string é lida do XML, antes de ela ser analisada como padrão, é necessário um escape duplo. Por exemplo, um*
literal é escrito como "\\*
" e um\
literal é escrito como "\\\
". É o mesmo que você escreve ao construir a string na linguagem de programação Java.Para mais informações sobre esses tipos de padrões, consulte as descrições de
PATTERN_LITERAL
,PATTERN_PREFIX
ePATTERN_SIMPLE_GLOB
na classePatternMatcher
. - Um asterisco (
android:permission
- O nome de uma permissão que os clientes precisam ter para ler ou gravar os
dados do provedor de conteúdo. Esse atributo é uma maneira conveniente de definir
uma única permissão para leitura e gravação. No entanto, os atributos
readPermission
ewritePermission
têm precedência em relação a esse. android:readPermission
- Uma permissão que os clientes precisam ter para consultar o provedor de conteúdo.
android:writePermission
- Uma permissão que os clientes precisam ter para fazer mudanças nos dados controlados pelo provedor de conteúdo.
- introduzido no:
- Nível 4 da API
- confira também:
SearchManager
Manifest.permission
- Dicas de segurança
<permissão-caminho>
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,["# <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)"]]