Android 14 、15动态申请读写权限实现 (Java)

🏷️ 365beat 📅 2025-08-04 04:52:37 👤 admin 👀 1667 ⭐ 257
Android 14 、15动态申请读写权限实现 (Java)

在 Android 14、15 中,Google 进一步优化了存储权限系统,特别是写权限的管理。以下是完整的 Java 实现方案:

1. AndroidManifest.xml 声明权限

android:maxSdkVersion="32" />

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 requestPermissionsLauncher =

registerForActivityResult(new ActivityResultContracts.RequestMultiplePermissions(),

this::handlePermissionResult);

// 检查并请求存储权限

public void checkAndRequestStoragePermissions() {

List 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 permissions) {

List deniedPermissions = new ArrayList<>();

for (Map.Entry 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 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 的写权限要求,同时保持了良好的向后兼容性。

相关推荐 ✨