Android 14新特性，选择性照片和视频访问授权

本文同步发表于我的微信公众号，扫一扫文章底部的二维码或在微信搜索 郭霖 即可关注，每个工作日都有文章更新。
  今天这篇文章给各人介绍一下Android 14系统中的一个新特性，对部门照片和视频进行访问授权，也可以称之为选择性照片和视频访问授权。
这是Android系统在隐私和安全性方面的又一次调解升级，目的是为了可以或许更好地掩护用户隐私。
但是这个新特性对于开辟者而言，真的是让我们苦上加苦，因此我会边吐槽边来讲解这个最新的特性。


Android本地读写权限变更史


Android开辟者很苦。
我会全面介绍一下Android系统从诞生至今，在本地读写权限方面的完备变更史，然后各人应该能对Android开辟者的苦感同身受。
本地读写权限指的是App拥有对手机外置公共存储空间（SD卡）读取和写入的本领。


Android 1.0

远古期间的Android系统对于权限方面黑白常宽松的。
固然这个期间的Android手机我自己都没有用过，那个时候听说对于本地读写功能是没有任何限制的，任何一个App都可以随意读写整个手机的公共存储空间。


Android 1.6

很明显，如此宽松的权限计划是有问题的，于是Android 1.6系统引入了WRITE_EXTERNAL_STORAGE权限。
如果你想要向手机的公共存储空间写入数据，那么就得在你的应用程序的AndroidManifest.xml文件中声明这个权限才行。


Android 4.4

Android 1.6系统只是对写入公共存储空间有了限制，读取公共存储空间的文件仍然是不受限制的。
那么从Android 4.4开始，Google引入了READ_EXTERNAL_STORAGE权限。如果想要读取公共存储空间的文件，就必要在AndroidManifest.xml文件中声明这个权限才行。


Android 6.0

之前的Android系统，如果你想要使用某个权限，只必要在AndroidManifest.xml文件中声明一下就行。
这个声明起到什么作用呢？它会在App安装的时候告知用户，这个App统共申请了哪些权限，如果继续安装的话即视为用户同意了所有这些权限的申请。
这个规则属实有点霸王条款，因为用户无法部门同意该App申请的权限。
于是在Android 6.0系统中，Google引入了运行时权限功能，某些危险程度高的权限不能再像之前那样在AndroidManifest.xml文件中声明一下就行了，而是要在App运行的过程中弹出权限申请框，只有用户同意了授权，才气使用其权限对应的功能。
READ_EXTERNAL_STORAGE和WRITE_EXTERNAL_STORAGE都被划入了运行时权限的范畴。
关于运行时权限的更多内容，可以参考《第一行代码 Android 第3版》第8章。


Android 10

运行时权限机制引入之后，Android系统的隐私和安全性达到了一个新的高度，因此也让本地读写权限在相当长的一段时间里保持了比力稳定的用法。
不外从Android 10系统开始，Google不满意于近况，又开始大刀阔斧地改革了，而且背面的改动频率让人瞠舌。
Android 10引入了Scoped Storage机制，App被克制使用绝对路径访问公共存储空间。如许，用户装备上的隐私信息可以得到更好的掩护。
而诸如手机照片、视频、音频之类的公共型资源，如果App想要访问的话，可以必要借助MediaStore API来完成。
App通过MediaStore API写入照片、视频、音频等公共型资源，是不必要申请任何权限的。而App通过MediaStore API读取照片、视频、音频等公共型资源，仍必要申请READ_EXTERNAL_STORAGE权限才行。
由于Scoped Storage机制变动过大，Google怕大量App来不及适配，因此提供了一个requestLegacyExternalStorage属性。将这个属性设置为true，那么App仍然可以使用绝对路径访问公共存储空间。
关于Android 10更多的行为变更，可以参考 Android 10适配要点，作用域存储 这篇文章。


Android 11

给了一年的缓冲期，Google以为绝大部门应用应该都已经完成了Scoped Storage的适配，因此从Android 11开始requestLegacyExternalStorage属性将不再起作用。
另外，思量到有些文件浏览器类型的App的确必要使用绝对路径访问公共存储空间，Android 11又添加了一个MANAGE_EXTERNAL_STORAGE权限，但仅限特定确实有需求的App申请，随便申请的话可能会被Google Play市肆下架。
关于Android 11更多的行为变更，可以参考 Android 11新特性，Scoped Storage又有了新花样 这篇文章。


Android 13

又过了两年，Google以为现有的本地读写权限又不够安全了。
具体的缘故原由在于，本地读写权限的划分不够精致。App只必要申请READ_EXTERNAL_STORAGE权限之后，即可访问手机公共存储空间的照片、视频、音频，用户无法以更细的颗粒度对App进行授权。
于是Android 13系统废弃了READ_EXTERNAL_STORAGE权限，新增了READ_MEDIA_IMAGES、READ_MEDIA_VIDEO和READ_MEDIA_AUDIO这3个新的运行时权限，分别用于控制App对照片、视频、音频的访问。
关于Android 13更多的行为变更，可以参考 Android 13运行时权限变更一览 这篇文章。


Android 14

终于到了Android 14，也就是我们本篇文章的重点了。
为了可以或许更好地掩护用户隐私， Google在Android 14系统中新增了选择性照片和视频访问授权功能。
那么什么是选择性照片和视频访问授权呢？
在已往，当一个App申请了READ_MEDIA_IMAGES权限，如果用户选择了同意，那么该App就可以访问这台手机上所有的照片。用户是没有办法限制该App只能访问特定的某几张照片的。
而Android 14新增的这个功能则允许用户选择，是一次性授权该App访问所有的照片，还是只能访问几张特定的照片。视频也是同样的道理。
实在这个功能站在用户的角度思量是无可厚非的，可以或许更好地掩护用户隐私，那确实就是一个好功能。
但是站在开辟者的角度，由于Android系统在本地读写权限方面的历史债太多了，如果你的代码想要思量周全所有的场景，可能必要写得相当繁琐才行。
接下来，我会联合着一个实战Demo跟各人讲解一下如何去适配Android 14的选择性照片和视频访问授权。代码到底有多繁琐，一起来看看就知道了。


选择性照片和视频访问适配


为了可以或许更清楚地讲解，我在文章中只会截选与选择性照片和视频访问相干的代码进行讲解。
至于Demo的完备源码，我会在文章下方给出源码的链接。
起首，Android 14推出了一个全新的运行时权限，也就是选择性照片和视频访问权限：

1. android.permission.READ_MEDIA_VISUAL_USER_SELECTED

复制代码

我们都知道，运行时权限固然是在App运行过程中去申请的，但仍然必要在AndroidManifest.xml中进行声明才行。
你以为在AndroidManifest.xml中声明一个权限很简单？但实际上，联合着Android的历史问题，我们必要如许写才行：

1. <manifest>    <!-- Devices running Android 12L (API level 32) or lower  -->    <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" android:maxSdkVersion="32" />    <!-- Devices running Android 13 (API level 33) or higher -->    <uses-permission android:name="android.permission.READ_MEDIA_IMAGES" />    <uses-permission android:name="android.permission.READ_MEDIA_VIDEO" />    <!-- To handle the reselection within the app on Android 14 (API level 34) -->    <uses-permission android:name="android.permission.READ_MEDIA_VISUAL_USER_SELECTED
2. " />    ...</manifest>

复制代码

这是可以或许完善适配Android各个系统版本的本地读写权限的写法。
Android 12及以下系统，我们只必要声明READ_EXTERNAL_STORAGE权限即可。而且由于从Android 13开始这个权限就被废弃了，因此还要加上maxSdkVersion="32"才行。
Android 13新增了3个运行时权限，分别用于控制App对照片、视频、音频的访问。我们这个例子没有音频访问的必要，因此这里声明READ_MEDIA_IMAGES和READ_MEDIA_VIDEO这两个权限就可以了。
Android 14新增了READ_MEDIA_VISUAL_USER_SELECTED权限，用于对照片和视频进行选择性授权。
怎么样，只是在AndroidManifest.xml中声明权限是不是已经觉得相当繁琐了？
别着急，更繁琐的还在背面。
接下来是要在App运行时去哀求本地读写权限，那么可想而知，差异系统版本必要哀求的权限天然也是差异的。
如今Android上哀求运行时权限根本上都是改用Activity Result API了，对这部门还不了解的朋友，可以参考这篇文章 Activity Result API详解，是时候放弃startActivityForResult了 。
下面我们来看一下哀求本地读写权限的具体写法：

1. private val permissionLauncher =
2.     registerForActivityResult(ActivityResultContracts.RequestMultiplePermissions()) { _ ->
3.         // 处理权限请求结果
4.     }
6. private fun requestPermissions() {
7.     if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.UPSIDE_DOWN_CAKE) {
8.         permissionLauncher.launch(
9.             arrayOf(READ_MEDIA_IMAGES,
10.                 READ_MEDIA_VIDEO,
11.                 READ_MEDIA_VISUAL_USER_SELECTED)
12.         )
13.     } else if (Build.VERSION.SDK_INT == Build.VERSION_CODES.TIRAMISU) {
14.         permissionLauncher.launch(arrayOf(READ_MEDIA_IMAGES, READ_MEDIA_VIDEO))
15.     } else {
16.         permissionLauncher.launch(arrayOf(READ_EXTERNAL_STORAGE))
17.     }
18. }

复制代码

这里又必要根据差异的系统版原来哀求差异的权限了。
Android 14必要哀求的权限是最多的，因为要适配选择性照片和视频访问功能，所以要申请READ_MEDIA_IMAGES、READ_MEDIA_VIDEO和READ_MEDIA_VISUAL_USER_SELECTED这3个权限。
Android 13系统的话可以少申请一个，只必要申请READ_MEDIA_IMAGES和READ_MEDIA_VIDEO权限就可以了。
而Android 12及以下系统最简单，申请READ_EXTERNAL_STORAGE权限即可。
这些版本判断的代码着实让人很讨厌，但是却又不得不这么写。
如果想要完全移除这些版本判断的代码，至少要等到你的minSdkVersion指定到Android 14及以上才行。但到那个时候，谁知道Google又会不会整出什么其他的花活呢。
最后，哀求完本地读写权限，我们还得要判断权限的哀求结果才行。而这，就更复杂了。
为了让各人不消每次都绞尽脑汁地思考这个地方应该如何处理才气思量得最为周全，这里我直接贴出一份模板代码，各人在实现的时候复制粘贴即可：

1. private fun checkPermissionResult() {
2.     if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU
3.         && (ContextCompat.checkSelfPermission(this, READ_MEDIA_IMAGES) == PERMISSION_GRANTED
4.                 || ContextCompat.checkSelfPermission(this, READ_MEDIA_VIDEO) == PERMISSION_GRANTED)
5.     ) {
6.         // Android 13及以上完整照片和视频访问权限
7.     } else if (
8.         Build.VERSION.SDK_INT >= Build.VERSION_CODES.UPSIDE_DOWN_CAKE &&
9.         ContextCompat.checkSelfPermission(this, READ_MEDIA_VISUAL_USER_SELECTED) == PERMISSION_GRANTED
10.     ) {
11.         // Android 14及以上部分照片和视频访问权限
12.     } else if (ContextCompat.checkSelfPermission(this, READ_EXTERNAL_STORAGE) == PERMISSION_GRANTED) {
13.         // Android 12及以下完整本地读写访问权限
14.     } else {
15.         // 无本地读写访问权限
16.     }
17. }

复制代码

可以看到，如今判断权限的哀求结果必要分4种情况，分别是：

• Android 13及以上完备照片和视频访问权限
  
• Android 14及以上部门照片和视频访问权限
  
• Android 12及以下完备本地读写访问权限
  
• 无本地读写访问权限
  

我知道这很令人讨厌，但是必须要这么写，各人也别抱怨了，必要用到的时候复制拿走即可。
所以，从代码层面适配Android 14选择性照片和视频访问权限，大概就是分成了这3步。分别是在AndroidManifest.xml中进行权限声明、在程序运行时对权限进行哀求、以及最后判断权限的哀求结果。
但是从业务流程方面，Google给我们提出了更高的要求。
因为既然提供了选择性照片和视频访问权限，那么用户就有可能只授权了我们部门照片和视频的访问权限。而如果用户后期又想要授权我们更多照片和视频的访问权限怎么办？因此必要在UI层面给用户一个可操纵的选项才行。
Google给出的最佳实践流程是这个样子的。

如图所示，当用户选择了部门照片和视频访问权限时，我们可以在界面的顶部给用户一个提示，告知下方表现的照片和视频只是用户选择授权的一部门，点击Manage按钮可以跳转到管理界面，以选择更多的照片和视频，或取消已授权的照片和视频。
那么如何实现这套最佳实践流程呢？实在通过我刚才讲解的这几段代码示例就已经可以实现了。
下面我录制了一段最佳实践Demo的操纵演示，各人可以看一看具体的流程和效果。

可以看到，如果用户选择的是允许有限权限，那么顶部始终会表现一个横幅，以方便用户管理已授权的照片和视频。
而如果用户选择了全部允许，那么顶部的横幅就会自动消失，效果如下图所示。

整个Demo的源码我都上传到了GitHub上，各人有必要可以访问下方链接进行参考：
https://github.com/guolindev/PartialAccessDemo

我如果不适配可以吗？


固然可以。毕竟这么繁琐的适配代码，我也不信赖所有App都能做到完善适配。
不适配最多只是让你的App无法在Android 14系统上达到最佳的运行体验而已。

因为，Android 14还可以以兼容模式来运行没有适配选择性照片和视频访问授权的App。
至于兼容模式如何运行，Android官网写得也是相当复杂。这里我做了一下简化，方便各人理解。
兼容模式重要有以下两种情况：
第一种情况，你的App的targetSdkVersion指定在33或以下的版本，也就是说你的App还没有为Android 14系统进行适配。
这种情况就非常简单了，都还没有适配呢，Android也不会给你强上新的特性。这时会以Android 13的兼容模式来运行你的App，也就是没有选择性照片和视频访问授权这个概念。
第二种情况，你的App的targetSdkVersion指定在了34或以上的版本，但你就是没有适配选择性照片和视频访问授权这个功能。
这种情况Android 14系统仍然能正常运行，但是有几点情况是你必要了解的。
即使你没有适配选择性照片和视频访问授权功能，当你的App去哀求照片和视频权限时，系统弹出的权限确认框上仍然会有“允许有限访问”这个选项。如下图所示：

如果用户选择了“允许有限访问”，也是可以像前面的录屏当中那样，选择性地对某些照片和视频进行访问授权的。
你的App会收到READ_MEDIA_IMAGES和READ_MEDIA_VIDEO这两个权限的授权回调，但仅能访问刚才用户选择的那些照片和视频。
当你的App退出后，READ_MEDIA_IMAGES和READ_MEDIA_VIDEO这两个权限的授权就会被收回，下次启动时必要重新申请，有点类似于一次性授权的效果。
下次启动时，固然没有READ_MEDIA_IMAGES和READ_MEDIA_VIDEO权限，但是之前用户已选择的那些照片和视频，你依然有权限访问。
这套兼容规则实在也是挺绕的，这还是我整理后的简化版本，原来还要区分AndroidManifest文件中有没有声明READ_MEDIA_VISUAL_USER_SELECTED权限的，情况要更加复杂。这部门我在学习的时候也尝试理解了好久。
如果你感觉上面的兼容规则理解起来比力吃力的话，那么最推荐的做法还是抓紧去适配Android 14选择性照片和视频访问授权功能吧。
固然适配的代码的确不怎么好写，但是复制粘贴总不难的吧？

---

如果想要学习Kotlin和最新的Android知识，可以参考我的新书 《第一行代码 第3版》，点击此处查看详情。

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。