Android Developers

語法：

<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_LITERAL、PATTERN_PREFIX 和 PATTERN_SIMPLE_GLOB 的說明。

導入版本：

API 級別 1

另請參閱：

<provider> 元素的 grantUriPermissions 屬性