Android 7.1.2自制文件管理器无法删除外接存储文件求助

核心问题分析 #

1. MANAGE_EXTERNAL_STORAGE权限无效：该权限是Android 11（API 30）新增的，在Android 7.1.2（API 25）上完全不被识别，属于无效配置，直接移除即可。
2. WRITE_EXTERNAL_STORAGE权限范围有限：在Android 7.0+，该权限仅能访问内部存储和SD卡的应用私有目录（Android/data/你的包名/），对外接存储（如U盘、SD卡根目录/其他公共目录）没有写入/删除权限，因此file.canWrite()会返回false，直接调用File.delete()也不会生效。
3. File API不适用于外接存储：Android对外接可移除存储的访问，从7.0开始推荐使用Storage Access Framework（SAF），而非传统的File类操作。

解决方案 #

1. 清理权限配置 #

移除Manifest中无效的MANAGE_EXTERNAL_STORAGE权限，保留必要权限：

<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"
    android:maxSdkVersion="30" /> <!-- 限制高版本无需该权限 -->

2. 使用SAF获取外接存储的写入权限 #

通过系统文件选择器让用户选择需要操作的外接存储目录，获取持久化访问权限：

private const val REQUEST_CODE_SAF = 1001

// 启动SAF目录选择器
private fun requestExternalStorageAccess() {
    val intent = Intent(Intent.ACTION_OPEN_DOCUMENT_TREE)
    intent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION)
    intent.addFlags(Intent.FLAG_GRANT_WRITE_URI_PERMISSION)
    intent.addFlags(Intent.FLAG_GRANT_PERSISTABLE_URI_PERMISSION)
    startActivityForResult(intent, REQUEST_CODE_SAF)
}

// 处理权限回调
override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {
    super.onActivityResult(requestCode, resultCode, data)
    if (requestCode == REQUEST_CODE_SAF && resultCode == Activity.RESULT_OK) {
        data?.data?.let { uri ->
            // 持久化权限
            contentResolver.takePersistableUriPermission(
                uri,
                Intent.FLAG_GRANT_READ_URI_PERMISSION or Intent.FLAG_GRANT_WRITE_URI_PERMISSION
            )
            // 保存Uri，后续操作使用
            saveSelectedUri(uri)
        }
    }
}

// 示例：保存Uri到SharedPreferences
private fun saveSelectedUri(uri: Uri) {
    getSharedPreferences("storage_prefs", MODE_PRIVATE)
        .edit()
        .putString("selected_storage_uri", uri.toString())
        .apply()
}

3. 用SAF执行删除/重命名操作 #

不再使用File类，改用ContentResolver通过Uri操作文件：

删除文件示例

private fun deleteFileWithSAF(fileUri: Uri) {
    try {
        contentResolver.delete(fileUri, null, null)
        // 这里添加删除成功后的逻辑
    } catch (e: Exception) {
        // 处理删除失败（如权限不足、文件不存在）
        e.printStackTrace()
    }
}

重命名文件示例

private fun renameFileWithSAF(oldUri: Uri, newName: String) {
    val docId = DocumentsContract.getDocumentId(oldUri)
    val splitId = docId.split(":")
    val newDocId = "${splitId.first()}:$newName"
    val newUri = DocumentsContract.buildDocumentUriUsingTree(oldUri, newDocId)
    
    try {
        contentResolver.rename(oldUri, newUri)
        // 这里添加重命名成功后的逻辑
    } catch (e: Exception) {
        e.printStackTrace()
    }
}

4. 额外说明 #

如果操作的是SD卡的应用私有目录（Android/data/你的包名/），可以直接用File API操作，无需SAF，因为WRITE_EXTERNAL_STORAGE权限覆盖该目录。但如果是外接存储的其他公共目录，必须使用SAF。

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