注：本文翻譯自Google官方的Android Developers Training文檔，譯者技術一般，由于喜愛安卓而產生了翻譯的念頭，純屬個人興趣愛好。

原文鏈接： http://developer.android.com/training/secure-file-sharing/setup-sharing.html

為了從你的應用安全地將一個文件發送給另一個應用，你需要配置你的應用來提供安全的文件句柄（URI的形式），Android的 FileProvider 組件會基于你在XML文件中的具體配置，為文件創建URI。這節課會向你展示如何在你的應用添加 FileProvider 的默認實現，以及如何指定你要共享的文件。

Note：

FileProvider 類是 v4 Support Library 中的。關于如何在你的應用中包含此庫，可以閱讀： Support Library Setup 。

一）. 指定 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
      
      
        ="android.support.v4.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 屬性字段指定了你希望使用的由 FileProvider 生成的URI的URI權威（URI authority）。在這個例子中，這個權威是 “ com.example.myapp.fileprovider ” 。對于你自己的應用，定義權威時，是在你的應用包名（ android:package 的值）之后追加“ fileprovider ”。為了學習更多關于權威的知識，可以閱讀： Content URIs ，以及 android:authorities 。

<provider> 下的子標簽 <meta-data> 指定了一個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 向在 “ files/images/ ” 子目錄中的文件URI 添加一個路徑分段標記 “ myimages ” 。

<paths> 標簽可以有多個子標簽，每一個子標簽都指定一個不同的要共享的目錄。除了 <files-path> 標簽，你可以使用 <external-path> 來分享位于外部存儲的文件，而 <cache-path> 標簽用來共享在你的內部緩存目錄下的目錄。學習更多關于指定共享目錄的子標簽的知識，可以閱讀： FileProvider 。

Note：

XML文件是你定義共享目錄的唯一方式，你不可以以代碼的形式添加目錄。

現在你有一個完整的 FileProvider 說明，它為在你應用的內部存儲中“ files/ ”目錄下創建文件的URI，或者是在“ files/ ”中的子目錄內的文件創建URI。當你的應用為一個文件創建了URI，它就包含了在 <provider> 標簽中指定的權力（“ com.example.myapp.fileprovider ” ），路徑“ myimages/ ” ，和文件的名字。

例如，如果你根據這節課的例子定義了一個 FileProvider ，然后你需要一個文件 “ default_image.jpg ” 的 URI ， FileProvider 會返回如下 URI ：

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

【Android Developers Training】 36. 設置文件共享