Android11文件管理权限申请详细介绍

目录

• Android 11文件管理权限申请
• Android 11和低版本的存储权限结合
• 工具类封装
• Android 11申请管理所有文件权限的Bug

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崩溃了，管不了那么多了。

到此这篇关于Android11文件管理权限申请详细介绍的文章就介绍到这了,更多相关Android11文件管理权限内容请搜索我们以前的文章或继续浏览下面的相关文章希望大家以后多多支持我们！