Android 13适配踩坑记：从相册权限拆分到MANAGE_EXTERNAL_STORAGE的正确使用姿势

Android 13权限适配实战相册权限拆分与文件访问的合规之道去年在为一个摄影类应用做Android 13适配时我们团队遇到了一个棘手问题用户反馈相册功能突然无法正常使用。经过排查发现问题出在我们没有正确处理新的媒体权限分组。这件事让我深刻意识到随着Android系统权限模型的持续演进开发者必须及时掌握最新规范才能避免功能异常。1. Android 13权限模型的核心变更Android 13最显著的权限变化是将原本统一的媒体访问权限拆分为三个独立权限组。这种精细化管控意味着开发者需要重新思考应用的数据访问策略。1.1 媒体权限的三足鼎立在Android 13中媒体访问权限被细分为READ_MEDIA_IMAGES访问图片文件READ_MEDIA_VIDEO访问视频文件READ_MEDIA_AUDIO访问音频文件这种拆分带来的直接影响是即使用户之前授予过READ_EXTERNAL_STORAGE权限在Android 13设备上应用仍然无法自动获得媒体文件访问权。开发者必须在AndroidManifest中显式声明所需的具体权限uses-permission android:nameandroid.permission.READ_MEDIA_IMAGES / uses-permission android:nameandroid.permission.READ_MEDIA_VIDEO /注意这三个权限都属于危险权限需要运行时动态申请。即使声明在Manifest中也必须通过用户交互获取。1.2 文件访问权限的演进路线从Android 11到13文件访问权限模型经历了三个阶段的变化Android版本存储模型特点关键权限≤10宽松访问模式READ/WRITE_EXTERNAL_STORAGE11-12分区存储强制实施MANAGE_EXTERNAL_STORAGE≥13精细化媒体控制READ_MEDIA_* 权限组这种演进反映了Google在用户隐私保护和企业合规要求之间寻求平衡的努力。作为开发者我们需要理解每个版本的设计哲学而不是简单地把新权限当作技术障碍。2. MANAGE_EXTERNAL_STORAGE的正确使用姿势全文件访问权限就像一把双刃剑用得好可以解决复杂文件操作需求用不好则可能导致应用被应用商店拒绝。2.1 适用场景的黄金准则根据Google Play政策只有以下场景才应考虑使用MANAGE_EXTERNAL_STORAGE文件管理器类应用备份恢复工具防病毒软件文档编辑类应用的核心功能对于大多数应用而言更好的选择是使用MediaStore API或系统文件选择器。例如获取图片的推荐方式val intent Intent(Intent.ACTION_OPEN_DOCUMENT).apply { type image/* addCategory(Intent.CATEGORY_OPENABLE) } startActivityForResult(intent, REQUEST_CODE_PICK_IMAGE)2.2 上架避坑指南如果确实需要使用全文件访问权限需要注意以下审核要点在应用商店的声明表格中详细说明使用该权限的必要性提供清晰的用户教育流程解释为什么需要此权限实现优雅的降级处理当权限被拒绝时应用仍能提供核心功能一个常见的审核失败案例是// 错误示范直接退出应用 if (!Environment.isExternalStorageManager()) { finish() }应该改为if (!Environment.isExternalStorageManager()) { showExplanationDialog() // 同时提供使用MediaStore的备选方案 }3. 权限申请的工程实践动态权限请求是Android开发中的常见模式但在Android 13上需要特别注意版本适配和用户体验。3.1 兼容性处理框架建议采用分层权限检查策略fun checkMediaPermission(activity: Activity): Boolean { return when { Build.VERSION.SDK_INT Build.VERSION_CODES.TIRAMISU - { ContextCompat.checkSelfPermission( activity, Manifest.permission.READ_MEDIA_IMAGES ) PackageManager.PERMISSION_GRANTED } Build.VERSION.SDK_INT Build.VERSION_CODES.R - { Environment.isExternalStorageManager() } else - { ContextCompat.checkSelfPermission( activity, Manifest.permission.READ_EXTERNAL_STORAGE ) PackageManager.PERMISSION_GRANTED } } }3.2 用户体验优化技巧好的权限请求应该包含前置说明解释为什么需要这个权限上下文触发在真正需要时才请求被拒处理提供继续使用的替代方案示例代码fun requestMediaPermissions(activity: AppCompatActivity) { val permissions if (Build.VERSION.SDK_INT Build.VERSION_CODES.TIRAMISU) { arrayOf( Manifest.permission.READ_MEDIA_IMAGES, Manifest.permission.READ_MEDIA_VIDEO ) } else { arrayOf(Manifest.permission.READ_EXTERNAL_STORAGE) } val shouldShowRationale permissions.any { ActivityCompat.shouldShowRequestPermissionRationale(activity, it) } if (shouldShowRationale) { showRationaleDialog(activity, permissions) } else { ActivityCompat.requestPermissions( activity, permissions, REQUEST_CODE_MEDIA_PERMISSIONS ) } }4. 相机权限的特殊考量虽然相机权限本身没有变化但在Android 13上与媒体权限配合使用时需要注意几个细节。4.1 权限组合策略常见的媒体相机使用场景需要处理两种权限相机权限CAMERA存储权限根据版本选择READ_MEDIA_IMAGES或WRITE_EXTERNAL_STORAGE建议的分步请求流程先请求相机权限拍摄完成后根据需要请求存储权限保存照片时检查权限状态4.2 作用域存储下的文件保存在Android 10及以上版本直接访问文件路径的方式已被废弃。正确的保存方式fun saveImageToGallery(context: Context, bitmap: Bitmap): Uri? { val contentValues ContentValues().apply { put(MediaStore.Images.Media.DISPLAY_NAME, IMG_${System.currentTimeMillis()}) put(MediaStore.Images.Media.MIME_TYPE, image/jpeg) if (Build.VERSION.SDK_INT Build.VERSION_CODES.Q) { put(MediaStore.Images.Media.IS_PENDING, 1) } } val resolver context.contentResolver val uri resolver.insert( MediaStore.Images.Media.EXTERNAL_CONTENT_URI, contentValues ) ?: return null return try { resolver.openOutputStream(uri)?.use { os - bitmap.compress(Bitmap.CompressFormat.JPEG, 90, os) } if (Build.VERSION.SDK_INT Build.VERSION_CODES.Q) { contentValues.clear() contentValues.put(MediaStore.Images.Media.IS_PENDING, 0) resolver.update(uri, contentValues, null, null) } uri } catch (e: Exception) { resolver.delete(uri, null, null) null } }5. 测试与调试技巧完善的测试策略是确保权限功能正常的关键。5.1 自动化测试方案使用AndroidX Test可以模拟权限状态RunWith(AndroidJUnit4::class) class PermissionTest { get:Rule val grantPermissionRule: GrantPermissionRule GrantPermissionRule.grant( Manifest.permission.READ_MEDIA_IMAGES, Manifest.permission.CAMERA ) Test fun testCameraWithPermission() { // 测试在有权限情况下的相机功能 } }5.2 兼容性测试清单需要覆盖的测试场景从旧版本升级到Android 13的权限迁移权限被部分授予的情况如只给图片权限不给视频权限从系统设置中撤销权限后的应用行为低存储空间情况下的媒体访问在最近的一个项目中我们发现当用户只授予图片权限而拒绝视频权限时应用的照片选择器会出现不一致的行为。通过添加以下检查解决了这个问题fun hasRequiredMediaPermissions(context: Context): Boolean { return if (Build.VERSION.SDK_INT Build.VERSION_CODES.TIRAMISU) { val granted PackageManager.PERMISSION_GRANTED val hasImages ContextCompat.checkSelfPermission( context, Manifest.permission.READ_MEDIA_IMAGES ) granted val hasVideos ContextCompat.checkSelfPermission( context, Manifest.permission.READ_MEDIA_VIDEO ) granted // 根据应用需求决定是否需要两者都有 hasImages || hasVideos } else { true } }