Wear OS 4（Android13）如何列出手表内部存储所有类型文件？

核心问题拆解 #

Wear OS 4 虽基于Android 13，但针对穿戴设备的轻量化特性，对文件访问权限做了更严格的针对性限制：

• File.listFiles() 因存储沙箱机制强化，直接访问内部存储根目录或非媒体目录会返回空结果
• 传统的 READ_EXTERNAL_STORAGE 在Android 13+（含Wear OS 4）已被废弃，仅对媒体类文件生效；WRITE_EXTERNAL_STORAGE 也不再授予全局写入权限
• MANAGE_EXTERNAL_STORAGE 权限在Wear OS上支持有限，谷歌对穿戴应用申请该权限的审核极为严格，普通应用几乎无法通过常规途径获取

可行解决方案 #

1. 用存储访问框架（SAF）实现全局文件访问 #

SAF是Android官方推荐的跨版本文件管理方案，不受文件类型限制，步骤如下：

• 启动SAF目录选择器，让用户主动授予目标目录的访问权限：

val intent = Intent(Intent.ACTION_OPEN_DOCUMENT_TREE)
startActivityForResult(intent, REQUEST_CODE_SELECT_DIR)

• 在回调中获取返回的Uri，通过DocumentFile遍历所有文件：

val treeUri = data?.data ?: return
val rootDir = DocumentFile.fromTreeUri(context, treeUri)
rootDir?.listFiles()?.forEach { file ->
    // 处理文件：file.name 获取文件名，file.exists() 判断是否存在等
}

• 可调用ContentResolver.takePersistableUriPermission保存权限，避免每次重启应用都重新申请

2. 针对Downloads目录的非媒体文件，用MediaStore查询 #

如果你的非媒体文件（如txt、pdf、apk）保存在系统Downloads目录，可直接通过MediaStore查询获取：

val projection = arrayOf(
    MediaStore.Downloads._ID,
    MediaStore.Downloads.DISPLAY_NAME,
    MediaStore.Downloads.RELATIVE_PATH
)

val cursor = context.contentResolver.query(
    MediaStore.Downloads.EXTERNAL_CONTENT_URI,
    projection,
    null,
    null,
    null
)

cursor?.use {
    while (it.moveToNext()) {
        val fileName = it.getString(it.getColumnIndexOrThrow(MediaStore.Downloads.DISPLAY_NAME))
        // 处理文件逻辑
    }
}

这种方式无需额外权限，但仅能访问Downloads目录下的文件

3. MANAGE_EXTERNAL_STORAGE权限的特殊说明 #

Wear OS 4技术上支持该权限，但仅允许系统级文件管理器类应用申请，普通应用提交Google Play审核时大概率会被拒绝，不建议依赖此方案

关键注意事项 #

• 避免直接使用File API访问外部存储，Wear OS 4的沙箱机制会限制这类操作的文件可见性
• 所有文件操作必须遵循用户授权原则，SAF是最合规且通用的方案
• 应用私有文件仍可通过context.filesDir或context.getExternalFilesDir(null)访问，这类目录无需额外权限

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