从Android 11获取外部存储目录的指南

在Android开发中，获取外部存储目录是一个基本但重要的任务。特别是在Android 11中，由于引入了Scoped Storage的变更，处理外部存储变得更加复杂。本文将引导你如何在Android 11中实现获取外部存储目录的功能。

流程步骤

以下是实现该功能的步骤总结，表格中列出了每个步骤的简要描述：

步骤 描述
1 设置Android项目并加入必要的权限
2 检查和请求存储权限
3 使用getExternalFilesDir获取外部目录
4 进行文件读写操作

步骤详细说明

1. 设置Android项目并加入必要的权限

在你的Android项目的AndroidManifest.xml文件中，需要添加存储权限。虽然从Android 10开始，访问所有外部存储被限制，但为了兼容Android 10及以下版本，还需要添加READ_EXTERNAL_STORAGE和WRITE_EXTERNAL_STORAGE权限。

<manifest xmlns:android="
    package="com.example.yourapp">

    <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>
    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>

    <application
        ...
    </application>
</manifest>

2. 检查和请求存储权限

在活动中，你需要检查并请求存储权限。如果没有权限，则需要请求用户授权。

import android.Manifest;
import android.content.pm.PackageManager;
import android.os.Build;
import androidx.annotation.NonNull;
import androidx.core.app.ActivityCompat;
import androidx.core.content.ContextCompat;

// 定义常量
private static final int STORAGE_PERMISSION_CODE = 101;

// 检查权限的函数
private void checkPermission() {
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
        // 判断是否已经有权限
        if (ContextCompat.checkSelfPermission(this, Manifest.permission.WRITE_EXTERNAL_STORAGE) != PackageManager.PERMISSION_GRANTED) {
            // 如果没有权限，申请权限
            ActivityCompat.requestPermissions(this, new String[]{Manifest.permission.WRITE_EXTERNAL_STORAGE}, STORAGE_PERMISSION_CODE);
        } else {
            // 权限已经被授予
            accessExternalStorage();
        }
    } else {
        // 如果是Android 10以下版本，则不需要请求权限
        accessExternalStorage();
    }
}

// 权限请求回调
@Override
public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
    if (requestCode == STORAGE_PERMISSION_CODE) {
        if (grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
            // 用户授权，继续访问外部存储
            accessExternalStorage();
        } else {
            // 用户拒绝授权
            Toast.makeText(this, "Permission Denied", Toast.LENGTH_SHORT).show();
        }
    }
}

3. 使用getExternalFilesDir获取外部目录

在Android 11中，你应该使用getExternalFilesDir方法来获取应用的外部文件目录。这样可以确保你只访问属于你应用的存储空间。

// 访问外部存储的方法
private void accessExternalStorage() {
    // 获取应用的外部文件目录
    File externalDir = getExternalFilesDir(null);
    if (externalDir != null) {
        // 创建一个文件来进行操作
        File myFile = new File(externalDir, "myFile.txt");
        
        // 进行文件读写操作
        writeToFile(myFile, "Hello, External Storage!");
    }
}

private void writeToFile(File file, String data) {
    try (FileOutputStream fos = new FileOutputStream(file)) {
        fos.write(data.getBytes());
        fos.flush();
        Toast.makeText(this, "File written successfully", Toast.LENGTH_SHORT).show();
    } catch (IOException e) {
        e.printStackTrace();
        Toast.makeText(this, "File write failed", Toast.LENGTH_SHORT).show();
    }
}

4. 进行文件读写操作

在上面已经展示了如何写文件。你可以添加读取文件的功能：

private String readFromFile(File file) {
    StringBuilder content = new StringBuilder();
    try (BufferedReader br = new BufferedReader(new FileReader(file))) {
        String line;
        while ((line = br.readLine()) != null) {
            content.append(line);
            content.append('\n');
        }
    } catch (IOException e) {
        e.printStackTrace();
    }
    return content.toString();
}

序列图示例

以下是执行上述步骤的序列图：

sequenceDiagram
    participant User
    participant App
    User->>App: Launch App
    App->>User: Request Storage Permission
    User->>App: Grant Permission
    App->>App: Access External Storage
    App->>App: Write/Read File
    App->>User: Show Success Message

结尾

通过以上步骤，你已经了解了如何在Android 11中获取外部存储目录并进行文件操作。请注意，Android对存储管理的限制越来越严格，因此切记在开发过程中遵循最佳实践，使用适当的API，同时确保你的应用能够正常处理权限请求和用户体验。这将为你的Android开发之旅打下坚实的基础！