本頁面由 Cloud Translation API 翻譯而成。

設定檔案分享

如要安全地提供應用程式檔案給其他應用程式，您必須將應用程式設為提供檔案的安全控制代碼，採內容 URI 格式。Android FileProvider 元件會產生內容 URI 產生的檔案。本課程將說明如何新增預設值在應用程式中實作 FileProvider，以及如何指定要提供給其他應用程式的檔案

注意：FileProvider 類別屬於 AndroidX 核心程式庫。資訊如果想在應用程式中加入這個程式庫，請參閱宣告依附元件。

指定 FileProvider

定義應用程式的 FileProvider 時，您必須在資訊清單。此項目指定使用產生內容 URI 的權限，以及指定應用程式可共用目錄的 XML 檔案名稱。

下列程式碼片段說明如何將 <provider> 元素，指定 FileProvider 類別、權威和 XML 檔案名稱：

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.example.myapp">
    <application
        ...>
        <provider
            android:name="androidx.core.content.FileProvider"
            android:authorities="com.example.myapp.fileprovider"
            android:grantUriPermissions="true"
            android:exported="false">
            <meta-data
                android:name="android.support.FILE_PROVIDER_PATHS"
                android:resource="@xml/filepaths" />
        </provider>
        ...
    </application>
</manifest>

在這個範例中，android:authorities 屬性會指定 URI 授權數量您要用於 FileProvider。在這個範例中，主機名稱為 com.example.myapp.fileprovider。為自己指定應用程式的主機名稱具有「fileprovider」字串的 android:package 值。瞭解詳情有關權威值，請參閱內容 URI 和 android:authorities 屬性。

應用程式的 <meta-data> 子元素 <provider> 指向一個 XML 檔案，用於指定您想要存取的目錄分享。android:resource 屬性是檔案的路徑和名稱，但不含 .xml 副檔名。下一節將說明此檔案的內容。

指定可共用的目錄

將 FileProvider 加入應用程式資訊清單後，您需要指定包含要共用檔案的目錄。如要指定請先在 res/xml/ 中建立 filepaths.xml 檔案子目錄在這個檔案中，新增以下項目的 XML 元素來指定目錄：每個目錄以下程式碼片段為 res/xml/filepaths.xml。該程式碼片段也示範如何共用子目錄位於內部儲存空間區域的 files/ 目錄：

<paths>
    <files-path path="images/" name="myimages" />
</paths>

在這個範例中，<files-path> 標記共用了應用程式內部儲存空間的 files/ 目錄。path 屬性共用 files/ 的 images/ 子目錄。name 屬性會指示 FileProvider 新增路徑區段將 myimages 設為 files/images/ 子目錄中檔案的內容 URI。

<paths> 元素可包含多個子項，每個子項都指定不同的要共用目錄除了 <files-path> 元素外，您還可以使用 <external-path> 元素共用外部儲存空間中的目錄。 <cache-path> 元素，用於共用內部快取中的目錄目錄。如要進一步瞭解指定共用目錄的子元素，請參閱 FileProvider 參考說明文件。

注意：XML 檔案是唯一可用來指定目錄的方式分享；您無法透過程式輔助方式新增目錄

現在，您已擁有 FileProvider 的完整規格可針對應用程式 files/ 目錄中的檔案產生內容 URI 內部儲存空間或 files/ 子目錄中的檔案。應用程式產生檔案的內容 URI，其中包含 <provider> 個元素 (com.example.myapp.fileprovider)， myimages/ 路徑，以及檔案名稱。

舉例來說，如果您根據FileProvider 您必須將檔案的內容 URI default_image.jpg，FileProvider 會傳回存取 URI：

content://com.example.myapp.fileprovider/myimages/default_image.jpg

如需其他相關資訊，請參閱：

分享檔案