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:name="android.permission.READ_MEDIA_IMAGES" /> <uses-permission android:name="android.permission.READ_MEDIA_VIDEO" />

注意：这三个权限都属于危险权限，需要运行时动态申请。即使声明在Manifest中，也必须通过用户交互获取。

1.2 文件访问权限的演进路线

从Android 11到13，文件访问权限模型经历了三个阶段的变化：

这种演进反映了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 上架避坑指南

如果确实需要使用全文件访问权限，需要注意以下审核要点：

1. 在应用商店的声明表格中详细说明使用该权限的必要性
2. 提供清晰的用户教育流程，解释为什么需要此权限
3. 实现优雅的降级处理，当权限被拒绝时应用仍能提供核心功能

一个常见的审核失败案例是：

// 错误示范：直接退出应用 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 用户体验优化技巧

好的权限请求应该包含：

1. 前置说明：解释为什么需要这个权限
2. 上下文触发：在真正需要时才请求
3. 被拒处理：提供继续使用的替代方案

示例代码：

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 权限组合策略

常见的媒体+相机使用场景需要处理两种权限：

1. 相机权限：CAMERA
2. 存储权限：根据版本选择READ_MEDIA_IMAGES或WRITE_EXTERNAL_STORAGE

建议的分步请求流程：

1. 先请求相机权限
2. 拍摄完成后根据需要请求存储权限
3. 保存照片时检查权限状态

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 } }