您现在的位置是:首页 > 文章详情

Android 7.0之访问文件的权限和FileProvider类

日期:2017-05-18点击:314


转载请标明出处:
http://blog.csdn.net/djy1992/article/details/72533310
本文出自:【奥特曼超人的博客】

权限更改

Android 7.0 做了一些权限更改,这些更改可能会影响您的应用。Android7.1的可以看这篇文章:
《android 7.1悬浮窗系统权限问题》


系统权限更改

目录权限

为了提高私有文件的安全性,面向 Android 7.0 或更高版本的应用私有目录被限制访问 (0700)。此设置可防止私有文件的元数据泄漏,如它们的大小或存在性。此权限更改有多重副作用:

私有文件的文件权限不应再由所有者放宽,为使用 MODE_WORLD_READABLE 和或 MODE_WORLD_WRITEABLE 而进行的此类尝试将触发 SecurityException

  • 注:迄今为止,这种限制尚不能完全执行。应用仍可能使用原生 API 或 File API 来修改它们的私有目录权限。但是,我们强烈反对放宽私有目录的权限。

文件权限更改

FileUriExposedException 异常

传递软件包网域外的 file:// URI 可能给接收器留下无法访问的路径。

因此,尝试传递 file:// URI 会触发 FileUriExposedException。分享私有文件内容的推荐方法是使用 FileProvider。

DownloadManager 不再按文件名分享私人存储的文件。旧版应用在访问 COLUMN_LOCAL_FILENAME 时可能出现无法访问的路径。

面向 Android 7.0 或更高版本的应用在尝试访问 COLUMN_LOCAL_FILENAME 时会触发 SecurityException。

通过使用
DownloadManager.Request.setDestinationInExternalFilesDir()
或者
DownloadManager.Request.setDestinationInExternalPublicDir()

将下载位置设置为公共位置的旧版应用仍可以访问 COLUMN_LOCAL_FILENAME 中的路径,但是我们强烈反对使用这种方法。

对于由 DownloadManager 公开的文件,首选的访问方式是使用ContentResolver.openFileDescriptor()

在应用间共享文件 StrictMode API

对于面向 Android 7.0 的应用,Android 框架执行的 StrictMode API 政策禁止在您的应用外部公开 file:// URI。

如果一项包含文件 URI 的 intent 离开您的应用,则应用出现故障,并出现 FileUriExposedException 异常。

要在应用间共享文件,您应发送一项 content:// URI,并授予 URI 临时访问权限。

进行此授权的最简单方式是使用 FileProvider 类。如需了解有关权限和共享文件的详细信息,请谷歌开发中的《共享文件权限操作方法》

  • 设置文件共享
    了解如何设置您的应用程序共享文件。

  • 共享文件
    了解如何通过生成文件的内容URI,向URI授予访问权限,并向应用程序发送URI,从而向另一个应用程序提供文件。

  • 请求共享文件
    了解如何请求另一个应用程序共享的文件,接收该文件的内容URI,并使用内容URI打开文件。

  • 获取文件信息
    学习如何应用程序可以使用由fileprovider检索包括MIME类型和文件大小,文件信息生成的内容URI。


FileProvider

FileProvider,是Android 7.0新增的一个类,该类位于v4包下的android.support.v4.content.FileProvider,使用方法和ContentProvider类似,操作步骤如下:

一、在资源文件夹res/xml下新建file_provider.xml文件,文件声明权限请求的路径,代码如下:

 <?xml version="1.0" encoding="utf-8"?> <paths xmlns:android="http://schemas.android.com/apk/res/android"> <!--对应外部内存卡根目录:Environment.getExternalStorageDirectory()--> <external-path name="ext_root" path="/" /> <!--指定文件存储的区块和区块的相对路径--> <files-path name="my_path" path="images/"/> </paths>

属性说明:

指定文件存储的区块和区块的相对路径

  • name:是一个虚设的文件名(可以自由命名),对外可见路径的一部分,隐藏真实文件目录
  • path:是一个相对目录,相对于当前的子标签根目录,:表示内部内存卡根目录,对应根目录等价于Context.getFilesDir(),完整路径:/data/use/mnt/sdcard/com.immqy.dujinyang/files

这里的path要对应上相关路径,这里是想根目录,不指定特别目录,所以直接用"/"即可。

<paths>根标签下可以添加的子标签也是有限的,除了上述的提到的这个子标签外,还包括下面几个:

  1. <cache-path>,表示应用默认缓存根目录,对应根目录等价于getCacheDir(),查看完整路径:/data/user/0/cn.teachcourse.demos/cache

  2. <external-path>,表示外部内存卡根目录,对应根目录等价于
    Environment.getExternalStorageDirectory(), 路径:/storage/emulated/0

  3. <external-files-path>,表示外部内存卡根目录下的APP公共目录,对应根目录等价于
    Context的getExternalFilesDir(String) , 路径:
    /storage/emulated/0/Android/data/com.immqy.www

  4. <external-cache-path>,表示外部内存卡根目录下的APP缓存目录,对应根目录等价于Context.getExternalCacheDir(),路径:
    /storage/emulated/0/Android/data/cn.teachcourse.demos/cache

示例:
最终,在file_provider.xml文件中,添加上述5种类型的临时访问权限的文件目录,代码如下:

<?xml version="1.0" encoding="utf-8"?> <paths xmlns:android="http://schemas.android.com/apk/res/android"> <!-- 1、name对应的属性值,开发者可以自由定义; 2、path对应的属性值,当前external-path标签下的相对路径 比如:/storage/emulated/0/92Recycle-release.apk sdcard路径:/storage/emulated/0(WriteToReadActivity.java:176) at cn.teachcourse.nougat.WriteToReadActivity.onClick(WriteToReadActivity.java:97) at android.view.View.performClick(View.java:5610) at android.view.View$PerformClick.run(View.java:22265) 相对路径:/ --> <!--1、对应内部内存卡根目录:Context.getFileDir()--> <files-path  name="int_root" path="/" /> <!--2、对应应用默认缓存根目录:Context.getCacheDir()--> <cache-path  name="app_cache" path="/" /> <!--3、对应外部内存卡根目录:Environment.getExternalStorageDirectory()--> <external-path  name="ext_root" path="pictures/" /> <!--4、对应外部内存卡根目录下的APP公共目录:Context.getExternalFileDir(String)--> <external-files-path  name="ext_pub" path="/" /> <!--5、对应外部内存卡根目录下的APP缓存目录:Context.getExternalCacheDir()--> <external-cache-path  name="ext_cache" path="/" /> </paths>

所以生成指定文件的Content URI的步骤:

  • 确定上述用哪一种 (5种类型)
  • 明确指定文件的完整路径(包括目录、文件名)
  • 调用getUriForFile()方法生成

除了普通的授权,还有一种是Intent发送对外授权,对外提供可访问的Content URI,在重写的startActivityResult()方法中获取授予临时权限的Content URI或向用户提供可访问的接口来获取文件,后面的这种方式获取文件后转换成Content URI。

  • 请求授予访问公共目录的权限,代码如下
 if (Build.VERSION.SDK_INT > 23) { /**Android 7.0以上的方式**/ mStorageManager = this.getSystemService(StorageManager.class); StorageVolume storageVolume = mStorageManager.getPrimaryStorageVolume(); Intent intent = storageVolume.createAccessIntent(Environment.DIRECTORY_PICTURES); startActivityForResult(intent, REQUEST_DCODE_GRAINT_URI); }
  • 重写的startActivityResult()方法中获取授予临时权限的Content URI,代码如下:
 @Override protected void onActivityResult(int requestCode, int resultCode, Intent data) { super.onActivityResult(requestCode, resultCode, data); switch (requestCode) { case REQUEST_DCODE_GRAINT_URI: updateDirectoryEntries(data.getData()); Log.d(TAG, "onActivityResult:Uri= "+data.getData()); break; } }
  • 查询Environment.DIRECTORY_PICTURES目录,返回的Content URI包含的文件和文件类型相关信息,代码如下:
private static final String[] DIRECTORY_SELECTION = new String[]{ DocumentsContract.Document.COLUMN_DISPLAY_NAME, DocumentsContract.Document.COLUMN_MIME_TYPE, DocumentsContract.Document.COLUMN_DOCUMENT_ID, }; @TargetApi(Build.VERSION_CODES.LOLLIPOP) private void updateDirectoryEntries(Uri uri) { ContentResolver contentResolver = this.getContentResolver(); Uri docUri = DocumentsContract.buildDocumentUriUsingTree(uri, DocumentsContract.getTreeDocumentId(uri)); Uri childrenUri = DocumentsContract.buildChildDocumentsUriUsingTree(uri, DocumentsContract.getTreeDocumentId(uri)); try (Cursor docCursor = contentResolver .query(docUri, DIRECTORY_SELECTION, null, null, null)) { while (docCursor != null && docCursor.moveToNext()) { mPath_tv.setText(docCursor.getString(docCursor.getColumnIndex( DocumentsContract.Document.COLUMN_DISPLAY_NAME))); } } try (Cursor childCursor = contentResolver .query(childrenUri, DIRECTORY_SELECTION, null, null, null)) { while (childCursor != null && childCursor.moveToNext()) { String fileName = childCursor.getString(childCursor.getColumnIndex( DocumentsContract.Document.COLUMN_DISPLAY_NAME)); String mimeType = childCursor.getString(childCursor.getColumnIndex( DocumentsContract.Document.COLUMN_MIME_TYPE)); Log.e(TAG, "Directory: "+fileName+"\n"+mimeType); } } }

生成Content URI的临时授权:
上一步并没有获得指定文件的读写权限,想要获得文件的读写权限需要调用Context.grantUriPermission(package, Uri, mode_flags)方法,该方法向指定包名的应用程序申请获得读取或者写入文件的权限,参数说明如下:

  • package:指定应用程序的包名,Android Studio真正的包名指build.gradle声明的applicationId属性值;getPackageName():指AndroidManifest.xml文件声明的package属性值,如果两者不一致,就不能提供getPackageName()获取包名,否则报错!
  • Uri:指定请求授予临时权限的URI,例如:contentUri
  • mode_flags:指定授予临时权限的类型,选择其中一个常量或两个:Intent.FLAG_GRANT_READ_URI_PERMISSION,Intent.FLAG_GRANT_WRITE_URI_PERMISSION
    授予文件的临时读取或写入权限,如果不再需要了,TeachCourse该如何撤销授予呢?撤销权限有两种方式:第一种:通过调用revokeUriPermission()撤销,第二种:重启系统后自动撤销
File imagePath = new File(Environment.getExternalStorageDirectory(), "download"); File newFile = new File(imagePath, "miqiyun_image.jpg"); Uri contentUri = getUriForFile(getContext(), "com.immqy.karl-dujinyang", newFile); 

二、AndroidManifest.xml 添加组件 provider 相关信息,类似组件 activity ,指定resource属性引用上一步创建的xml文件(后面会详细介绍各个属性的用法),代码如下:

 <!-- 定义FileProvider --> <provider  android:name="android.support.v4.content.FileProvider" android:authorities="@string/pack_name" android:exported="false" android:grantUriPermissions="true"> <meta-data  android:name="android.support.FILE_PROVIDER_PATHS" android:resource="@xml/file_provider" /> </provider>

属性说明:

  • android:name:对应属性值:android.support.v4.content.FileProvider或者子类完整路径
  • android:authorities:对应属性值是一个常量,通常定义的方式packagename.fileprovider,如:com.immqy.dujinyang.fileprovider
  • android:exported:对应属性值是一个boolean变量,设置为false
  • android:grantUriPermissions:对应属性值也是一个boolean变量,设置为true,允许获得文件临时的访问权限

    关联res/xml文件夹下创建的file_provider.xml文件,需要在标签内,添加子标签,设置标签的属性值,包括:

  • 标签 android:name:对应属性值是一个固定的系统常量android.support.FILE_PROVIDER_PATHS
  • 标签 android:resource:对应属性值指向我们的xml文件 @xml/file_provider

三、代码上做动态权限申请,使用getUriForFile()和grantUriPermission(),代码如下:

 if (Build.VERSION.SDK_INT > 23) { /**Android 7.0以上的方式**/ Uri contentUri = getUriForFile(this, getString(R.string.pack_name), file); grantUriPermission(getPackageName(), contentUri, Intent.FLAG_GRANT_WRITE_URI_PERMISSION); intent.putExtra(MediaStore.EXTRA_OUTPUT, contentUri); } 

注意:申请的是FLAG_GRANT_WRITE_URI_PERMISSION

测试:修改build.gradle文件compileSdkVersion大于或等于24,targetSdkVersion等于24,然后使用Android 7.0模拟器运行Demo,完成无误。




|| 版权声明:本文为博主杜锦阳原创文章,转载请注明出处。

原文链接:https://yq.aliyun.com/articles/237737
关注公众号

低调大师中文资讯倾力打造互联网数据资讯、行业资源、电子商务、移动互联网、网络营销平台。

持续更新报道IT业界、互联网、市场资讯、驱动更新,是最及时权威的产业资讯及硬件资讯报道平台。

转载内容版权归作者及来源网站所有,本站原创内容转载请注明来源。

文章评论

共有0条评论来说两句吧...

文章二维码

扫描即可查看该文章

点击排行

推荐阅读

最新文章