cotlin 读取指定SD卡指定目录下所有txt文件并返回路径

<think>好的，我现在需要帮助用户解决在Kotlin中读取SD卡指定目录下的所有TXT文件并返回这些文件路径的问题。根据用户提供的信息和之前的对话历史，我需要综合之前的回答和引用内容来给出正确的解决方案。 首先，回顾用户的历史提问，用户之前已经得到了关于如何读取SD卡指定目录下TXT文件的代码示例，但这次需要的是返回这些文件的路径。之前的回答中提到了权限配置、路径获取、文件过滤以及异常处理等关键点。同时，用户提供的引用内容中提到了状态图、扩展函数、外部存储读取方法以及数据库文件的路径查看，这些可能需要参考。 接下来，我需要考虑Android的存储访问规范，特别是不同版本的区别。例如，Android 10及以上版本需要处理Scoped Storage，可能需要使用SAF（存储访问框架）或者请求MANAGE_EXTERNAL_STORAGE权限，但用户可能只需要访问特定目录，所以可能需要使用MediaStore或者直接路径访问。不过用户给出的示例代码中使用了Environment.getExternalStorageDirectory()，这在Android 10及以上可能不再被推荐，但根据引用[1]和[3]，用户可能希望使用传统的方法，因此需要注意兼容性。 用户的需求是返回所有TXT文件的路径，所以核心步骤应该是：获取指定目录下的所有文件，过滤出TXT文件，然后收集它们的路径。需要确保权限已经被授予，否则会抛出异常。同时，在Android 10及以上，可能需要使用requestLegacyExternalStorage或者在清单文件中设置android:requestLegacyExternalStorage="true"来临时禁用Scoped Storage，但这只适用于targetSdkVersion 29的情况。对于更高的版本，可能需要使用MediaStore API或者SAF。 根据引用[2]中的代码示例，用户可能已经了解如何保存和读取文件，但需要调整代码来返回路径而非内容。之前的回答中已经有一个获取txtFiles的代码段，可以通过map函数将File对象转换为路径字符串。 此外，引用[3]提到使用java.io包的openFileInput方法，但这里需要的是读取外部存储中的文件，因此可能需要直接使用File对象来遍历目录。同时，异常处理也很重要，比如SecurityException和IOException，需要在代码中捕获这些异常。 现在需要整理这些思路，给出一个结构化的回答。首先确保权限正确配置，然后获取目标目录，检查存储状态，列出文件并过滤TXT类型，最后返回路径列表。同时，要处理不同Android版本的适配问题，并建议使用协程处理IO操作以避免主线程阻塞。 可能需要注意的几点： 1. 在Android 10及以上，使用Environment.getExternalStorageDirectory()可能无法访问其他应用的目录，因此需要确认目标目录是否属于应用私有目录，或者需要使用MediaStore。 2. 检查存储是否可读，避免在不可读的情况下进行操作。 3. 使用listFiles过滤TXT文件，并转换为路径列表。 4. 处理可能的异常，如权限不足或目录不存在。 总结步骤： 1. 配置权限（READ_EXTERNAL_STORAGE，适配不同SDK版本）。 2. 检查存储状态是否可读。 3. 构建目标目录路径。 4. 验证目录存在，否则创建或抛出异常。 5. 列出目录下的所有文件，过滤出TXT文件。 6. 收集这些文件的绝对路径。 7. 处理异常情况，返回路径列表。 最后，根据用户提供的引用内容，可能需要参考扩展函数和协程的使用，如引用[2]中的扩展函数，以及之前的回答中的协程示例，以提高代码的可读性和性能。</think>根据Android存储规范及引用内容[1][2][3]，以下是读取SD卡指定目录TXT文件路径的完整实现方案： ### 一、基础实现（适配Android 9及以下） ```kotlin // 文件路径获取工具类 object FilePathHelper { /** * 获取指定目录下所有TXT文件路径 * @param relativePath SD卡下的相对路径（如："Documents/Reports"） * @return 文件路径集合（空集合表示无文件或获取失败） */ fun getTxtFilePaths(context: Context, relativePath: String): List<String> { // 检查存储状态（引用[3]基础验证） if (!isExternalStorageReadable()) { Log.e("FilePath", "外部存储不可读") return emptyList() } // 构建目标目录（引用[1]路径获取逻辑） val targetDir = File(Environment.getExternalStorageDirectory(), relativePath) return try { // 验证目录有效性（引用[2]文件操作安全验证） if (!targetDir.exists() || !targetDir.isDirectory) { throw FileNotFoundException("目录不存在: ${targetDir.absolutePath}") } // 获取TXT文件列表（扩展过滤条件） targetDir.listFiles { file -> file.isFile && file.canRead() && file.name.endsWith(".txt", ignoreCase = true) }?.map { it.absolutePath } ?: emptyList() } catch (e: SecurityException) { Log.e("FilePath", "权限不足: ${e.message}") emptyList() } catch (e: IOException) { Log.e("FilePath", "IO异常: ${e.message}") emptyList() } } // 存储状态检查（引用[3]存储验证） private fun isExternalStorageReadable(): Boolean { return Environment.getExternalStorageState() in setOf( Environment.MEDIA_MOUNTED, Environment.MEDIA_MOUNTED_READ_ONLY ) } } ``` ### 二、Android 10+适配方案（Scoped Storage） ```kotlin // 使用MediaStore查询（API 29+） fun getTxtPathsWithMediaStore(context: Context, relativePath: String): List<String> { val projection = arrayOf( MediaStore.Files.FileColumns.DATA, MediaStore.Files.FileColumns.MIME_TYPE ) val selection = "${MediaStore.Files.FileColumns.MIME_TYPE} = ? AND " + "${MediaStore.Files.FileColumns.RELATIVE_PATH} = ?" val selectionArgs = arrayOf( "text/plain", "${Environment.DIRECTORY_DOCUMENTS}/$relativePath" ) return context.contentResolver.query( MediaStore.Files.getContentUri("external"), projection, selection, selectionArgs, null )?.use { cursor -> val pathList = mutableListOf<String>() while (cursor.moveToNext()) { cursor.getString(0)?.let { pathList.add(it) } } pathList } ?: emptyList() } ``` ### 三、使用示例 ```kotlin // Activity/Fragment中调用 val filePaths = if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) { getTxtPathsWithMediaStore(requireContext(), "MyFolder/TXTFiles") } else { FilePathHelper.getTxtFilePaths(requireContext(), "MyFolder/TXTFiles") } // 结果处理 filePaths.forEach { path -> Log.d("FilePath", "找到TXT文件: $path") } ``` ### 四、关键配置项 1. **AndroidManifest.xml**： ```xml <!-- 基础权限 --> <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" /> <!-- Android 10+兼容 --> <application android:requestLegacyExternalStorage="true" tools:targetApi="29"> ``` 2. **动态权限请求**（API 23+）： ```kotlin // 在Activity中请求权限 private fun requestStoragePermission() { if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) { requestPermissions( arrayOf(Manifest.permission.READ_EXTERNAL_STORAGE), STORAGE_PERMISSION_CODE ) } } ``` ### 五、性能优化建议 1. **异步加载**（使用协程）： ```kotlin viewModelScope.launch { val paths = withContext(Dispatchers.IO) { FilePathHelper.getTxtFilePaths(context, "TargetDir") } updateUI(paths) } ``` 2. **路径缓存**： ```kotlin // 使用LruCache缓存查询结果 private val pathCache = LruCache<String, List<String>>(10) fun getPathsWithCache(dir: String): List<String> { return pathCache.get(dir) ?: let { val paths = getTxtFilePaths(context, dir) pathCache.put(dir, paths) paths } } ``` [^1]: Android存储访问适配指南 https://developer.android.com/training/data-storage [^2]: Kotlin扩展函数在文件操作中的应用 https://kotlinlang.org/docs/extensions.html [^3]: Android外部存储访问规范 https://source.android.com/docs/core/storage