在 Android 14、15 中，Google 进一步优化了存储权限系统，特别是写权限的管理。以下是完整的 Java 实现方案：
1. AndroidManifest.xml 声明权限
<!-- 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" />
<!-- 兼容旧版本 (可选) -->
<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 的写权限要求，同时保持了良好的向后兼容性。