Android 11文件管理权限申请

Android 11文件管理权限申请，为什么需要这个权限，因为在Android 11后，无法直接在SDcard根目录写文件，Android 11之后要使用分区存储，但是分区存储使用起来很麻烦，所以可以申请文件管理权限，这样就可以随意读写SDcard了，写到根目录也没问题。

清单文件声明如下：

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"package="cn.dazhou.permissionrequestdemo"xmlns:tools="http://schemas.android.com/tools"><uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/><uses-permission android:name="android.permission.MANAGE_EXTERNAL_STORAGE"tools:ignore="ScopedStorage" /><applicationandroid:requestLegacyExternalStorage="true">。。。</application></manifest>

这里除了申请MANAGE_EXTERNAL_STORAGE权限之外，同时也是要申请WRITE_EXTERNAL_STORAGE权限的，因为在低于Android11的版本就需要使用WRITE_EXTERNAL_STORAGE权限，且需要在application节点添加android:requestLegacyExternalStorage="true",这个属性用于Android10版本可以免去分区存储。在Android11上，申请了MANAGE_EXTERNAL_STORAGE权限之后就不用申请WRITE_EXTERNAL_STORAGE权限了，因为拥有MANAGE_EXTERNAL_STORAGE权限应该就能任意读写SDCard了。根据实验，申请了MANAGE_EXTERNAL_STORAGE权限之后，再申请WRITE_EXTERNAL_STORAGE也是会弹出权限申请对话框的，所以，在Android11上还有没有必要申请WRITE_EXTERNAL_STORAGE权限，值得思考，但我就懒得去实验了。

class MainActivity : AppCompatActivity() {private lateinit var launcher: ActivityResultLauncher<Intent>override fun onCreate(savedInstanceState: Bundle?) {super.onCreate(savedInstanceState)setContentView(R.layout.activity_main)launcher = registerForActivityResult(ActivityResultContracts.StartActivityForResult()) {Log.i("ABCD", "权限申请结果：${it.resultCode == Activity.RESULT_OK}")checkAndroid11FilePermission(this)}findViewById<Button>(R.id.button).setOnClickListener {checkAndroid11FilePermission(this)}}/** 检查Android 11或更高版本的文件权限 */private fun checkAndroid11FilePermission(activity: FragmentActivity) {// Android 11 (Api 30)或更高版本的写文件权限需要特殊申请，需要动态申请管理所有文件的权限if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {if (Environment.isExternalStorageManager()) {Log.i("ABCD","此手机是Android 11或更高的版本，且已获得访问所有文件权限")// TODO requestOtherPermissions() 申请其他的权限} else {Log.i("ABCD","此手机是Android 11或更高的版本，且没有访问所有文件权限")showDialog(activity, """本应用需要获取"访问所有文件"权限，请给予此权限，否则无法使用本应用""") {launcher.launch(Intent(Settings.ACTION_MANAGE_ALL_FILES_ACCESS_PERMISSION))}}} else {Log.i("ABCD","此手机版本小于Android 11，版本为：API ${Build.VERSION.SDK_INT}，不需要申请文件管理权限")// TODO requestOtherPermissions() 申请其他的权限}}private fun showDialog(activity: FragmentActivity, message: String, okClick: () -> Unit) {AlertDialog.Builder(activity).setTitle("提示").setMessage(message).setPositiveButton("确定") { _, _ -> okClick() }.setCancelable(false).show()}}

注：在获取权限的结果时，不能使用it.resultCode == Activity.RESULT_OK来判断是否获得权限，因为这个结果永远为false。

Android 11和低版本的存储权限结合

为了兼容低于Android 11的版本，我们把之前的存储权限结合到一起，如下：

class MainActivity : AppCompatActivity() {private lateinit var storagePermissionLauncher: ActivityResultLauncher<String>private lateinit var android11StoragePermissionLauncher: ActivityResultLauncher<Intent>override fun onCreate(savedInstanceState: Bundle?) {super.onCreate(savedInstanceState)setContentView(R.layout.activity_main)if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {// Android 11或更高的版本android11StoragePermissionLauncher = registerForActivityResult(ActivityResultContracts.StartActivityForResult()) {requestStoragePermission(this)}} else {// Android 10或更低的版本storagePermissionLauncher = registerForActivityResult(ActivityResultContracts.RequestPermission()) { isGranted ->if (isGranted) {Log.i("ABCD", "此手机是版本低于Android 11，且已获得存储权限")// TODO requestOtherPermissions() 申请其他的权限} else {Log.i("ABCD", "此手机是版本低于Android 11，且没有存储权限")val desc = if (ActivityCompat.shouldShowRequestPermissionRationale(this, Manifest.permission.WRITE_EXTERNAL_STORAGE)) {// 权限被拒绝"""本应用需要获取"存储"权限，请给予此权限，否则无法使用本应用"""} else {// 权限被设置为不再提示"""本App需要使用"存储"权限，您需要到设置中打开此权限，否则无法使用本app"""}showDialog(this, desc) {storagePermissionLauncher.launch(Manifest.permission.WRITE_EXTERNAL_STORAGE)}}}}findViewById<Button>(R.id.button).setOnClickListener {requestStoragePermission(this)}}/** 请求存储权限 */private fun requestStoragePermission(activity: FragmentActivity) {Log.i("ABCD", "当前手机版本：API ${Build.VERSION.SDK_INT}")if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {// Android 11 (Api 30)或更高版本的写文件权限需要特殊申请，需要动态申请管理所有文件的权限if (Environment.isExternalStorageManager()) {Log.i("ABCD","此手机是Android 11或更高的版本，且已获得访问所有文件权限")// TODO requestOtherPermissions() 申请其他的权限} else {Log.i("ABCD","此手机是Android 11或更高的版本，且没有访问所有文件权限")showDialog(activity, """本应用需要获取"访问所有文件"权限，请给予此权限，否则无法使用本应用""") {android11StoragePermissionLauncher.launch(Intent(Settings.ACTION_MANAGE_ALL_FILES_ACCESS_PERMISSION))}}} else {// Android 10或更低的版本，申请存储权限Log.i("ABCD","此手机是版本低于Android 11，开始申请存储权限")storagePermissionLauncher.launch(Manifest.permission.WRITE_EXTERNAL_STORAGE)}}private fun showDialog(activity: FragmentActivity, message: String, okClick: () -> Unit) {AlertDialog.Builder(activity).setTitle("提示").setMessage(message).setPositiveButton("确定") { _, _ -> okClick() }.setCancelable(false).show()}}

工具类封装

object StoragePermissionUtil {private lateinit var storagePermissionLauncher: ActivityResultLauncher<String>private lateinit var android11StoragePermissionLauncher: ActivityResultLauncher<Intent>private lateinit var resultCallback: () -> Unit/*** 需求：* androidx.activity，1.2.0 或更高版本。* androidx.fragment，1.3.0 或更高版本。* 示例如下：* implementation "androidx.activity:activity-ktx:1.3.0"* implementation "androidx.fragment:fragment-ktx:1.3.6"*/fun registerForActivityResult(activity: FragmentActivity) {if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {// Android 11或更高的版本android11StoragePermissionLauncher = activity.registerForActivityResult(ActivityResultContracts.StartActivityForResult()) {requestStoragePermission(activity, resultCallback)}} else {// Android 10或更低的版本storagePermissionLauncher = activity.registerForActivityResult(ActivityResultContracts.RequestPermission()) { isGranted ->if (isGranted) {Log.i("ABCD", "此手机是版本低于Android 11，且已获得存储权限")resultCallback()} else {Log.i("ABCD", "此手机是版本低于Android 11，且没有存储权限")val desc = if (ActivityCompat.shouldShowRequestPermissionRationale(activity, Manifest.permission.WRITE_EXTERNAL_STORAGE)) {// 权限被拒绝"""本应用需要获取"存储"权限，请给予此权限，否则无法使用本应用"""} else {// 权限被设置为不再提示"""本App需要使用"存储"权限，您需要到设置中打开此权限，否则无法使用本app"""}showDialog(activity, desc) {storagePermissionLauncher.launch(Manifest.permission.WRITE_EXTERNAL_STORAGE)}}}}}/** 请求存储权限 */fun requestStoragePermission(activity: FragmentActivity, resultCallback: () -> Unit) {this.resultCallback = resultCallbackLog.i("ABCD", "当前手机版本：API ${Build.VERSION.SDK_INT}")if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {// Android 11 (Api 30)或更高版本的写文件权限需要特殊申请，需要动态申请管理所有文件的权限if (Environment.isExternalStorageManager()) {Log.i("ABCD","此手机是Android 11或更高的版本，且已获得访问所有文件权限")resultCallback()} else {Log.i("ABCD","此手机是Android 11或更高的版本，且没有访问所有文件权限")showDialog(activity, """本应用需要获取"访问所有文件"权限，请给予此权限，否则无法使用本应用""") {android11StoragePermissionLauncher.launch(Intent(Settings.ACTION_MANAGE_ALL_FILES_ACCESS_PERMISSION))}}} else {// Android 10或更低的版本，申请存储权限Log.i("ABCD","此手机是版本低于Android 11，开始申请存储权限")storagePermissionLauncher.launch(Manifest.permission.WRITE_EXTERNAL_STORAGE)}}private fun showDialog(activity: FragmentActivity, message: String, okClick: () -> Unit) {AlertDialog.Builder(activity).setTitle("提示").setMessage(message).setPositiveButton("确定") { _, _ -> okClick() }.setCancelable(false).show()}}

class MainActivity : AppCompatActivity() {override fun onCreate(savedInstanceState: Bundle?) {super.onCreate(savedInstanceState)setContentView(R.layout.activity_main)StoragePermissionUtil.registerForActivityResult(this)findViewById<Button>(R.id.button).setOnClickListener {StoragePermissionUtil.requestStoragePermission(this) {Log.i("ABCD", "拿到存储权限罗，开心^_^")}}}}

Android 11申请管理所有文件权限的Bug

在申请权限的时候，会弹出系统授权界面，当我们打开到如下界面后：

此时，我们把权限打开，然后返回到我们Activity是正常的。但是，如果在此界面，我们打开权限后，再关闭，此后不管你是要再开或者不开，当你返回Activity的时候，整个App会瞬间重启，而且它会自动创建Activity，而且奇怪的时候，它会自动把结果回调到新Activity中注册的监听器里，而在新Activity中，我们还没有点击按钮申请权限呢，所以StoragePermissionUtil.requestStoragePermission(this)代码就没有被执行到，则StoragePermissionUtil中的resultCallback变量就是未初始化的，所以授权结果就没办法返回到Activity中了，而且由于resultCallback没初始化就使用，就会抛出属性未初始化的异常。这属于系统Bug吧感觉，也没有什么好的解决方案了，在我的项目中，需要程序一运行就自动调用申请权限的函数，这种情况没有办法能很好的解决，比如可以把resultCallback在registerForActivityResult中进行传递，这样能保证不会出现属性未初始化的异常，但是按上面的操作，当出现App重启时，会收到两次回调结果，一次回调结果是重启前调用的申请回调到重启后的注册回调中，一次是重启后再一次申请权限所以也能获得一次回调。所以，这个Bug可以不管它罗，如果有用户非要这样操作，那就只能让App崩溃了，管不了那么多了。