前言

由于Google对用户隐私和系统安全做的越来越完善，应用对一些敏感信息的操作越来越难。比如最常见的共享存储空间的访问，像保存图片到相册这种常见的需求。

Android 6.0 以前，应用要想保存图片到相册，只需要通过File对象打开IO流就可以保存；
Android 6.0 添加了运行时权限，需要先申请存储权限才可以保存图片；
Android 10 引入了分区存储，但不是强制的，可以通过清单配置android:requestLegacyExternalStorage="true"关闭分区存储；
Android 11 强制开启分区存储，应用以 Android 11 为目标版本，系统会忽略 requestLegacyExternalStorage标记，访问共享存储空间都需要使用MediaStore进行访问。

注意

使用内部存储应用卸载后，存储的文件自动删除
使用外部存储要申请权限，并且要判断外部存储是否可用

申请权限

有些权限必须用户同意才能调用相应功能，所以开发者需要调用权限申请的代码，弹出一个小窗口，向用户动态申请权限。
首先要在AndroidManifest.xml文件的application 标签下加一条属性 android:requestLegacyExternalStorage="true"
还有读写权限：

<!--Android Q之后不需要存储权限，完全使用MediaStore API来实现-->
<uses-permission
                 android:name="android.permission.READ_EXTERNAL_STORAGE"
                 android:maxSdkVersion="28" />
<uses-permission
                 android:name="android.permission.WRITE_EXTERNAL_STORAGE"
                 android:maxSdkVersion="28" />

以下是动态申请文件读写权限的过程：

1.读与写的权限先定义到静态字符数组中：

private static String[] PERMISSIONS_STORAGE = {
    Manifest.permission.READ_EXTERNAL_STORAGE,
    Manifest.permission.WRITE_EXTERNAL_STORAGE
};

2.首先判断当前系统是否是Android6.0(对应API 23)以及以上，如果是则判断是否含有了写文件的权限，如果没有则调用动态申请权限的代码，ActivityCompat.requestPermission方法的第一个参数是目标Activity,填写this即可，第二个参数是String[]字符数组类型的权限集，第三个即请求码：

if (Build.VERSION.SDK_INT > Build.VERSION_CODES.LOLLIPOP) {
    if (ActivityCompat.checkSelfPermission(this, Manifest.permission.WRITE_EXTERNAL_STORAGE) != PackageManager.PERMISSION_GRANTED) {
        ActivityCompat.requestPermissions(this, PERMISSIONS_STORAGE, REQUEST_PERMISSION_CODE);
    }
}

3.回调函数，申请权限后回调onRequestPermissionResult函数，第一个参数为请求码，第二个参数是刚刚请求的权限集，第三个参数是请求结果，0表示授权成功，-1表示授权失败：

@Override
public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
    super.onRequestPermissionsResult(requestCode, permissions, grantResults);
    if (requestCode == REQUEST_PERMISSION_CODE) {
        for (int i = 0; i < permissions.length; i++) {
            Log.i("MainActivity", "申请的权限为：" + permissions[i] + ",申请结果：" + grantResults[i]);
        }
    }
}

4.所有代码：

import androidx.annotation.NonNull;
import androidx.appcompat.app.AppCompatActivity;
import androidx.core.app.ActivityCompat;

import android.Manifest;
import android.content.pm.PackageManager;
import android.os.Build;
import android.os.Bundle;
import android.util.Log;

public class MainActivity extends AppCompatActivity {
    //读写权限
    private static String[] PERMISSIONS_STORAGE = {
        Manifest.permission.READ_EXTERNAL_STORAGE,
        Manifest.permission.WRITE_EXTERNAL_STORAGE
    };
    //请求状态码
    private static int REQUEST_PERMISSION_CODE = 1;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        if (Build.VERSION.SDK_INT > Build.VERSION_CODES.LOLLIPOP) {
            if (ActivityCompat.checkSelfPermission(this, Manifest.permission.WRITE_EXTERNAL_STORAGE) != PackageManager.PERMISSION_GRANTED) {
                ActivityCompat.requestPermissions(this, PERMISSIONS_STORAGE, REQUEST_PERMISSION_CODE);
            }
        }
    }

    @Override
    public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
        super.onRequestPermissionsResult(requestCode, permissions, grantResults);
        if (requestCode == REQUEST_PERMISSION_CODE) {
            for (int i = 0; i < permissions.length; i++) {
                Log.i("MainActivity", "申请的权限为：" + permissions[i] + ",申请结果：" + grantResults[i]);
            }
        }
    }
}

文件存储

要求文件公开

public static String getFilePath(Context context, String dir) {
    String directoryPath = "";
    //判断外部存储是否可用
    if (MEDIA_MOUNTED.equals(Environment.getExternalStorageState())) {
        directoryPath = Environment
            .getExternalStoragePublicDirectory(Environment.DIRECTORY_DOCUMENTS)
            .getAbsolutePath() + File.separator + dir;
    } else {//没外部存储就使用内部存储
        directoryPath = context.getFilesDir() + File.separator + dir;
    }
    File file = new File(directoryPath);
    if (!file.exists()) {//判断文件目录是否存在
        file.mkdirs();
    }
    return directoryPath;
}

要求文件私有的话

public static String getFilePath(Context context, String dir) {
    String directoryPath = "";
    //判断外部存储是否可用
    if (MEDIA_MOUNTED.equals(Environment.getExternalStorageState())) {
        directoryPath = context.getExternalFilesDir(dir).getAbsolutePath();
    } else {//没外部存储就使用内部存储
        directoryPath = context.getFilesDir() + File.separator + dir;
    }
    File file = new File(directoryPath);
    if (!file.exists()) {//判断文件目录是否存在
        file.mkdirs();
    }
    return directoryPath;
}

内部存储

context.getCacheDir

1	File cacheDir = context.getCacheDir();

特点

应用内部存储空间
数据文件私有
不需要申请权限
当应用被卸载的时候，目录下的文件会被删除
存储小文件

需要注意的是，这个文件的目录和应用的存储位置有关，
当应用被移动到外部存储设备的时候，文件的绝对路径也是变化的，所以建议当数据存储到这个目录的时候，用相对路径。

这个目录和getFilesDir()目录最大的不同在于：当安卓设备的存储空间少，或者不够用的时候，系统会自动删除这个目录下的文件。

官方建议是，超过1MB的文件，建议存储到getExternalCacheDir()目录下

context.getFilesDir

1	File filesDir = context.getFilesDir();

特点

应用内部存储空间
数据文件私有
不需要申请权限
当应用被卸载的时候，目录下的文件会被删除

当应用被移动到外部存储设备的时候，文件的绝对路径也是变化的，所以建议当数据存储到这个目录的时候，用相对路径
系统提供的访问此路径文件的方法是：

1 2	context.openFileOutput(String,int); context.openFileInput(String name);

外部存储

Environment.getExternalStoragePublicDirectory

1	File externalStoragePublicDirectory = Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_PICTURES);

特点

应用外部存储空间
数据文件非私有
需要申请权限（READ_EXTERNAL_STORAGE， WRITE_EXTERNAL_STORAGE）
需要判断外部存储的挂载状态（getExternalStorageState(File)）
当应用被卸载的时候，目录下的不会被删除

这个目录是用来存放各种类型的文件的目录，在这里用户可以分类管理不同类型的文件（例如音乐、图片、电影等）
类型如下：

DIRECTORY_MUSIC
DIRECTORY_PODCASTS
DIRECTORY_RINGTONES
DIRECTORY_ALARMS
DIRECTORY_NOTIFICATIONS
DIRECTORY_PICTURES
DIRECTORY_MOVIES
DIRECTORY_DOWNLOADS
DIRECTORY_DCIM
DIRECTORY_DOCUMENTS

Environment.getExternalStorageDirectory

1	File externalStorageDirectory = Environment.getExternalStorageDirectory();

特点

应用外部存储空间
数据文件非私有
需要申请权限（READ_EXTERNAL_STORAGE， WRITE_EXTERNAL_STORAGE）
需要判断外部存储的挂载状态（getExternalStorageState(File)）
当应用被卸载的时候，目录下的不会被删除

注：在该目录下读写文件，需要获取读写权限
该目录下的文件，这个目录是用户进行操作的一个根目录，进入二级目录可以通过
getExternalFilesDirs(String), getExternalCacheDirs(), and getExternalMediaDirs()这些方法

官方建议:

不要直接使用该目录，为了避免污染用户的根命名空间
应用私有的数据，应该放在 context.getExternalFilesDir目录下
其他的可以被分享的文件，可以放在Environment.getExternalStoragePublicDirectory(String)目录下

context.getExternalFilesDir

1	File externalFilesDir = context.getExternalFilesDir(null);

特点

应用外部存储空间
数据文件私有
需要申请权限（READ_EXTERNAL_STORAGE， WRITE_EXTERNAL_STORAGE）
需要判断外部存储的挂载状态（getExternalStorageState(File)）
当应用被卸载的时候，目录下的文件会被删除

当应用被卸载的时候，目录下的文件会被删除，但是这里和getFilesDir()还有不同之处：

只有手机系统使用的是虚拟外部存储（虚拟SD卡）的时候,才可以在卸载应用的同时，自动删除该目录下的文件，如果是之前的物理存储（物理SD卡）则不会自动删除该目录，及目录下的文件

context.getExternalCacheDir

1	File externalCacheDir = context.getExternalCacheDir();

特点

应用外部存储空间
数据文件私有
需要申请权限（READ_EXTERNAL_STORAGE， WRITE_EXTERNAL_STORAGE）
需要判断外部存储的挂载状态（getExternalStorageState(File)）
当应用被卸载的时候，目录下的文件会被删除
存储大文件

当应用被卸载的时候，目录下的文件会被删除，但是这里和getCacheDir()还有不同之处：

只有手机系统使用的是虚拟外部存储（虚拟SD卡）的时候,才可以在卸载应用的同时，自动删除该目录下的文件
如果是之前的物理存储（物理SD卡）则不会自动删除该目录，及目录下的文件

我是码客，我是全栈工程师，我为自己代言。

Android文件存储路径

前言