Android TV是否支持ACTION_OPEN_DOCUMENT_TREE Intent及调用报错排查

核心原因 #

Android TV系统默认通常没有适配Leanback界面的文件选择器应用，而ACTION_OPEN_DOCUMENT_TREE Intent的默认处理组件（如手机/平板的文件管理器）大多未针对TV遥控操作做适配，导致系统找不到可处理该Intent的应用，从而抛出「You don't have an app that can do this message」错误。

可行解决方案 #

1. 先做Intent可用性校验 #

在启动Intent前，通过PackageManager检查是否有应用能处理该Intent，避免直接触发错误提示：

val intent = storageVolume.createOpenDocumentTreeIntent()
val packageManager = context.packageManager
val resolveInfo = packageManager.resolveActivity(intent, PackageManager.MATCH_DEFAULT_ONLY)

if (resolveInfo == null) {
    Toast.makeText(context, "TV端暂无可用文件管理器，请更换操作方式", Toast.LENGTH_LONG).show()
} else {
    startActivityForResult(intent, REQUEST_CODE_OPEN_TREE)
    // 也可使用Jetpack Activity Result API（推荐）
    // openDocumentTreeLauncher.launch(null)
}

2. 移除无效权限 #

MANAGE_DOCUMENTS是系统级权限，普通应用无法获取，添加到Manifest中无实际作用，建议删除该声明：

<!-- 移除这条无效权限 -->
<!-- <uses-permission android:name="android.permission.MANAGE_DOCUMENTS" /> -->

3. 实现自定义Leanback文件选择器（推荐） #

由于TV系统普遍缺少适配的文件选择器，最可靠的方式是自行开发适配遥控操作的文件选择界面，基于Storage Access Framework(SAF)的DocumentFile API实现：

• 用StorageManager获取所有可用存储卷
• 通过DocumentFile.fromTreeUri或DocumentFile.fromFile遍历目录
• 构建Leanback风格的列表界面，支持遥控上下选择、确认操作
• 选择完成后返回对应Tree Uri供后续操作

4. 适配Intent的TV特性 #

部分TV厂商可能提供了适配的文件管理器，可尝试给Intent添加额外Category或Flags提升匹配概率：

val intent = storageVolume.createOpenDocumentTreeIntent().apply {
    addCategory(Intent.CATEGORY_LEANBACK_LAUNCHER)
    flags = flags or Intent.FLAG_ACTIVITY_NEW_TASK
}

额外注意事项 #

• 确保TV Activity正确处理Intent返回结果：若使用startActivityForResult，需在onActivityResult中接收返回Uri；若使用Jetpack Activity Result API，需注册ActivityResultContracts.OpenDocumentTree回调。
• 针对Android 11+（API30+），WRITE_EXTERNAL_STORAGE和READ_EXTERNAL_STORAGE权限对SAF操作无影响，SAF通过Uri授权机制访问文件，无需依赖这些权限（若需访问传统外部存储则仍需申请）。

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