深入理解Android 7.0系统权限更改相关文档

摘要:

Android 6.0之后的版本增加了运行时权限,应用程序在执行每个需要系统权限的功能时,需要添加权限请求代码(默认权限禁止),否则应用程序无法响应;Android 7.0在Android 6.0的基础上,对系统权限进一步更改,这次的权限更改包括三个方面:

  1. APP应用程序的私有文件不再向使用者放宽
  2. Intent组件传递file://URI的方式可能给接收器留下无法访问的路径,触发FileUriExposedException异常,推荐使用FileProvider
  3. DownloadManager不再按文件名分享私人存储的文件。旧版应用在访问COLUMN_LOCAL_FILENAME时可能出现无法访问的路径。面向 Android 7.0 或更高版本的应用在尝试访问 COLUMN_LOCAL_FILENAME 时会触发 SecurityException

简单的三句话,无法让TeachCourse真正理解Android 7.0系统权限更改的含义,如果不按照文档的方式去做,API 24开发的应用程序是否就用不了?

Android 7.0系统权限变更

一、深入理解FileProvider

FileProvider属于Android 7.0新增的一个类,该类位于v4包下,详情可见android.support.v4.content.FileProvider,使用方法类似与ContentProvider,简单概括为三个步骤,这里先以调用系统相机拍照并保存sdcard公共目录为例,演示使用过程:

  • 在资源文件夹res/xml下新建file_provider.xml文件,文件声明权限请求的路径,代码如下:
  1. <?xml version=”1.0″ encoding=”utf-8″?>
  2. <paths xmlns:android=“http://schemas.android.com/apk/res/android”>
  3. <!–3、对应外部内存卡根目录:Environment.getExternalStorageDirectory()–>
  4. <external-path name=“ext_root” path=“/” />
  5. </paths>
  • AndroidManifest.xml添加组件provider相关信息,类似组件activity,指定resource属性引用上一步创建的xml文件(后面会详细介绍各个属性的用法),代码如下:
  1. <!– 定义FileProvider –>
  2. <provider
  3. android:name=“android.support.v4.content.FileProvider”
  4. android:authorities=“@string/install_apk_path”
  5. android:exported=“false”
  6. android:grantUriPermissions=“true”>
  7. <meta-data
  8. android:name=“android.support.FILE_PROVIDER_PATHS”
  9. android:resource=“@xml/file_provider” />
  10. </provider>
  • *后一步,Java代码申请权限,使用新增的方法getUriForFile()grantUriPermission(),代码如下(后面会详细介绍方法对应参数的使用):
  1. if (Build.VERSION.SDK_INT > 23) {
  2. /**Android 7.0以上的方式**/
  3. Uri contentUri = getUriForFile(this, getString(R.string.install_apk_path), file);
  4. grantUriPermission(getPackageName(), contentUri, Intent.FLAG_GRANT_WRITE_URI_PERMISSION);
  5. intent.putExtra(MediaStore.EXTRA_OUTPUT, contentUri);
  6. }
  • 修改build.gradle文件compileSdkVersion大于或等于24,targetSdkVersion等于24,使用Android 7.0模拟器运行Demo,效果图:

Android 7.0系统权限更改

那么,我们已经了解Android 7.0系统权限申请的步骤,接下来说明每一个步骤需要注意的事项、相关方法参数的说明、属性的含义以及可以的申请权限目录(*后下载相关Demo)。

1.1 定义一个FileProvider

直接使用FileProvider本身或者它的子类,需要在AndroidManifest.xml文件中声明组件的相关属性,包括:

  • android:name,对应属性值:android.support.v4.content.FileProvider或者子类完整路径
  • android:authorities,对应属性值是一个常量,通常定义的方式packagename.fileprovider,例如:cn.teachcourse.fileprovider
  • android:exported,对应属性值是一个boolean变量,设置为false
  • android:grantUriPermissions,对应属性值也是一个boolean变量,设置为true,允许获得文件临时的访问权限
  1. <manifest>
  2. <application>
  3. <provider
  4. android:name=“android.support.v4.content.FileProvider”
  5. android:authorities=“com.mydomain.fileprovider”
  6. android:exported=“false”
  7. android:grantUriPermissions=“true”>
  8. </provider>
  9. </application>
  10. </manifest>

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

  • android:name,对应属性值是一个固定的系统常量android.support.FILE_PROVIDER_PATHS
  • android:resource,对应属性值指向我们的xml文件@xml/file_provider
  1. <provider
  2. android:name=“android.support.v4.content.FileProvider”
  3. android:authorities=“com.mydomain.fileprovider”
  4. android:exported=“false”
  5. android:grantUriPermissions=“true”>
  6. <meta-data
  7. android:name=“android.support.FILE_PROVIDER_PATHS”
  8. android:resource=“@xml/file_provider” />
  9. </provider>

1.2 指定授予临时访问权限的文件目录

上一步说明了怎么定义一个FileProvider,这一步主要说明怎么定义一个@xml/file_provider文件。Android Studio或Eclipse开发工具创建Android项目的时候默认不会创建res/xml文件夹,需要开发者手动创建,点击res文件夹新建目录,命名xml,如下图:

Android Studio新建xml目录

然后,在xml文件夹下新建一个xml文件,文件命名file_provider.xml,指定根标签为paths,如下图:

xml新建file_provider.xml

在xml文件中指定文件存储的区块和区块的相对路径,在<paths>根标签中添加<files-path>子标签(稍后详细列出所有子标签),设置子标签的属性值,包括:

  • name,是一个虚设的文件名(可以自由命名),对外可见路径的一部分,隐藏真实文件目录
  • path,是一个相对目录,相对于当前的子标签<files-path>根目录
  • <files-path>,表示内部内存卡根目录,对应根目录等价于Context.getFilesDir(),查看完整路径:
    /data/user/0/cn.teachcourse.demos/files
  • 代码如下:
  1. <paths xmlns:android=“http://schemas.android.com/apk/res/android”>
  2. <files-path name=“my_images” path=“images/”/>
  3. </paths>

<paths>根标签下可以添加的子标签也是有限的,参考官网的开发文档,除了上述的提到的<files-path>这个子标签外,还包括下面几个:

  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) Context.getExternalFilesDir(null)
    查看完整路径:
    /storage/emulated/0/Android/data/cn.teachcourse.demos/files/Download
  4. <external-cache-path>,表示外部内存卡根目录下的APP缓存目录,对应根目录等价于Context.getExternalCacheDir(),查看完整路径:
    /storage/emulated/0/Android/data/cn.teachcourse.demos/cache

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

  1. <?xml version=”1.0″ encoding=”utf-8″?>
  2. <paths xmlns:android=“http://schemas.android.com/apk/res/android”>
  3. <!–
  4. 1、name对应的属性值,开发者可以自由定义;
  5. 2、path对应的属性值,当前external-path标签下的相对路径
  6. 比如:/storage/emulated/0/92Recycle-release.apk
  7. sdcard路径:/storage/emulated/0(WriteToReadActivity.java:176)
  8. at cn.teachcourse.nougat.WriteToReadActivity.onClick(WriteToReadActivity.java:97)
  9. at android.view.View.performClick(View.java:5610)
  10. at android.view.View$PerformClick.run(View.java:22265)
  11. 相对路径:/
  12. –>
  13. <!–1、对应内部内存卡根目录:Context.getFileDir()–>
  14. <files-path
  15. name=“int_root”
  16. path=“/” />
  17. <!–2、对应应用默认缓存根目录:Context.getCacheDir()–>
  18. <cache-path
  19. name=“app_cache”
  20. path=“/” />
  21. <!–3、对应外部内存卡根目录:Environment.getExternalStorageDirectory()–>
  22. <external-path
  23. name=“ext_root”
  24. path=“pictures/” />
  25. <!–4、对应外部内存卡根目录下的APP公共目录:Context.getExternalFileDir(String)–>
  26. <external-files-path
  27. name=“ext_pub”
  28. path=“/” />
  29. <!–5、对应外部内存卡根目录下的APP缓存目录:Context.getExternalCacheDir()–>
  30. <external-cache-path
  31. name=“ext_cache”
  32. path=“/” />
  33. </paths>

1.3 生成指定文件的Content URI

Content URI方便与另一个APP应用程序共享同一个文件,共享的方式通过ContentResolver.openFileDescriptor获得一个ParcelFileDescriptor对象,读取文件内容。那么,如何生成一条完整的Content URI呢?TeachCourse总结后,概括为三个步骤,*步:明确上述5种类型中的哪一种,第二步:明确指定文件的完整路径(包括目录、文件名),第三步:调用getUriForFile()方法生成URI

  1. File imagePath = new File(Environment.getExternalStorageDirectory(), "download");
  2. File newFile = new File(imagePath, "default_image.jpg");
  3. Uri contentUri = getUriForFile(getContext(), "cn.teachcourse.fileprovider", newFile);

1.4 授予Content URI临时访问权限

上一步获得的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_PERMISSIONIntent.FLAG_GRANT_WRITE_URI_PERMISSION

授予文件的临时读取或写入权限,如果不再需要了,TeachCourse该如何撤销授予呢?撤销权限有两种方式:*种:通过调用revokeUriPermission()撤销,第二种:重启系统后自动撤销

1.5 对外提供可访问的Content URI

有多种方式可以向客户端APP提供可访问文件的Content URI,其中一种常用的方式是通过发送Intent给需要启动的Activity,在重写的startActivityResult()方法中获取授予临时权限的Content URI或向用户提供可访问的接口来获取文件,后面的这种方式获取文件后转换成Content URI,以文章开头拍照的功能为例,TeachCourse想要在sdcard的公共目录pictures/查看已保存的照片,实现过程:

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

运行Demo,控制台打印效果图:

Android 7.0访问sdcard

更多说明,可以参考Google提供的例子

二、深入理解DownloadManager

同样,为了方便理解DownloadManager的用法,首先以一个简单例子开始:从指定的url下载资源,然后显示下载资源的相关信息,运行Demo的效果图:

DownloadManager详解

Android 7.0系统权限更改的第三点,简单的说:通过访问COLUMN_LOCAL_FILENAME,在Android 7.0系统上可能无法获取Demo效果图fileName对应的文件路径,这时候可能触发异常SecurityException,打印的log信息,如下:

  1. Caused by: java.lang.SecurityException: COLUMN_LOCAL_FILENAME is deprecated; use ContentResolver.openFileDescriptor() instead
  2. at android.app.DownloadManager$CursorTranslator.getString(DownloadManager.java:1499)
  3. at cn.teachcourse.download.DownloadManagerActivity.query(DownloadManagerActivity.java:244)
  4. at cn.teachcourse.download.DownloadManagerActivity.access$100(DownloadManagerActivity.java:34)
  5. at cn.teachcourse.download.DownloadManagerActivity$1.onReceive(DownloadManagerActivity.java:186)
  6. at android.app.LoadedApk$ReceiverDispatcher$Args.run(LoadedApk.java:1122)
  7. at android.os.Handler.handleCallback(Handler.java:751)
  8. at android.os.Handler.dispatchMessage(Handler.java:95)
  9. at android.os.Looper.loop(Looper.java:154)
  10. at android.app.ActivityThread.main(ActivityThread.java:6077)
  11. at java.lang.reflect.Method.invoke(Native Method)
  12. at com.android.internal.os.ZygoteInit$MethodAndArgsCaller.run(ZygoteInit.java:865)
  13. at com.android.internal.os.ZygoteInit.main(ZygoteInit.java:755)

2.1 关于DownloadManager

DownloadManager是一个用于处理长时间HTTP请求的系统服务,客户端请求的URI可能是将要下载的指定的文件,处于后台的下载管理器将控制着下载的任务,并监测下载的状态,在下载失败或连接改变以及系统重启后尝试重新下载。

  • 如何初始化DownloadManager实例?首先调用getSystemService(String)方法,传入DOWNLOAD_SERVICE常量,来初始化DownloadManager实例,代码如下:
mDownloadManager = (DownloadManager) getSystemService(DOWNLOAD_SERVICE);
  • 如何配置请求参数?首先需要使用到内部类DownloadManager.Request,查看源码学习该类的各个方法的使用,TeachCourse简单总结:该类主要用于配置一条新下载任务相关内容,这些内容包括下载任务的保存路径,下载任务所处的网络状态(WiFi或流量状态)和下载任务通知栏显示样式等等,代码如下:
  1. /**
  2. * 设置请求下载的数据
  3. */
  4. private void initData() {
  5. //Request内部类配置新下载任务相关内容,比如:保存路径,WiFi或流量状态,下载通知栏样式
  6. request = new DownloadManager.Request(Uri.parse(mUrl + mFileName));
  7. request.setDestinationInExternalPublicDir(Environment.DIRECTORY_DOWNLOADS, mFileName);
  8. request.setAllowedNetworkTypes(DownloadManager.Request.NETWORK_MOBILE);
  9. request.setTitle("正在下载应用程序");
  10. request.setDescription("92回收,就爱回收APP");
  11. request.setNotificationVisibility(DownloadManager.Request.VISIBILITY_VISIBLE);
  12. }
  • 如何开启下载任务?下载任务参数配置完成后,就可以开启后台服务下载,同一个DownloadManager实例,可以开启多个下载任务,需要上一步中配置多条URI,每个下载任务分配唯一的id,代码如下:
  1. /**
  2. * 下载任务的唯一标识ID,用于查询下载文件的相关信息
  3. */
  4. private void start() {
  5. mDownloadUniqueId = mDownloadManager.enqueue(request);
  6. mDownloadManager_btn.setText("正在下载。。。");
  7. mDownloadManager_btn.setClickable(false);
  8. }
  • DownloadManager通过两种状态的广播,*种:任务下载完成后发送,广播拦截器过滤action是DownloadManager.ACTION_DOWNLOAD_COMPLETE(关于广播的知识,不懂的可以参考TeachCourse博客另外的几篇文章);第二种:点击通知栏进度条后发送,广播拦截器过滤action是DownloadManager.ACTION_NOTIFICATION_CLICKED,代码如下:
  1. /**
  2. * 注册下载完成广播接收器,还可以注册其它监听器,比如:DownloadManager.ACTION_NOTIFICATION_CLICKED
  3. */
  4. private void registerReceiverCompleted() {
  5. IntentFilter intentFilter = new IntentFilter(DownloadManager.ACTION_DOWNLOAD_COMPLETE);
  6. registerReceiver(mBroadcastReceiver, intentFilter);
  7. }
  8. /**
  9. * 接收下载完成广播
  10. */
  11. private BroadcastReceiver mBroadcastReceiver = new BroadcastReceiver() {
  12. @Override
  13. public void onReceive(Context context, Intent intent) {
  14. long reference = intent.getLongExtra(DownloadManager.EXTRA_DOWNLOAD_ID, -1);
  15. if (mDownloadUniqueId == reference) {
  16. query(reference);
  17. mShowInformation_tv.setText(information);
  18. mDownloadManager_btn.setText("点击下载");
  19. mDownloadManager_btn.setClickable(true);
  20. }
  21. }
  22. };
  • 如何查询下载任务的相关信息?首先需要使用到内部类DownloadManager.Query,查看源码学习该类各个方法的使用,TeachCourse简单总结:该类正如文章开头样式的例子,通过分配的id查询下载任务相关的信息,这些信息包括文件类型、文件的Uri和文件的长度等,代码如下:
  1. /**
  2. * 查询下载任务相关的信息,比如:文件名、文件大小、文件类型等
  3. *
  4. * @param reference
  5. */
  6. private void query(long reference) {
  7. DownloadManager.Query query = new DownloadManager.Query();
  8. /**指定查询条件**/
  9. query.setFilterById(reference);
  10. /**查询正在等待、运行、暂停、成功、失败状态的下载任务**/
  11. query.setFilterByStatus(DownloadManager.STATUS_SUCCESSFUL);
  12. Cursor cursor = mDownloadManager.query(query);
  13. if (cursor.moveToFirst()) {
  14. int fileId = cursor.getColumnIndex(DownloadManager.COLUMN_ID);
  15. int fileTitleId = cursor.getColumnIndex(DownloadManager.COLUMN_TITLE);
  16. int fileDescriptionId = cursor.getColumnIndex(DownloadManager.COLUMN_DESCRIPTION);
  17. int fileTypeId = cursor.getColumnIndex(DownloadManager.COLUMN_MEDIA_TYPE);
  18. int fileLengthId = cursor.getColumnIndex(DownloadManager.COLUMN_TOTAL_SIZE_BYTES);
  19. int fileUriId = cursor.getColumnIndex(DownloadManager.COLUMN_LOCAL_URI);
  20. /**过时的方式:DownloadManager.COLUMN_LOCAL_FILENAME**/
  21. int fileNameId = cursor.getColumnIndex(DownloadManager.COLUMN_LOCAL_FILENAME);
  22. int statusCodeId = cursor.getColumnIndex(DownloadManager.COLUMN_STATUS);
  23. int statusReasonId = cursor.getColumnIndex(DownloadManager.COLUMN_REASON);
  24. int downloadSizeId = cursor.getColumnIndex(DownloadManager.COLUMN_BYTES_DOWNLOADED_SO_FAR);
  25. int lastModifiedTimeId = cursor.getColumnIndex(DownloadManager.COLUMN_LAST_MODIFIED_TIMESTAMP);
  26. int mediaUriId = cursor.getColumnIndex(DownloadManager.COLUMN_MEDIAPROVIDER_URI);
  27. String id = cursor.getString(fileId);
  28. String fileTitle = cursor.getString(fileTitleId);
  29. String description = cursor.getString(fileDescriptionId);
  30. String type = cursor.getString(fileTypeId);
  31. String length = cursor.getString(fileLengthId);
  32. String statusCode = cursor.getString(statusCodeId);
  33. String statusReason = cursor.getString(statusReasonId);
  34. String downloadSize = cursor.getString(downloadSizeId);
  35. String modifiedTime = cursor.getString(lastModifiedTimeId);
  36. String mediaUri = cursor.getString(mediaUriId);
  37. String fileUri = cursor.getString(fileUriId);
  38. String fileName = null;
  39. if (Build.VERSION.SDK_INT > Build.VERSION_CODES.M) {
  40. openFile(type, Uri.parse(fileUri));
  41. fileName = Uri.parse(fileUri).getPath();
  42. } else {
  43. /**Android 7.0以上的方式:请求获取写入权限,这一步报错**/
  44. fileName = cursor.getString(fileNameId);
  45. openFile(type, Uri.parse(fileUri));
  46. }
  47. /**清空StringBuffer存储的数据**/
  48. mStringBuffer.delete(0, mStringBuffer.length());
  49. mStringBuffer.append("id:" + id + "\n");
  50. mStringBuffer.append("fileTitle:" + fileTitle + "\n");
  51. mStringBuffer.append("description:" + description + "\n");
  52. mStringBuffer.append("type:" + type + "\n");
  53. mStringBuffer.append("length:" + length + "\n");
  54. mStringBuffer.append("fileName:" + fileName + "\n");
  55. mStringBuffer.append("fileUri:" + fileUri + "\n");
  56. mStringBuffer.append("statusCode:" + statusCode + "\n");
  57. mStringBuffer.append("statusReason:" + statusReason + "\n");
  58. mStringBuffer.append("downloadSize:" + downloadSize + "\n");
  59. mStringBuffer.append("modifiedTime:" + modifiedTime + "\n");
  60. mStringBuffer.append("mediaUri:" + mediaUri + "\n");
  61. information = mStringBuffer.toString();
  62. }
  63. cursor.close();
  64. }
  • 代码加入判断语句,如果非Android 7.0系统继续访问COLUMN_LOCAL_FILENAME获得文件存储的*对路径(上面中间部分代码),openFile()方法代码如下:
  1. /**
  2. * 根据文件的类型,指定可以打开的应用程序
  3. *
  4. * @param type
  5. * @param uri
  6. */
  7. private void openFile(String type, Uri uri) {
  8. if (type.contains("image/")) {
  9. try {
  10. ParcelFileDescriptor descriptor = getContentResolver().openFileDescriptor(uri, "r");
  11. FileDescriptor fileDescriptor = descriptor.getFileDescriptor();
  12. Bitmap bitmap = BitmapFactory.decodeFileDescriptor(fileDescriptor);
  13. mShowPic_iv.setVisibility(View.VISIBLE);
  14. mShowPic_iv.setImageBitmap(bitmap);
  15. } catch (FileNotFoundException e) {
  16. e.printStackTrace();
  17. }
  18. }
  19. }

现在,我们已经掌握了DownloadManager怎么实例化、怎么配置下载任务、怎么开启后台服务以及如何查询任务相关信息,想要实现一个应用程序版本更新就变得很简单,实现多任务下载也不是难事,完整源码参考文章后台通过的Demo。

三、关于ParcelFileDescriptor和FileDescriptor总结

官网的文档推荐我们使用ContentResolver.openFileDescriptor()方法,获得一个ParcelFileDescriptor对象,再通过getFileDescriptor()方法返回一个FileDescriptor,它们之间的关系参考上面的代码。

FileDescriptor通常被称为文件描述符,可以理解成本地的一个文件,通过流的方式读取文件内容以及通过流的方式写入数据到文件,这里是读取或写入数据到FileDescriptor中,假如我们的Uri表示的是一个txt文件,获取FileDescriptor对象后,通过下面的代码读取txt文件的内容:

FileInputStream fis = new FileInputStream(fd);

同理,写入数据到txt文件,代码如下:

  1. FileOutputStream out = new FileOutputStream(fd);
  2. out.write('写入数据到txt文件中');
  3. out.close();

获取到输入流或输出流后,剩下的就是关于流的操作了,划分为:文件字节流、文件字符流、缓冲流、数组流等

3.1 改写上面的例子

openFile()方法使用封装好的decodeFileDescriptor(),查看BitmapFactory.decodeFileDescriptor()相关源码,学习如何读取文件描述符中的内容,这里TeachCourse根据读取流的方式,改写如下:

  1. ...
  2. Bitmap bitmap = BitmapFactory.decodeStream(getStreamByFileDescriptor(fileDescriptor));
  3. ...
  4. /**
  5. * 通过流的方式读取内容
  6. *
  7. * @param fileDescriptor
  8. * @return
  9. */
  10. private InputStream getStreamByFileDescriptor(FileDescriptor fileDescriptor) {
  11. return new FileInputStream(fileDescriptor);
  12. }

于是,可以对FileDescriptor进行简单的封装成writeData()readData(),代码如下:

  1. /**往FileDescriptor中写入数据
  2. * @param fileDescriptor
  3. * @param content
  4. */
  5. private void writeData(FileDescriptor fileDescriptor, String content) {
  6. FileOutputStream fos = new FileOutputStream(fileDescriptor);
  7. try {
  8. fos.write(content.getBytes());
  9. } catch (IOException e) {
  10. e.printStackTrace();
  11. } finally {
  12. try {
  13. fos.close();
  14. } catch (IOException e) {
  15. e.printStackTrace();
  16. }
  17. }
  18. }
  19. /**从FileDescriptor中读取数据
  20. * @param fileDescriptor
  21. * @return
  22. */
  23. private String readData(FileDescriptor fileDescriptor) {
  24. FileInputStream fis = new FileInputStream(fileDescriptor);
  25. byte[] b = new byte[1024];
  26. int read;
  27. String content=null;
  28. try {
  29. while ((read = fis.read(b)) != -1) {
  30. content = new String(b, 0, read);
  31. }
  32. } catch (IOException e) {
  33. e.printStackTrace();
  34. } finally {
  35. try {
  36. fis.close();
  37. } catch (IOException e) {
  38. e.printStackTrace();
  39. }
  40. }
  41. return content;
  42. }

总结:

Android 7.0系统的权限更改,包括三个方面,文章从第二方面开始讲解,着重介绍了FileProviderDownloadManager两个类的使用,花了好长时间整理、测试和编辑,如果对你有帮忙,别忘了收藏和分享咯!

  1. FileProvider源码路径:nougat/WriteToReadActivity.java
  2. DownloadManager源码路径:download/DownloadActivity.java
  3. Demo源码
  4. 参考资料:https://developer.android.google.cn/about/versions/nougat/android-7.0-changes.html

Android 7.0隐藏导航栏、状态栏的一些方法

Android 7.0隐藏导航栏和状态栏的一些方法

近期笔者在某款app时,需求要对导航栏(返回,home键,recent键的那部分)进行隐藏,此外还要做相关操作的屏蔽避免导航栏恢复显示。原本的方案是通过发广播给system ui,在system ui做remove导航栏的操作实现。后来架构设计阶段评估该方案对于外部模块的耦合太强,因此希望对方案进行优化,要求只在app自身做改动就可以实现。经过一番折腾完成之后,特将一些心得整理出来供参考。

 

心得1. 如何在不拉伸主要显示区域情况下,隐藏导航栏和状态栏。

笔者原本采用如下代码实现隐藏效果:

View decorView = activity.getWindow().getDecorView();

decorView.setSystemUiVisibility(

View.SYSTEM_UI_FLAG_LAYOUT_STABLE                        |View.SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION

|View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN

|View.SYSTEM_UI_FLAG_HIDE_NAVIGATION

| View.SYSTEM_UI_FLAG_FULLSCREEN

|View.SYSTEM_UI_FLAG_IMMERSIVE_STICKY);

实践后发现虽然能实现隐藏状态栏和导航栏,但会出现原有显示区域的布局被拉伸的情况。这与我们的要求不相符,详细研究View的setSystemUiVisibility方法可以传入的flag的含义和用法如下:

1. View.SYSTEM_UI_FLAG_VISIBLE:显示状态栏,Activity不全屏显示(恢复到有状态的正常情况)。

2. View.INVISIBLE:隐藏状态栏,同时Activity会伸展全屏显示。

3. View.SYSTEM_UI_FLAG_FULLSCREEN:Activity全屏显示,且状态栏被隐藏覆盖掉。

4. View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN:Activity全屏显示,但状态栏不会被隐藏覆盖,状态栏依然可见,Activity顶端布局部分会被状态遮住。

5. View.SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION:效果同View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN

6. View.SYSTEM_UI_LAYOUT_FLAGS:效果同View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN

7. View.SYSTEM_UI_FLAG_HIDE_NAVIGATION:隐藏虚拟按键(导航栏)。有些手机会用虚拟按键来代替物理按键。

8. View.SYSTEM_UI_FLAG_LOW_PROFILE:状态栏显示处于低能显示状态(low profile模式),状态栏上一些图标显示会被隐藏。

9.View.SYSTEM_UI_FLAG_IMMERSIVE_STICKY:粘性沉浸模式,向内滑动的操作会让系统栏临时显示,并处于半透明的状态。此时没有标签会被清除,系统UI可见性监听器也不会被触发。如果用户没有进行操作,系统栏会在一段时间内自动隐藏。

10.View.SYSTEM_UI_FLAG_IMMERSIVE:非粘性沉浸模式,它是基于其他设置过的标签(SYSTEM_UI_FLAG_HIDE_NAVIGATION和SYSTEM_UI_FLAG_FULLSCREEN)来隐藏系统栏的。当用户向内滑动,系统栏重新显示并保持可见。

 

通过上面的分析可以发现,带有LAYOUT的flag,表示Activity会延伸到原本属于状态栏或导航栏的位置,所以导致了布局拉伸;在要求隐藏状态栏的地方,只需要用View.SYSTEM_UI_FLAG_FULLSCREEN即可。这时候,导航栏存在,状态栏隐藏并且不会拉伸。

若要求导航栏和状态栏都隐藏,采用View.SYSTEM_UI_FLAG_FULLSCREEN和 View.SYSTEM_UI_FLAG_HIDE_NAVIGATION配合即可。也可以使用View.SYSTEM_UI_FLAG_IMMERSIVE_STICKY和View.SYSTEM_UI_FLAG_HIDE_NAVIGATION配合,效果是一样的。

心得2. 如何屏蔽触摸手势滑动调出导航栏。

上述的设置还是无法解决点击屏幕导航栏恢复的问题。经过查找资料了解到滑动屏幕主要会被PhoneWindowManager的SystemGesturesPointerEventListener所截获,而且研究发现,笔者当前采用的mtk方案在framework有针对设置了FULL_SCREEN的界面无法禁止状态栏下拉的问题,做了一些扩展,包括在View类中增加了public static final int SYSTEM_UI_FLAG_IMMERSIVE_GESTURE_ISOLATED = 0x00002000; 并在SystemGesturesPointerEventListener的onSwipeFromTop,onSwipeFromBottom等方法里添加isGestureIsolated()方法判断,isGestureIsolated代码如下:

1.   private boolean isGestureIsolated() {

2.  +                        WindowState win = mFocusedWindow != null ? mFocusedWindow : mTopFullscreenOpaqueWindowState;

3.  +                        if (win != null && (win.getSystemUiVisibility() & View.SYSTEM_UI_FLAG_IMMERSIVE_GESTURE_ISOLATED) != 0)

4.  +                            return true;

5.  +                        else

6.  +                            return false;

7.  +                    }

因此我们只需要在setSystemUiVisibility中加上SYSTEM_UI_FLAG_IMMERSIVE_GESTURE_ISOLATED就可以屏蔽在屏幕上的滑动了。

注:该方法仅针对MTK手机平台适用,若是高通平台,则需要framework自行扩展类似接口。

 

心得3. 如何在对话框调起时不显示状态栏。

setSystemUiVisibility隐藏状态栏后,弹出Dialog或输入法键盘时,状态栏又会跑出来.

在请教了资深开发者之后发现原因,如下是framework中Diaolgshow的处理:

public void show() {

……

WindowManager.LayoutParams l = mWindow.getAttributes();
……

mWindowManager.addView(mDecor, l);
……

}

dialog是在窗体addview,并且沿用了原窗体的参数.

因此如果原窗体没有设置full_screen的flag,则addview刷新窗体时,也是非full_screen而把状态栏调出来.

(输入法键盘的显示也是类似情况)

 

解决方案:如果要隐藏状态栏并且避免dialog弹出时状态栏跑出来,需要改变Window的参数即可:

getWindow().addFlags(WindowManager.LayoutParams.FLAG_FULLSCREEN)