Android11文件管理权限
android_cai_niao 人气:0Android 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崩溃了，管不了那么多了。
加载全部内容