软件编程
位置:首页>> 软件编程>> Android编程>> Android11文件管理权限申请详细介绍

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

作者:android_cai_niao  发布时间:2023-08-28 17:41:47 

标签:Android,文件管理

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

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

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

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

来源:https://blog.csdn.net/android_cai_niao/article/details/121956880

0
投稿

猜你喜欢

手机版 软件编程 asp之家 www.aspxhome.com