Android Fragment中Manage External Storage Permission按钮无法点击求助

问题根源 #

你的代码核心问题出在Android 11+权限跳转逻辑以及Fragment中权限请求的适配上，同时可能遗漏了必要的权限声明，导致设置页面的权限按钮处于不可点击状态。

修复步骤 #

1. 补充Manifest权限声明 #

首先在AndroidManifest.xml中添加对应权限（区分Android版本）：

<!-- Android 11+ 全存储访问权限 -->
<uses-permission android:name="android.permission.MANAGE_EXTERNAL_STORAGE"
    tools:ignore="ScopedStorage" />
<!-- Android 10及以下读写权限 -->
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"
    android:maxSdkVersion="29" />
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"
    android:maxSdkVersion="29" />

2. 修正Fragment中的权限请求逻辑 #

废弃旧的onRequestPermissionsResult方法，统一使用Activity Result API处理权限请求，同时优化Android 11+的权限跳转Intent，避免URI构造错误导致设置页面异常。

修改后的完整Fragment代码：

class CreatePdfFragment : Fragment(R.layout.fragment_create_pdf) {

    private lateinit var binding: FragmentCreatePdfBinding
    private val TAG = "CreatePdfFragment"

    // 处理Android 10及以下的存储权限请求
    private val storagePermissionLauncher = registerForActivityResult(
        ActivityResultContracts.RequestMultiplePermissions()
    ) { permissions ->
        val writeGranted = permissions[Manifest.permission.WRITE_EXTERNAL_STORAGE] ?: false
        val readGranted = permissions[Manifest.permission.READ_EXTERNAL_STORAGE] ?: false
        if (writeGranted && readGranted) {
            Log.d(TAG, "External Storage Permission granted")
            savePdf()
        } else {
            Log.d(TAG, "External Storage Permission denied...")
            toast("External Storage Permission denied...")
        }
    }

    // 处理Android 11+的全存储权限跳转
    private val storageManagerLauncher = registerForActivityResult(
        ActivityResultContracts.StartActivityForResult()
    ) {
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
            if (Environment.isExternalStorageManager()) {
                Log.d(TAG, "Manage External Storage Permission granted")
                savePdf()
            } else {
                Log.d(TAG, "Manage External Storage Permission denied...")
                toast("Manage External Storage Permission denied...")
            }
        }
    }

    override fun onCreateView(
        inflater: LayoutInflater, container: ViewGroup?,
        savedInstanceState: Bundle?
    ): View {
        binding = FragmentCreatePdfBinding.inflate(inflater, container, false)
        return binding.root
    }

    override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
        super.onViewCreated(view, savedInstanceState)
        binding.btnToPdf.setOnClickListener {
            if (checkPermission()) {
                Log.d(TAG, "Permission already granted, create PDF")
                savePdf()
            } else {
                Log.d(TAG, "Permission not granted, request now")
                requestPermission()
            }
        }
    }

    private fun savePdf() {
        val mDoc = Document()
        val mFileName = SimpleDateFormat("yyyyMMdd_HHmmss", Locale.getDefault()).format(System.currentTimeMillis())
        // Android 11+优先使用公共文档目录，符合Scoped Storage规范
        val mFilePath = if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
            Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_DOCUMENTS).toString() + "/" + mFileName + ".pdf"
        } else {
            Environment.getExternalStorageDirectory().toString() + "/" + mFileName + ".pdf"
        }
        try {
            PdfWriter.getInstance(mDoc, FileOutputStream(mFilePath))
            mDoc.open()
            val mText = binding.etPdfText.text.toString()
            mDoc.addAuthor("Atif Pervaiz")
            mDoc.add(Paragraph(mText))
            mDoc.close()
            toast("$mFileName.pdf\n已保存至\n$mFilePath")
        } catch (e: Exception) {
            toast(e.message.toString())
        }
    }

    private fun requestPermission() {
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
            try {
                val intent = Intent(Settings.ACTION_MANAGE_APP_ALL_FILES_ACCESS_PERMISSION).apply {
                    data = Uri.parse("package:${requireContext().packageName}")
                }
                storageManagerLauncher.launch(intent)
            } catch (e: Exception) {
                Log.e(TAG, "Failed to launch permission settings", e)
                val intent = Intent(Settings.ACTION_MANAGE_ALL_FILES_ACCESS_PERMISSION)
                storageManagerLauncher.launch(intent)
            }
        } else {
            storagePermissionLauncher.launch(
                arrayOf(
                    Manifest.permission.WRITE_EXTERNAL_STORAGE,
                    Manifest.permission.READ_EXTERNAL_STORAGE
                )
            )
        }
    }

    private fun checkPermission(): Boolean {
        return if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
            Environment.isExternalStorageManager()
        } else {
            ContextCompat.checkSelfPermission(requireContext(), Manifest.permission.WRITE_EXTERNAL_STORAGE) == PackageManager.PERMISSION_GRANTED &&
                    ContextCompat.checkSelfPermission(requireContext(), Manifest.permission.READ_EXTERNAL_STORAGE) == PackageManager.PERMISSION_GRANTED
        }
    }

    private fun toast(message: String) {
        Toast.makeText(requireContext(), message, Toast.LENGTH_SHORT).show()
    }
}

3. 关键修改点说明 #

• 统一使用Activity Result API：适配Fragment生命周期，避免旧权限回调方法的兼容性问题。
• 优化权限跳转Intent：修正URI构造方式，确保直接跳转到当前应用的权限设置页面，解决按钮不可点击的问题。
• 存储目录适配：Android 11+使用公共文档目录，既符合Scoped Storage规范，又避免不必要的权限依赖。
• 上下文优化：Fragment中优先使用requireContext()替代requireActivity()，逻辑更严谨。

额外注意事项 #

• MANAGE_EXTERNAL_STORAGE属于特殊权限，Google Play审核会严格限制使用场景，仅当应用确实需要访问所有外部存储文件时才会通过审核，建议优先考虑Scoped Storage方案。
• 测试时使用Android 11及以上设备，验证权限跳转和文件保存逻辑。

内容的提问来源于stack exchange，提问作者semicn