sintaksis:
<grant-uri-permission android:path="string"
                      android:pathPattern="string"
                      android:pathPrefix="string" />
terdapat dalam:
<provider>
deskripsi:
Menentukan subkumpulan data aplikasi yang boleh diakses oleh penyedia konten induknya. Subkumpulan data ditunjukkan oleh bagian jalur dari URI content:. (Bagian otoritas URI mengidentifikasi penyedia konten.) Memberikan izin adalah salah satu cara agar klien penyedia yang biasanya tidak memiliki izin boleh mengakses datanya untuk mengatasi batasan tersebut satu kali.

Jika atribut grantUriPermissions penyedia konten diatur ke "true", izin dapat diberikan untuk setiap data dalam cakupan penyedia. Namun, jika atribut tersebut diatur ke "false", izin hanya dapat diberikan ke subkumpulan data yang ditentukan oleh elemen ini. Penyedia dapat berisi berapa pun elemen <grant-uri-permission>. Tiap-tiapnya hanya dapat menentukan satu jalur (hanya satu dari tiga atribut yang tersedia).

Untuk mengetahui informasi cara izin diberikan, lihat atribut grantUriPermissions milik elemen <intent-filter>.

atribut:
android:path
android:pathPrefix
android:pathPattern
Jalur yang mengidentifikasi satu atau beberapa subkumpulan data yang dapat diberi izin. Atribut path menentukan jalur lengkap; izin hanya dapat diberikan ke subkumpulan data tertentu yang diidentifikasi oleh jalur tersebut. Atribut pathPrefix menentukan bagian awal dari sebuah jalur; izin dapat diberikan ke semua subkumpulan data dengan jalur yang memiliki bagian awal tersebut. Atribut pathPattern menentukan jalur lengkap, tetapi yang dapat berisi karakter pengganti berikut:
  • Tanda bintang ('*') mencocokkan urutan dari 0 hingga sekian kemunculan karakter langsung yang mendahuluinya.

  • Titik diikuti tanda bintang (".*") mencocokkan urutan apa pun dari 0 hingga sekian karakter.

Karena '\' digunakan sebagai karakter escape saat string dibaca dari XML (sebelum diurai sebagai pola), Anda perlu melakukan double-escape: Misalnya, '*' akan ditulis sebagai "\\*" dan '\' literal akan ditulis sebagai "\\\\". Tindakan ini pada dasarnya sama dengan yang harus Anda tulis jika menyusun string dalam kode Java.

Untuk mengetahui informasi selengkapnya tentang jenis pola ini, lihat deskripsi PATTERN_LITERAL, PATTERN_PREFIX, dan PATTERN_SIMPLE_GLOB dalam class PatternMatcher.

diperkenalkan di:
API Level 1
lihat juga:
atribut grantUriPermissions dari elemen <provider>