Android14 、15动态申请读写权限实现方法示例代码 (Java)
目录
- 1. androidManifest.XML 声明权限
- 2. Java 权限请求实现
- 3. 使用示例
- Android 14 存储权编程客栈限关键点
- Android 14 写权限关键点
- 总结
在 Android 14、15 中,Google 进一步优化了存储权限系统,特别是写权限的管理。以下是完整的 Java 实现方案:
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.pythonapp.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_VID编程客栈EO); } 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_GRANhttp://www.devze.comTED) { 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动态申请读写内容请搜索编程客栈(www.devze.com)以前的文章或继续浏览下面的相关文章希望大家以后多多支持编程客栈(www.devze.com)!
精彩评论