語法:
<grant-uri-permission android:path="string"
                      android:pathPattern="string"
                      android:pathPrefix="string" />
包含於:
<provider>
說明:
指定父項內容供應者有權存取的應用程式資料。資料內容會以 content: URI 的路徑部分表示 (URI 的授權部分會標識內容供應者)。授予相關權限的方式,可讓提供者內原本無權存取其資料的用戶端擁有一次存取機會。

如果內容供應者的 grantUriPermissions 屬性為 true,則會授予對提供者名下所有資料的存取權限。不過,如果該屬性是 false,則只能授予對該元素所指定資料內容的存取權限。提供者可包含任意數量的 <grant-uri-permission> 元素。每個元素都只能指定一個路徑,使用三種可能屬性中的一個。

如要瞭解如何授予權限,請參閱 <intent-filter> 元素的 grantUriPermissions 屬性。

屬性:
android:path
android:pathPrefix
android:pathPattern
標識可授予權限的資料內容的路徑。path 屬性指定完整路徑。您只能將這項權限授予該路徑識別的特定資料子集。

pathPrefix 屬性指定路徑的初始部分。透過共用此初始部分的路徑,可將權限授予所有資料子集。pathPattern 屬性指定完整路徑,但可包含以下萬用字元:

  • 一個星號 (*),符合緊接前方且 0 個以上的字元序列。
  • 半形句號後面加上星號 (.*),符合 0 個以上字元的任何序列。

由於在從 XML 讀取字串時,系統會使用「\」做為逸出字元,因此在剖析為模式之前,您必須先進行雙重逸出。例如,將常值「*」寫入為「\\*」,常值「\」寫入為 \\\

如要進一步瞭解這些模式,請參閱 PatternMatcher 類別中 PATTERN_LITERALPATTERN_PREFIXPATTERN_SIMPLE_GLOB 的說明。

導入版本:
API 級別 1
另請參閱:
<provider> 元素的 grantUriPermissions 屬性