Jetpack Compose中ViewModel无Context访问SD卡的可行方案

你可以通过两种安全的方式在ViewModel中处理SD卡文件操作，避免直接持有可能导致泄漏的Context引用：

1. 使用AndroidViewModel（推荐） #

AndroidViewModel是ViewModel的子类，它持有Application Context（生命周期与应用一致，不会引发内存泄漏），可以安全地用来获取SD卡路径。

代码示例： #

import android.app.Application
import android.content.ContextCompat
import androidx.lifecycle.AndroidViewModel
import java.io.File

class FileViewModel(application: Application) : AndroidViewModel(application) {
    // 懒加载SD卡路径，仅在需要时初始化
    private val sdCardStorage: File? by lazy {
        ContextCompat.getExternalFilesDirs(
            application.applicationContext,
            null
        ).getOrNull(1) // 下标1对应SD卡（下标0是内置存储）
    }

    // 写入SD卡文件
    fun writeToSdCard(content: String, fileName: String) {
        sdCardStorage?.let { sdDir ->
            val targetFile = File(sdDir, fileName)
            runCatching {
                targetFile.writeText(content)
                // 写入成功后的逻辑，比如通知UI
            }.onFailure {
                // 处理写入失败，比如文件不可写、SD卡未挂载等
            }
        } ?: run {
            // SD卡不可用的处理逻辑
        }
    }

    // 读取SD卡文件
    fun readFromSdCard(fileName: String): String? {
        return sdCardStorage?.let { sdDir ->
            val targetFile = File(sdDir, fileName)
            if (targetFile.exists()) {
                runCatching { targetFile.readText() }.getOrNull()
            } else {
                null
            }
        }
    }
}

在Compose中使用这个ViewModel：

@Composable
fun FileOperationScreen() {
    val viewModel: FileViewModel = viewModel() // 自动传入Application实例

    Button(onClick = {
        viewModel.writeToSdCard("测试内容", "demo.txt")
    }) {
        Text("写入SD卡")
    }
}

2. 在UI层获取路径后传递给ViewModel #

如果不想使用AndroidViewModel，可以在Compose UI层通过LocalContext获取SD卡路径，再将路径传递给普通ViewModel，ViewModel仅负责文件读写逻辑，不持有任何Context引用。

代码示例： #

ViewModel部分：

import androidx.lifecycle.ViewModel
import java.io.File

class FileViewModel : ViewModel() {
    fun writeToSdCard(sdCardDir: File, content: String, fileName: String) {
        val targetFile = File(sdCardDir, fileName)
        runCatching {
            targetFile.writeText(content)
        }.onFailure {
            // 处理写入失败
        }
    }

    fun readFromSdCard(sdCardDir: File, fileName: String): String? {
        val targetFile = File(sdCardDir, fileName)
        return if (targetFile.exists()) {
            runCatching { targetFile.readText() }.getOrNull()
        } else {
            null
        }
    }
}

Compose UI部分：

@Composable
fun FileOperationScreen() {
    val context = LocalContext.current
    val sdCardStorage = ContextCompat.getExternalFilesDirs(
        context.applicationContext,
        null
    ).getOrNull(1)
    val viewModel: FileViewModel = viewModel()

    Button(onClick = {
        sdCardStorage?.let {
            viewModel.writeToSdCard(it, "测试内容", "demo.txt")
        }
    }) {
        Text("写入SD卡")
    }
}

关键注意事项 #

• 始终使用applicationContext而非Activity Context，避免因Activity销毁导致的内存泄漏。
• 必须检查sdCardStorage是否为null：部分设备可能没有SD卡，或SD卡未挂载、被移除。
• 权限处理：
  • Android 10及以下：需要在Manifest中声明WRITE_EXTERNAL_STORAGE权限，并请求运行时权限。
  • Android 11+：如果仅访问当前应用的外部文件目录（即getExternalFilesDirs返回的路径），无需额外权限；若需访问其他应用的文件，需申请MANAGE_EXTERNAL_STORAGE权限。

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