【Android Developers Training】 36. 设置文件

注：本文翻译自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. 设置文件共享