[移动开发]Android11文件管理权限申请

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" />

    <application
        android: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 = resultCallback
        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或更高的版本，且已获得访问所有文件权限")
                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崩溃了，管不了那么多了。