解决各版本安卓读写SD卡的问题-java.io.IOException: Operation not permitted问题（兼容到android13）

Posted 2023-04-04 失落夏天

前言：

本文的核心是解决安卓上面读写SD卡目录的问题。

众所周知，安卓上面对于应用来说可以读写的有三块区域：

1.data/data/包名；

2.sdcard/android/data/包名；

3.sdcard目录。

前两块区域读写一般是没有什么限制的，可以直接读写。但是第三块区域，因为各个APP都可以申请对这块区域进行读写，所以就会很乱，因此安卓也在不断的加强对这块区域管控的力度。

但是我们对SD卡根目录直接读写的需求是一直存在的，所以本文将会记录每个安卓版本对这块权限的变化，以及相对应的解决方案。（持续更新，目前更新到安卓12）

版本适配方案：

1.安卓6.0之前

6.0之前是不需要动态申请权限的，直接在manifest中申请即可以正常使用。

manifest申明：

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    package="com.xt.client">
    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
    ...
</manifest>

代码使用：

private void writeFile() throws IOException 
        String absolutePath = Environment.getExternalStorageDirectory().getAbsolutePath();
        File file = new File(absolutePath + File.separator + "a.txt");
        if (file.exists()) 
            file.delete();
            ToastUtil.showCenterToast("文件存在，删除成功");
         else 
            file.createNewFile();
            ToastUtil.showCenterToast("文件不存在，创建成功");
        
    

2.安卓6.0，SDK=23

描述：6.0开始，需要申请读写权限，读和写权限是分开的。

如果申请了写的权限，那么读的权限不需要额外在申请。

解决方案：

1.使用前进行权限检查，如果给予权限则直接使用。

2.如果没有权限，则动态申请权限。

 if (ContextCompat.checkSelfPermission(this,Manifest.permission.WRITE_EXTERNAL_STORAGE) != PackageManager.PERMISSION_GRANTED) 
            requestPermissions(new String[]Manifest.permission.WRITE_EXTERNAL_STORAGE, 1);
else
     writeFile();

在返回的结果里面进行判断，如果给予了权限，则进行写入操作。

 @Override
    public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) 
        super.onRequestPermissionsResult(requestCode, permissions, grantResults);
        if(requestCode==1 && (grantResults[0] == PackageManager.PERMISSION_GRANTED))
            writeFile();
        
    

3.安卓10，SDK=29

安卓10开始，安卓继续加强了限制，如果需要读写SD卡，还需要额外的进行申请requestLegacyExternalStorage申明。

解决方案：

1.targetSdkVersion<29 的应用程序默认带有requestLegacyExternalStorage=true属性。不需要额外处理。

2.targetSdkVersion>=29，需要在manifest的application中进行申请使用，如下：

<application
        android:name=".application.DemoApplication"
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:requestLegacyExternalStorage="true"//这一行
        android:roundIcon="@mipmap/ic_launcher_round"
        android:supportsRtl="true"
        tools:ignore="GoogleAppIndexingWarning">
>

安卓10之前的（包含10）都可以使用该方案。

4.安卓11，SDK=30

安卓11的时候继续强化对SD卡读写的管理，引入了MANAGE_EXTERNAL_STORAGE权限，而之前的WRITE_EXTERNAL_STORAGE已经失效了。

并且MANAGE_EXTERNAL_STORAGE权限只能跳转设置页面申请。

解决方案：

1.判断是否有MANAGE_EXTERNAL_STORAGE权限，如果没有跳转设置界面申请。

2.如果有则直接进行读写

 if (sdkInt >= 30) 
                if (!Environment.isExternalStorageManager()) 
                    Intent intent = new Intent(Settings.ACTION_MANAGE_ALL_FILES_ACCESS_PERMISSION);
                    startActivity(intent);
                    return;
                
                writeFile();
                return;
            

目前11，12的设备上都验证通过。

流程5.安卓13，SDK=33

android13上，取消了android.permission.WRITE_EXTERNAL_STORAGE权限，所以只需要申请android.permission.MANAGE_EXTERNAL_STORAGE权限就可以了。

所以，代码上和流程4一样，不要申请WRITE_EXTERNAL_STORAGE权限即可。

Android获取外置SD卡读写路径

1. 外置SD卡的一些问题

1.1 关于外置SD卡上的读写路径

Android 4.4及以上版本，应用的外置SD卡读写路径被限定在固定路径上(外置SD卡根路径/Android/data/包名/files)。

Android4.4以下版本，申请了外置SD卡读写权限的应用在整个外置SD卡上都有读写权限。

1.2 关于外置SD卡路径

另外Android没有提供获取外置SD卡路径的API(getExternalStorageDirectory()获取的实际是内置SD卡路径)。

2. 获取应用在外置SD卡读写根路径

在Android 4.4以下版本，获取的应该是外置SD卡的根目录(类似/storage/sdcard1)。在Android 4.4及以上版本，获取的是应用在SD卡上的限定目录(外置SD卡根路径/Android/data/包名/files/file)

代码如下：

    public static String getExternalSDPath(Context aContext) 
        String root = null;
        if (android.os.Build.VERSION.SDK_INT >= android.os.Build.VERSION_CODES.KITKAT) 
            root = getExternalSDPathKITKAT(aContext);
            File f = new File(root);
            if (!f.exists()) 
                try 
                    f.mkdirs();
                 catch (Exception e) 
                    e.printStackTrace();
                
                if (!f.exists()) 
                    root = null;
                
            
         else 
            root = getExternalSDCardPath(aContext);
        
        return root;
    


    // Android 4.4及以上版本,获取软件在外置SD卡上的保存路径
    public static String getExternalSDPathKITKAT(Context aContext) 
        String rootPath = getStoragePath(aContext, true);
        if (TextUtils.isEmpty(rootPath)) 
            return null;
        
        File f = new File(rootPath, "Android/data/" + aContext.getPackageName() + "/files/file");
        String fpath = f.getAbsolutePath();
        return fpath;
    

    // Android 4.4 以下版本获取外置SD卡根目录
    public static String getExternalSDCardPath(Context aContext) 
        HashSet<String> paths = getExternalMounts();
        File defaultPathFile = aContext.getExternalFilesDir(null);
        String defaultPath;
        if (defaultPathFile == null) 
            return null;
         else 
            defaultPath = defaultPathFile.getAbsolutePath();
        
        String prefered = null;
        for (Iterator it = paths.iterator(); it.hasNext();) 
            String path = (String) (it.next());
            if (prefered == null && !defaultPath.startsWith(path)) 
                prefered = path;
            
        
        return prefered;