<grant-uri-permission>

sintaxis:

<grant-uri-permission android:path="string"
                          android:pathPattern="string"
                          android:pathPrefix="string" />

incluida en:

<provider>

descripción:

Especifica los subconjuntos de datos de app a los que el proveedor de contenido 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 es "true", se puede otorgar permiso para cualquier dato del campo de acción del proveedor. Sin embargo, si ese atributo es "false", el permiso solo se puede otorgar a los subconjuntos de datos especificados por este elemento. Un proveedor puede contener cualquier cantidad de elementos <grant-uri-permission>, pero cada uno puede especificar una sola ruta (solo uno de los tres atributos posibles).

Para obtener información sobre cómo se otorga el permiso, consulta el atributo grantUriPermissions del elemento <intent-filter>.

atributos:

android:path android:pathPrefix android:pathPattern

Es una ruta que identifica el subconjunto o los subconjuntos de datos para los que se puede otorgar el permiso. El atributo path especifica una ruta completa; se puede otorgar permiso solo al subconjunto de datos específico identificado por esa ruta. El atributo pathPrefix especifica la parte inicial de una ruta; se puede otorgar permiso a todos los subconjuntos de datos con rutas que comparten esa parte inicial. El atributo pathPattern especifica una ruta completa que puede contener los siguientes comodines:

Un asterisco ("*") indica una secuencia entre 0 y varias ocurrencias del carácter inmediatamente anterior.
Un punto seguido de un asterisco (".*") indica una secuencia entre 0 y varios caracteres.

Debido a que "\" se usa como carácter de escape cuando la string se lee desde XML (antes de que se analice como patrón), deberá escapar dos veces: por ejemplo, un "*" literal se escribirá como "\\*" y un "" literal se escribiría como "\\\\". Esto es básicamente lo mismo que necesitarías escribir si construyes la string con código Java.

Para obtener más información sobre estos tipos de patrones, consulta las descripciones de PATTERN_LITERAL, PATTERN_PREFIX y PATTERN_SIMPLE_GLOB en la clase PatternMatcher.

incluida por primera vez en:

Nivel de API 1

consulta también:

atributo grantUriPermissions del elemento <provider>