Android14 、15动态申请读写权限实现方法示例代码 (Java)

更新时间：2025年06月06日 10:44:23 作者：blog_jenny

在Android应用开发中,文件读写权限是至关重要的一个环节,因为这关乎到应用程序能否正常地存储和访问数据,这篇文章主要介绍了Android14 、15动态申请读写权限实现方法的相关资料,需要的朋友可以参考下

1. AndroidManifest.xml 声明权限

<strong><!-- Android 14 存储权限 -->
<uses-permission android:name="android.permission.READ_MEDIA_IMAGES" />
<uses-permission android:name="android.permission.READ_MEDIA_VIDEO" />
<uses-permission android:name="android.permission.READ_MEDIA_AUDIO" />
<!-- 新增的视觉媒体选择权限 -->
<uses-permission android:name="android.permission.READ_MEDIA_VISUAL_USER_SELECTED" /></strong>
<!-- 兼容旧版本 (可选) -->
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" 
                 android:maxSdkVersion="32" />

<!-- 写入权限 -->
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" 
                 android:maxSdkVersion="32" /> <!-- 仅用于兼容旧版本 -->

2. Java 权限请求实现

import android.Manifest;
import android.content.Intent;
import android.content.pm.PackageManager;
import android.net.Uri;
import android.os.Build;
import android.provider.Settings;
import android.widget.Toast;

import androidx.activity.result.ActivityResultLauncher;
import androidx.activity.result.contract.ActivityResultContracts;
import androidx.appcompat.app.AlertDialog;
import androidx.appcompat.app.AppCompatActivity;
import androidx.core.content.ContextCompat;

import java.util.ArrayList;
import java.util.List;
import java.util.Map;

public class StoragePermissionHelper extends AppCompatActivity {

    // 多权限请求启动器
    private final ActivityResultLauncher<String[]> requestPermissionsLauncher =
            registerForActivityResult(new ActivityResultContracts.RequestMultiplePermissions(),
                    this::handlePermissionResult);

    // 检查并请求存储权限
    public void checkAndRequestStoragePermissions() {
        List<String> permissionsToRequest = new ArrayList<>();
        
        // Android 14+ 需要的权限(读、写权限)        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.UPSIDE_DOWN_CAKE) {
            if (ContextCompat.checkSelfPermission(this, Manifest.permission.READ_MEDIA_IMAGES) 
                    != PackageManager.PERMISSION_GRANTED) {
                permissionsToRequest.add(Manifest.permission.READ_MEDIA_IMAGES);            }
            if (ContextCompat.checkSelfPermission(this, Manifest.permission.READ_MEDIA_VIDEO) 
                    != PackageManager.PERMISSION_GRANTED) {
                permissionsToRequest.add(Manifest.permission.READ_MEDIA_VIDEO);            }
            if (ContextCompat.checkSelfPermission(this, Manifest.permission.READ_MEDIA_VISUAL_USER_SELECTED) 
                    != PackageManager.PERMISSION_GRANTED) {
                permissionsToRequest.add(Manifest.permission.READ_MEDIA_VISUAL_USER_SELECTED);            }
        } 
        // Android 13(读、写权限)        else if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {
            if (ContextCompat.checkSelfPermission(this, Manifest.permission.READ_MEDIA_IMAGES) 
                    != PackageManager.PERMISSION_GRANTED) {
                permissionsToRequest.add(Manifest.permission.READ_MEDIA_IMAGES);
            }
            if (ContextCompat.checkSelfPermission(this, Manifest.permission.READ_MEDIA_VIDEO) 
                    != PackageManager.PERMISSION_GRANTED) {
                permissionsToRequest.add(Manifest.permission.READ_MEDIA_VIDEO);
            }
        }
        // Android 10-12(读、写权限)        else if (ContextCompat.checkSelfPermission(this, Manifest.permission.READ_EXTERNAL_STORAGE) 
                != PackageManager.PERMISSION_GRANTED) {
            permissionsToRequest.add(Manifest.permission.READ_EXTERNAL_STORAGE);
if (ContextCompat.checkSelfPermission(this, Manifest.permission.WRITE_EXTERNAL_STORAGE) 
                != PackageManager.PERMISSION_GRANTED) {
            permissionsToRequest.add(Manifest.permission.WRITE_EXTERNAL_STORAGE);
        }
}
        if (permissionsToRequest.isEmpty()) {
            onStoragePermissionGranted();
        } else {
            requestPermissionsLauncher.launch(permissionsToRequest.toArray(new String[0]));
        }
    }

    // 处理权限请求结果
    private void handlePermissionResult(Map<String, Boolean> permissions) {
        List<String> deniedPermissions = new ArrayList<>();
        
        for (Map.Entry<String, Boolean> entry : permissions.entrySet()) {
            if (!entry.getValue()) {
                deniedPermissions.add(entry.getKey());
            }
        }

        if (deniedPermissions.isEmpty()) {
            onStoragePermissionGranted();
        } else {
            handleDeniedPermissions(deniedPermissions);
        }
    }

    // 权限全部授予
    private void onStoragePermissionGranted() {
        Toast.makeText(this, "存储权限已授予", Toast.LENGTH_SHORT).show();
        // 这里可以执行需要权限的操作
    }

    // 处理被拒绝的权限
    private void handleDeniedPermissions(List<String> deniedPermissions) {
        for (String permission : deniedPermissions) {
            if (shouldShowRequestPermissionRationale(permission)) {
                showRationaleDialog(permission);
            } else {
                showGoToSettingsDialog(permission);
            }
        }
    }

    // 显示权限解释对话框
    private void showRationaleDialog(String permission) {
        new AlertDialog.Builder(this)
                .setTitle("需要权限")
                .setMessage(getPermissionMessage(permission))
                .setPositiveButton("确定", (dialog, which) -> 
                    checkAndRequestStoragePermissions())
                .setNegativeButton("取消", null)
                .show();
    }

    // 显示前往设置对话框
    private void showGoToSettingsDialog(String permission) {
        new AlertDialog.Builder(this)
                .setTitle("权限被永久拒绝")
                .setMessage("请在应用设置中手动授予" + getPermissionName(permission) + "权限")
                .setPositiveButton("去设置", (dialog, which) -> {
                    Intent intent = new Intent(Settings.ACTION_APPLICATION_DETAILS_SETTINGS);
                    intent.setData(Uri.fromParts("package", getPackageName(), null));
                    startActivity(intent);
                })
                .setNegativeButton("取消", null)
                .show();
    }

    // 获取权限说明信息
    private String getPermissionMessage(String permission) {
        switch (permission) {
            case Manifest.permission.READ_MEDIA_IMAGES:
                return "需要访问您的照片以提供完整功能";
            case Manifest.permission.READ_MEDIA_VIDEO:
                return "需要访问您的视频以提供完整功能";
            case Manifest.permission.READ_MEDIA_VISUAL_USER_SELECTED:
                return "需要访问您选择的媒体文件";
            case Manifest.permission.READ_EXTERNAL_STORAGE:
                return "需要访问您的文件以提供完整功能";
            default:
                return "需要此权限以提供完整功能";
        }
    }

    // 获取权限名称
    private String getPermissionName(String permission) {
        switch (permission) {
            case Manifest.permission.READ_MEDIA_IMAGES:
                return "照片访问";
            case Manifest.permission.READ_MEDIA_VIDEO:
                return "视频访问";
            case Manifest.permission.READ_MEDIA_VISUAL_USER_SELECTED:
                return "选择的媒体文件访问";
            case Manifest.permission.READ_EXTERNAL_STORAGE:
                return "文件访问";
            default:
                return "存储";
        }
    }
}

3. 使用示例

public class MainActivity extends StoragePermissionHelper {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        
        findViewById(R.id.btn_request_storage).setOnClickListener(v -> {
            checkAndRequestStoragePermissions();
        });
    }
    
    @Override
    protected void onResume() {
        super.onResume();
        // 从设置返回后检查权限状态
        verifyStoragePermissions();
    }
    
    private void verifyStoragePermissions() {
        boolean hasPermissions;
        
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.UPSIDE_DOWN_CAKE) {
            hasPermissions = ContextCompat.checkSelfPermission(this, 
                    Manifest.permission.READ_MEDIA_IMAGES) == PackageManager.PERMISSION_GRANTED
                    && ContextCompat.checkSelfPermission(this, 
                    Manifest.permission.READ_MEDIA_VIDEO) == PackageManager.PERMISSION_GRANTED;
        } else if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {
            hasPermissions = ContextCompat.checkSelfPermission(this, 
                    Manifest.permission.READ_MEDIA_IMAGES) == PackageManager.PERMISSION_GRANTED;
        } else {
            hasPermissions = ContextCompat.checkSelfPermission(this, 
                    Manifest.permission.READ_EXTERNAL_STORAGE) == PackageManager.PERMISSION_GRANTED;
        }
        
        if (hasPermissions) {
            onStoragePermissionGranted();
        }
    }
}

Android 14 存储权限关键点

新增权限:
- READ_MEDIA_VISUAL_USER_SELECTED: 允许用户选择特定媒体文件
- 其他媒体权限与 Android 13 相同
权限策略变化:
- 完全移除了 READ_EXTERNAL_STORAGE 对媒体文件的控制
- 应用默认只能访问自己创建的文件
- 访问其他媒体文件必须请求权限
最佳实践:
- 优先使用系统照片选择器 (Photo Picker)
- 只在真正需要时才请求权限
- 提供清晰的权限解释
- 正确处理所有可能的拒绝情况
兼容性考虑:
- 使用 Build.VERSION.SDK_INT 检查系统版本
- 为不同版本提供不同的权限请求策略
- 测试在各种场景下的权限行为

这套实现方案完全符合 Android 14 的存储权限要求，同时保持了良好的向后兼容性。

Android 14 写权限关键点

主要变化:
- Android 14 继续限制 WRITE_EXTERNAL_STORAGE 的使用
- 需要 MANAGE_EXTERNAL_STORAGE 权限才能管理所有文件
- 必须引导用户到系统设置手动开启"管理所有文件"权限
权限策略:
- 应用默认只能写入自己的专属目录
- 写入共享存储需要相应权限
- 管理所有文件需要用户显式授权
最佳实践:
- 优先使用 MediaStore API 来写入共享媒体文件
- 使用 SAF (Storage Access Framework) 让用户选择保存位置
- 只在绝对必要时请求管理所有文件权限
- 提供清晰的权限解释和引导
兼容性处理:
- 为不同 Android 版本提供不同的权限请求策略
- 使用 Environment.isExternalStorageManager() 检查管理权限
- 测试在各种情况下的权限行为

这套实现方案完全符合 Android 14 的写权限要求，同时保持了良好的向后兼容性。

总结

到此这篇关于Android14 、15动态申请读写权限实现方法的文章就介绍到这了,更多相关Android动态申请读写内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:

Flutter 点击两次退出app的实现示例
本文主要介绍了Flutter 点击两次退出app的实现示例，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
2022-05-05
Android 开发随手笔记之使用摄像头拍照
在Android中，使用摄像头拍照一般有两种方法，一种是调用系统自带的Camera，另一种是自己写一个摄像的界面，本篇文章给大家介绍android开发随手笔记之使用摄像头拍照，感兴趣的朋友一起学习吧
2015-11-11
Listview的异步加载性能优化
Android中ListView是使用平率最高的控件之一（GridView跟ListView是兄弟，都是继承AbsListView），ListView优化最有效的无非就是采用ViewHolder来减少频繁的对view查询和更新，缓存图片加快解码，减小图片尺寸
2016-01-01
Android 6.0 蓝牙搜索不到设备原因,MIUI权限申请机制方法
今天小编就为大家分享一篇Android6.0 蓝牙搜索不到设备原因,MIUI权限申请机制方法，具有很好的参考价值，希望对大家有所帮助。一起跟随小编过来看看吧
2018-07-07
Android ContentProvider实现手机联系人读取和插入
这篇文章主要为大家详细介绍了Android ContentProvider实现手机联系人读取和插入，文中示例代码介绍的非常详细，具有一定的参考价值，感兴趣的小伙伴们可以参考一下
2019-05-05
浅谈关于Android路由的实现
本篇文章主要介绍了浅谈关于Android路由的实现，小编觉得挺不错的，现在分享给大家，也给大家做个参考。一起跟随小编过来看看吧
2017-10-10
Android开发者常见的UI组件总结大全
Android开发中UI组件是构建用户界面的基本元素,下面这篇文章主要给大家介绍了关于Android开发者常见的UI组件总结的相关资料,文中通过代码介绍的非常详细,需要的朋友可以参考下
2024-04-04
Android开发之滑动数值选择器NumberPicker用法示例
这篇文章主要介绍了Android开发之滑动数值选择器NumberPicker用法,结合实例形式分析了Android滑动数值选择器NumberPicker的功能、相关函数、事件监听、界面布局等操作技巧,需要的朋友可以参考下
2019-03-03
Android 微信小视频录制功能实现详细介绍
这篇文章主要介绍了Android 微信小视频录制功能实现详解的相关资料,这里提供了具体的实现思路及代码，需要的朋友可以参考下
2016-11-11
Android转场动画深入分析探究
对于一个动画而言，它是由多个分镜头组成的，而转场就是分镜之间衔接方式。转场的主要目的，就是为了让镜头与镜头之间过渡的更加自然，让动画更加连贯，例如两个页面切换之间的衔接动画
2022-10-10