Android Oreo（API26）下获取物理SD卡路径的技术问询

Hey，针对你开发Android应用时遇到的SD卡识别与大文件保存需求，我整理了一套完整的实现方案——既兼容你提到的API25及以下版本，也能适配更高版本系统，完美匹配你的功能要求：

核心目标很清晰：

• 识别设备上的物理SD卡，识别成功则显示「保存文件到SD卡」选项
• 保存路径必须是应用专属SD卡目录（应用卸载时系统自动删除）
• 文件大小在300MB-800MB区间，要避免内存溢出问题
• 识别不到SD卡时，隐藏该功能选项

1. 跨版本SD卡识别逻辑 #

API25及以下可用的原有代码 #

你提到的这段代码在低版本是有效的，我帮你补充了有效性验证：

// 获取所有外部存储目录，第一个是内部存储的外部目录，第二个为物理SD卡的应用专属目录
String[] externalStorageVolumes = ContextCompat.getExternalFilesDirs(context, null);
File validSdCardAppDir = null;

if (externalStorageVolumes.length > 1) {
    File sdDirCandidate = externalStorageVolumes[1];
    // 验证SD卡是否挂载且可写
    if (sdDirCandidate != null && Environment.MEDIA_MOUNTED.equals(Environment.getExternalStorageState(sdDirCandidate))) {
        validSdCardAppDir = sdDirCandidate;
    }
}

API26+适配补充 #

从Android 8.0开始，获取应用专属外部目录的逻辑本质没变，但有两个关键注意点：

• 访问应用专属目录无需申请WRITE_EXTERNAL_STORAGE权限（系统自动授权）
• 依然可以通过ContextCompat.getExternalFilesDirs()获取多存储卷，第二个元素就是SD卡的应用专属目录
• 验证存储状态时，必须针对SD卡目录本身调用Environment.getExternalStorageState(file)，而不是全局状态

2. 控制功能选项的显示/隐藏 #

把SD卡检查逻辑封装成方法，在UI初始化或合适的生命周期中调用，动态控制选项可见性：

private void setupSaveToSdOption() {
    Button saveToSdBtn = findViewById(R.id.btn_save_to_sd_card);
    boolean hasValidSdCard = isPhysicalSdCardAvailable(this);

    // 根据识别结果显示/隐藏按钮
    saveToSdBtn.setVisibility(hasValidSdCard ? View.VISIBLE : View.GONE);
    saveToSdBtn.setOnClickListener(v -> {
        // 触发大文件保存逻辑
        saveLargeFileToSdCard(this, yourFileData);
    });
}

// 封装SD卡检查工具方法
private boolean isPhysicalSdCardAvailable(Context context) {
    String[] externalDirs = ContextCompat.getExternalFilesDirs(context, null);
    if (externalDirs.length <= 1) return false;

    File sdAppDir = externalDirs[1];
    return sdAppDir != null && Environment.MEDIA_MOUNTED.equals(Environment.getExternalStorageState(sdAppDir));
}

3. 大文件安全写入实现 #

针对300MB-800MB的大文件，必须使用流式写入避免内存溢出，这里提供两种常用场景的实现：

从字节数组写入 #

private void saveLargeFileToSdCard(Context context, byte[] fileData) {
    File sdAppDir = ContextCompat.getExternalFilesDirs(context, null)[1];
    File targetFile = new File(sdAppDir, "large_data_file.bin");

    // 使用try-with-resources自动关闭流
    try (FileOutputStream fos = new FileOutputStream(targetFile)) {
        fos.write(fileData);
        Toast.makeText(context, "文件已成功保存至SD卡", Toast.LENGTH_SHORT).show();
    } catch (IOException e) {
        e.printStackTrace();
        Toast.makeText(context, "SD卡保存失败", Toast.LENGTH_SHORT).show();
    }
}

从输入流写入（比如网络下载/本地文件读取） #

private void saveStreamToSdCard(Context context, InputStream inputStream) {
    File sdAppDir = ContextCompat.getExternalFilesDirs(context, null)[1];
    File targetFile = new File(sdAppDir, "large_data_file.bin");

    // 用缓冲流提升大文件写入效率
    try (BufferedInputStream bis = new BufferedInputStream(inputStream);
         BufferedOutputStream bos = new BufferedOutputStream(new FileOutputStream(targetFile))) {

        byte[] buffer = new byte[8192]; // 8KB缓冲块，平衡内存占用与写入效率
        int bytesRead;
        while ((bytesRead = bis.read(buffer)) != -1) {
            bos.write(buffer, 0, bytesRead);
        }
        Toast.makeText(context, "文件已成功保存至SD卡", Toast.LENGTH_SHORT).show();
    } catch (IOException e) {
        e.printStackTrace();
        Toast.makeText(context, "SD卡保存失败", Toast.LENGTH_SHORT).show();
    }
}

• 权限适配：API23-29版本，建议动态申请WRITE_EXTERNAL_STORAGE权限（虽然应用专属目录在API26+不需要，但低版本兼容需要）；API30+无需任何存储权限
• AVD测试验证：确保你的AVD已配置物理SD卡（编辑AVD时在Storage选项中设置SD卡大小并启用），否则会识别不到
• 存储状态监听：可以注册ACTION_MEDIA_MOUNTED和ACTION_MEDIA_UNMOUNTED广播，实时监听SD卡挂载/卸载状态，动态更新UI选项
• 空间检查：写入大文件前，建议先检查SD卡剩余空间是否足够，避免写入失败

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