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

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

為了從你的應(yīng)用安全地將一個(gè)文件發(fā)送給另一個(gè)應(yīng)用，你需要配置你的應(yīng)用來提供安全的文件句柄（URI的形式），Android的 FileProvider 組件會(huì)基于你在XML文件中的具體配置，為文件創(chuàng)建URI。這節(jié)課會(huì)向你展示如何在你的應(yīng)用添加 FileProvider 的默認(rèn)實(shí)現(xiàn)，以及如何指定你要共享的文件。

Note：

FileProvider 類是 v4 Support Library 中的。關(guān)于如何在你的應(yīng)用中包含此庫，可以閱讀： Support Library Setup 。

一）. 指定 FileProvider

為你的應(yīng)用定義一個(gè) FileProvider ，需要在你的清單文件中的一個(gè)字段。這個(gè)字段指明了使用創(chuàng)建的URI權(quán)限，以及一個(gè)XML文件，它指定了你的應(yīng)用可以共享的目錄路徑。

下面的例子展示的是，如何在清單文件中添加 <provider> 標(biāo)簽，來指定 FileProvider 類，權(quán)限和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
      
      
        >
      
    

在這個(gè)例子中， android:authorities 屬性字段指定了你希望使用的由 FileProvider 生成的URI的URI權(quán)威（URI authority）。在這個(gè)例子中，這個(gè)權(quán)威是 “ com.example.myapp.fileprovider ” 。對(duì)于你自己的應(yīng)用，定義權(quán)威時(shí)，是在你的應(yīng)用包名（ android:package 的值）之后追加“ fileprovider ”。為了學(xué)習(xí)更多關(guān)于權(quán)威的知識(shí)，可以閱讀： Content URIs ，以及 android:authorities 。

<provider> 下的子標(biāo)簽 <meta-data> 指定了一個(gè)XML文件，它指定了你希望共享的目錄路徑。“ android:resource ”屬性字段是這個(gè)文件的路徑和名字（無“ .xml ”后綴）。該文件的內(nèi)容將在下一節(jié)討論。

二）. 指定可共享目錄路徑

一旦你在你的清單文件中為你的應(yīng)用添加了 FileProvider ，你需要指定你希望共享文件的目錄路徑。為了指定這個(gè)路徑，我們首先在“ res/xml/ ”下創(chuàng)建文件“ filepaths.xml ”。在這個(gè)文件中，通過為每一個(gè)目錄添加一個(gè)XML標(biāo)簽。下面的例子展示的是一個(gè)“ res/xml/filepaths.xml ”的例子。這個(gè)例子也說明了如何在你的內(nèi)部存儲(chǔ)區(qū)域共享一個(gè)“ files/ ”目錄的子目錄：

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

在這個(gè)例子中， <files-path> 標(biāo)簽共享的是在你的應(yīng)用的內(nèi)部存儲(chǔ)中 “ files/ ” 目錄下的目錄。 “ path ” 屬性字段共享了 “ files/ ” 目錄下的子目錄 “ images/ ” 。 “ name ” 屬性字段告知 FileProvider 向在 “ files/images/ ” 子目錄中的文件URI 添加一個(gè)路徑分段標(biāo)記 “ myimages ” 。

<paths> 標(biāo)簽可以有多個(gè)子標(biāo)簽，每一個(gè)子標(biāo)簽都指定一個(gè)不同的要共享的目錄。除了 <files-path> 標(biāo)簽，你可以使用 <external-path> 來分享位于外部存儲(chǔ)的文件，而 <cache-path> 標(biāo)簽用來共享在你的內(nèi)部緩存目錄下的目錄。學(xué)習(xí)更多關(guān)于指定共享目錄的子標(biāo)簽的知識(shí)，可以閱讀： FileProvider 。

Note：

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

現(xiàn)在你有一個(gè)完整的 FileProvider 說明，它為在你應(yīng)用的內(nèi)部存儲(chǔ)中“ files/ ”目錄下創(chuàng)建文件的URI，或者是在“ files/ ”中的子目錄內(nèi)的文件創(chuàng)建URI。當(dāng)你的應(yīng)用為一個(gè)文件創(chuàng)建了URI，它就包含了在 <provider> 標(biāo)簽中指定的權(quán)力（“ com.example.myapp.fileprovider ” ），路徑“ myimages/ ” ，和文件的名字。

例如，如果你根據(jù)這節(jié)課的例子定義了一個(gè) FileProvider ，然后你需要一個(gè)文件 “ default_image.jpg ” 的 URI ， FileProvider 會(huì)返回如下 URI ：

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

【Android Developers Training】 36. 設(shè)置文件共享