Android 11中使用ACTION_OPEN_DOCUMENT_TREE访问SD卡的困惑及方案咨询

首先明确：ACTION_OPEN_DOCUMENT_TREE仍可继续使用，只是不能直接请求根目录。你可以通过以下几种方式适配系统限制，实现SD卡内容的合法访问：

1. 引导用户选择SD卡内的具体子目录 #

既然无法直接请求SD卡根目录，你可以在发起意图时通过EXTRA_INITIAL_URI参数指定SD卡内的常用子目录（比如Android/data/[你的包名]/）作为初始打开位置，引导用户选择该目录或其上级目录（若需要更广泛的访问权限）。示例代码：

val initialUri = DocumentsContract.buildDocumentUriUsingTree(
    MediaStore.getExternalStorageUri("external"),
    DocumentsContract.getTreeDocumentId(MediaStore.getExternalStorageUri("external")) + "/Android/data/你的包名"
)

val intent = Intent(Intent.ACTION_OPEN_DOCUMENT_TREE).apply {
    putExtra(DocumentsContract.EXTRA_INITIAL_URI, initialUri)
}
startActivityForResult(intent, REQUEST_CODE_PICK_DIR)

这种方式能减少用户操作成本，同时避开根目录的访问限制。

2. 针对特定文件类型使用ACTION_OPEN_DOCUMENT #

如果仅需访问SD卡内的特定类型文件（如图片、文档），可以放弃目录选择，改用ACTION_OPEN_DOCUMENT意图，配合setType()指定文件类型，用户可直接选择SD卡内的对应文件，不受根目录限制。示例代码：

val intent = Intent(Intent.ACTION_OPEN_DOCUMENT).apply {
    addCategory(Intent.CATEGORY_OPENABLE)
    type = "*/*" // 或指定具体类型如"image/*"
}
startActivityForResult(intent, REQUEST_CODE_PICK_FILE)

3. 使用MediaStore API访问公共媒体文件 #

如果应用仅需处理图片、视频、音频等公共媒体文件，可直接通过MediaStore API查询和访问这些文件，无需用户手动授权目录。示例代码：

val projection = arrayOf(
    MediaStore.Images.Media._ID,
    MediaStore.Images.Media.DISPLAY_NAME,
    MediaStore.Images.Media.DATA
)

val cursor = contentResolver.query(
    MediaStore.Images.Media.EXTERNAL_CONTENT_URI,
    projection,
    null,
    null,
    null
)

cursor?.use {
    while (it.moveToNext()) {
        val displayName = it.getString(it.getColumnIndexOrThrow(MediaStore.Images.Media.DISPLAY_NAME))
        // 处理媒体文件逻辑
    }
}

4. 利用Scoped Storage的私有目录 #

如果应用仅需访问自身的私有数据，可直接使用getExternalFilesDir()方法获取SD卡上的应用私有目录，该目录无需用户授权，且不受Android 11的访问限制。示例代码：

val privateDir = getExternalFilesDir(Environment.DIRECTORY_DOCUMENTS)
// 直接操作该目录下的文件

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