語法：

   <provider android:authorities="list"
              android:directBootAware=["true" | "false"]
              android:enabled=["true" | "false"]
              android:exported=["true" | "false"]
              android:grantUriPermissions=["true" | "false"]
              android:icon="drawable resource"
              android:initOrder="integer"
              android:label="string resource"
              android:multiprocess=["true" | "false"]
              android:name="string"
              android:permission="string"
              android:process="string"
              android:readPermission="string"
              android:syncable=["true" | "false"]
              android:writePermission="string" >
        . . .
    </provider>

　　

 

包含于：

<application>

可包含：

<meta-data>
<grant-uri-permission>
<path-permission>

說明：

聲明內容提供程序組件。內容提供程序是 ContentProvider 的子類，可提供對由應用管理的數據的結構化訪問機制。應用中的所有內容提供程序都必須在清單文件的 <provider> 元素中定義；否則，系統將不知道它們，也不會運行它們。

您只能聲明屬于您的應用的內容提供程序，而不應聲明在您的應用中使用的屬于其他應用的內容提供程序。

Android 系統根據授權方字符串（提供程序的內容 URI 的一部分）來存儲對內容提供程序的引用。例如，假設您想要訪問用來存儲專業醫護人員相關信息的內容提供程序。為此，您可以調用 ContentResolver.query() 方法，它接受用來標識提供程序的 URI（以及其他參數）：

    content://com.example.project.healthcareprovider/nurses/rn

　　

content: 架構將 URI 標識為指向 Android 內容提供程序的內容 URI。授權方 com.example.project.healthcareprovider 標識提供程序本身；Android 系統會在已知提供程序及其授權方的列表中查詢該授權方。子字符串 nurses/rn 是一個路徑，內容提供程序可使用它來標識提供程序數據的子集。

請注意，在 <provider> 元素中定義提供程序時，請勿在 android:name 參數中添加架構或路徑，只能添加授權方。

如需了解如何使用和開發內容提供程序，請參閱 API 指南 - 內容提供程序。

屬性：

android:authorities

一個或多個 URI 授權方的列表，這些 URI 授權方用于標識內容提供程序提供的數據。列出多個授權方時，用分號將其名稱分隔開來。為避免沖突，授權方名稱應遵循 Java 樣式的命名慣例（如 com.example.provider.cartoonprovider）。通常，它是實現提供程序的 ContentProvider 子類的名稱。

沒有默認值。必須至少指定一個授權方。

android:enabled

系統是否可以實例化內容提供程序。如果可以，則設為“true”；如果不能，則設為“false”。默認值為“true”。

<application> 元素具有自己的 enabled 屬性，該屬性適用于所有應用組件，包括內容提供程序。<application> 和 <provider> 屬性必須都為“true”（這正是它們兩者的默認設置），才會啟用內容提供程序。如果其中任一屬性為“false”，就會停用提供程序；無法將其實例化。

android:directBootAware

內容提供程序是否可感知直接啟動 (direct-boot)；即，它是否可以在用戶解鎖設備之前運行。

注意：在直接啟動期間，應用中的內容提供程序只能訪問設備保護存儲空間內的數據。

默認值為 "false"。

android:exported

內容提供程序是否可供其他應用使用：

• true：提供程序可供其他應用使用。任何應用均可使用提供程序的內容 URI 來訪問它，但需依據為提供程序指定的權限進行訪問。
• false：提供程序不可供其他應用使用。設置 android:exported="false" 可僅限您的應用訪問提供程序。只有與提供程序具有相同的用戶 ID (UID) 的應用或者通過 android:grantUriPermissions 元素被臨時授予對提供程序的訪問權限的應用才能訪問提供程序。

由于此屬性是在 API 級別 17 中引入的，因此所有搭載 API 級別 16 及更低級別的設備的行為方式就像將此屬性設為 "true" 一樣。對于搭載 API 級別 17 及更高級別的設備，如果您將 android:targetSdkVersion 設為 17 或更高版本，則默認值為 "false"。

您可以設置 android:exported="false" 并且仍然限制對提供程序的訪問，方法是使用 permission 屬性來設置相應權限。

android:grantUriPermissions

是否可以向一般無權訪問內容提供程序的數據的組件授予訪問這些數據的權限，從而暫時克服由 readPermission、writePermission、permission 和 exported 屬性施加的限制。如果可以授予權限，則設為“true”；如果不能授予權限，則設為“false”。如果設為“true”，則可以授予對內容提供程序的任何數據的權限。如果設為“false”，則只能授予對 <grant-uri-permission> 子元素中列出的數據子集（如果有）的權限。默認值為“false”。

通過授予權限，可讓應用組件對受權限保護的數據進行一次性訪問。例如，當電子郵件包含附件時，郵件應用可以要求適當的查看器來打開它，即使該查看器沒有查看內容提供程序的所有數據的常規權限也是如此。

在這種情況下，通過用于激活組件的 Intent 對象中的 FLAG_GRANT_READ_URI_PERMISSION 和 FLAG_GRANT_WRITE_URI_PERMISSION 標志來授予權限。例如，郵件應用可能會將 FLAG_GRANT_READ_URI_PERMISSION 放入傳遞給 Context.startActivity() 的 Intent。權限特定于 Intent 中的 URI。

如果您通過將此屬性設為“true”或通過定義 <grant-uri-permission> 子元素來啟用此功能，則必須在從提供程序中刪除覆蓋的 URI 后調用 Context.revokeUriPermission()。

另請參閱 <grant-uri-permission> 元素。

android:icon

一個表示內容提供程序的圖標。必須將此屬性設為對包含圖片定義的可繪制資源的引用。如果未設置此屬性，則改用為整個應用指定的圖標（請參閱 <application> 元素的 icon 屬性）。

android:initOrder

應按什么順序實例化內容提供程序，這是相對于由同一進程托管的其他內容提供程序的順序。當內容提供程序之間存在依賴關系時，為每個提供程序設置此屬性可確保按這些依賴關系要求的順序創建這些提供程序。值是一個簡單的整數，數值越高，初始化順序越靠前。

android:label

所提供內容的用戶可讀標簽。如果未設置此屬性，則改用為整個應用設置的標簽（請參閱 <application> 元素的 label 屬性）。

應將標簽設為對字符串資源的引用，以便可以像界面中的其他字符串一樣進行本地化。不過，為了方便您開發應用，也可以將其設為原始字符串。

android:multiprocess

如果應用在多個進程中運行，則此屬性決定了是否會創建內容提供程序的多個實例。如果設為 true，則每個應用進程都有自己的內容提供程序對象。如果設為 false，則應用的進程僅共享一個內容提供程序對象。默認值為 false。

將此標志設為 true 可以通過減少進程間通信的開銷來提高性能，但也會增加每個進程的內存占用量。

android:name

實現內容提供程序的類的名稱，它是 ContentProvider 的子類。這應該是一個完全限定類名（如“com.example.project.TransportationProvider”）。不過，作為一種簡寫形式，如果名稱的第一個字符是句點，則會將其附加到 <manifest> 元素中指定的軟件包名稱。

沒有默認值。必須指定相應名稱。

android:permission

客戶端為了讀取或寫入內容提供程序的數據而必須具備的權限的名稱。使用此屬性可以方便地設置適用于讀取和寫入的單一權限。不過，readPermission、writePermission 和 grantUriPermissions 屬性優先于此屬性。如果也設置了 readPermission 屬性，則該屬性控制對查詢內容提供程序的訪問權限。如果設置了 writePermission 屬性，則該屬性控制對修改提供程序的數據的訪問權限。

如需詳細了解權限，請參閱簡介中的權限部分以及一篇單獨的文檔 - 安全與權限。

android:process

一個進程的名稱，內容提供程序應在該進程中運行。通常，應用的所有組件都在為應用創建的默認進程中運行。它與應用軟件包的名稱相同。<application> 元素的 process 屬性可以為所有組件設置不同的默認值。但是，每個組件都可以使用自己的 process 屬性來替換默認值，從而允許您讓應用跨越多個進程。

如果為此屬性分配的名稱以冒號（“:”）開頭，則會在需要時創建一個應用專用的新進程，并且 Activity 將在該進程中運行。如果進程名稱以小寫字符開頭，則 Activity 將在采用該名稱的全局進程中運行，前提是它具有相應權限。這樣，不同應用中的組件就可以共享進程，從而減少資源使用量。

android:readPermission

客戶端要查詢內容提供程序而必須具備的權限。

如果提供程序將 android:grantUriPermissions 設為 true，或者如果給定的客戶端滿足 <grant-uri-permission> 子元素的條件，則客戶端可以獲得對內容提供程序的數據的臨時讀取訪問權限。

另請參閱 permission 和 writePermission 屬性。

android:syncable

由內容提供程序控制的數據是否要與服務器上的數據同步。如果要同步，則設為“true”；如果不同步，則設為“false”。

android:writePermission

客戶端要對由內容提供程序控制的數據進行更改而必須具備的權限。

如果提供程序將 android:grantUriPermissions 設為 true，或者如果給定的客戶端滿足 <grant-uri-permission> 子元素的條件，則客戶端可以獲得對修改內容提供程序的數據的臨時寫入訪問權限。

另請參閱 permission 和 readPermission 屬性。

<receiver>