- sintaxis:
<grant-uri-permission android:path="string" android:pathPattern="string" android:pathPrefix="string" />
- se incluye en:
<provider>
- descripción:
- Especifica los subconjuntos de datos de app a los que el proveedor de contenido superior tiene permiso para acceder. Los subconjuntos de datos se indican en la parte de ruta de un URI
content:
. La parte de autoridad del URI identifica al proveedor de contenido. Otorgar permisos permite que los clientes del proveedor que normalmente no tienen permiso para acceder a sus datos superen esa restricción por única vez.Si el atributo
grantUriPermissions
de un proveedor de contenido estrue
, se puede otorgar permiso para cualquier dato del campo de acción del proveedor. Sin embargo, si ese atributo esfalse
, el permiso solo se otorga a los subconjuntos de datos que especifica este elemento. Un proveedor puede contener cualquier cantidad de elementos<grant-uri-permission>
, pero cada uno puede especificar una sola ruta, usando uno de los tres atributos posibles.Si deseas obtener información para otorgar el permiso, consulta el atributo
grantUriPermissions
del elemento<intent-filter>
. - atributos:
android:path
android:pathPrefix
android:pathPattern
- Es una ruta que identifica los subconjuntos de datos para los que se puede otorgar el permiso. El atributo
path
especifica una ruta de acceso completa. El permiso solo se puede otorgar al subconjunto de datos específico identificado por esa ruta.El atributo
pathPrefix
especifica la parte inicial de una ruta de acceso. Es posible otorgar permiso a todos los subconjuntos de datos con rutas de acceso que comparten esa parte inicial. El atributopathPattern
especifica una ruta de acceso completa que puede contener los siguientes comodines:- Un asterisco (
*
) coincide con una secuencia compuesta por cero a muchas repeticiones del carácter inmediatamente anterior. Un punto seguido de un asterisco (
.*
) coincide con cualquier secuencia compuesta por cero a muchos caracteres.
Debido a que
\
se usa como un carácter de escape cuando la cadena se lee desde XML, antes de que se analice como un patrón, deberás escapar dos veces. Por ejemplo, un*
literal se escribe como\\*
y una\
literal se escribe como\\\
.Para obtener más información sobre estos tipos de patrones, consulta las descripciones de
PATTERN_LITERAL
,PATTERN_PREFIX
yPATTERN_SIMPLE_GLOB
en la clasePatternMatcher
. - Un asterisco (
- primera inclusión:
- Nivel de API 1
- consulta también:
-
atributo
grantUriPermissions
del elemento<provider>
<grant-uri-permission>
El contenido y las muestras de código que aparecen en esta página están sujetas a las licencias que se describen en la Licencia de Contenido. Java y OpenJDK son marcas registradas de Oracle o sus afiliados.
Última actualización: 2025-07-27 (UTC)
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Falta la información que necesito","missingTheInformationINeed","thumb-down"],["Muy complicado o demasiados pasos","tooComplicatedTooManySteps","thumb-down"],["Desactualizado","outOfDate","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Problema con las muestras o los códigos","samplesCodeIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 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"]]