<grant-uri-permission>

語法:
<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 屬性