目标SDK 30下Android如何基于scoped storage结合CameraX实现拍照与ImageView展示
targetSdk 30 下CameraX拍照 + Scoped Storage存储 + 图片展示全流程实现
核心合规前提
targetSdk 30(Android 11)下Scoped Storage强制生效,无合规绕过空间,严格遵循以下规则即可适配要求:
- 公共媒体目录的读写必须通过MediaStore API完成,不允许直接通过绝对路径访问文件
- 应用写入的自有媒体文件,默认拥有完整读写权限,不需要申请额外存储权限
requestLegacyExternalStorage=true配置在targetSdk30上完全无效,无需浪费时间配置
基础配置
- 依赖引入(对齐SDK30兼容的CameraX稳定版本)
// 模块级build.gradle def camerax_version = "1.1.0" dependencies { implementation "androidx.camera:camera-core:$camerax_version" implementation "androidx.camera:camera-camera2:$camerax_version" implementation "androidx.camera:camera-lifecycle:$camerax_version" implementation "androidx.camera:camera-view:$camerax_version" }
- 权限声明(AndroidManifest.xml)
- 必需权限:
android.permission.CAMERA,拍照前动态申请即可 - 低版本兼容:仅targetSdk<=28时需要申请
android.permission.WRITE_EXTERNAL_STORAGE,SDK29及以上不需要任何存储相关权限 - 无需申请权限:
MANAGE_EXTERNAL_STORAGE、READ_EXTERNAL_STORAGE,申请这类权限容易触发应用上架审核被拒
- 必需权限:
合规存储路径选择(二选一)
- 场景1:图片不需要在系统相册展示,仅应用内部使用
直接使用应用私有外部目录:context.getExternalFilesDir(Environment.DIRECTORY_PICTURES),该路径下的文件不受Scoped Storage隔离限制,无权限要求,应用卸载时自动清除 - 场景2:图片需要在系统相册展示,对其他应用可见
通过MediaStore API写入公共Pictures目录,写入后系统自动将文件索引到相册,不需要额外权限
CameraX 拍照实现流程
- 第一步:初始化ImageCapture用例,绑定页面生命周期
val imageCapture = ImageCapture.Builder() .setCaptureMode(ImageCapture.CAPTURE_MODE_MINIMIZE_LATENCY) .build() // 获取CameraProvider实例并绑定生命周期 val cameraProviderFuture = ProcessCameraProvider.getInstance(this) cameraProviderFuture.addListener({ val cameraProvider = cameraProviderFuture.get() // 清空之前的相机绑定 cameraProvider.unbindAll() // 选择后置摄像头 val cameraSelector = CameraSelector.DEFAULT_BACK_CAMERA // 将预览、拍照用例绑定到当前页面生命周期 cameraProvider.bindToLifecycle( this, cameraSelector, previewView.surfaceProvider, imageCapture ) }, ContextCompat.getMainExecutor(this))
- 第二步:根据选定的存储路径构造拍照输出参数
- 私有目录输出参数:
val privatePhotoFile = File( getExternalFilesDir(Environment.DIRECTORY_PICTURES), "${System.currentTimeMillis()}.jpg" ) val outputOptions = ImageCapture.OutputFileOptions.Builder(privatePhotoFile).build()- 公共MediaStore目录输出参数(SDK30合规):
val photoContentValues = ContentValues().apply { put(MediaStore.Images.Media.DISPLAY_NAME, "IMG_${System.currentTimeMillis()}.jpg") put(MediaStore.Images.Media.MIME_TYPE, "image/jpeg") // 指定公共目录下的自定义子目录 put(MediaStore.Images.Media.RELATIVE_PATH, "${Environment.DIRECTORY_PICTURES}/你的应用名") } val outputOptions = ImageCapture.OutputFileOptions.Builder( contentResolver, MediaStore.Images.Media.EXTERNAL_CONTENT_URI, photoContentValues ).build() - 第三步:触发拍照,拿到保存后的文件Uri
imageCapture.takePicture( outputOptions, ContextCompat.getMainExecutor(this), object : ImageCapture.OnImageSavedCallback { override fun onImageSaved(result: ImageCapture.OutputFileResults) { // 获取图片可访问Uri // 私有目录场景:result.savedUri 为 null,直接使用之前构造的文件Uri即可 // 公共MediaStore场景:result.savedUri 为系统返回的可直接访问的媒体Uri val savedUri = result.savedUri ?: Uri.fromFile(privatePhotoFile) // 将Uri传递给ImageView展示方法 showImageInImageView(savedUri) } override fun onError(exception: ImageCaptureException) { // 拍照失败异常处理 } } )
ImageView 图片展示实现
SDK30下Scoped Storage对应用自有写入的媒体文件无访问限制,展示逻辑不需要额外申请权限:
private fun showImageInImageView(targetUri: Uri) { // 通过ContentResolver打开输入流解码即可访问,无权限限制 contentResolver.openInputStream(targetUri)?.use { inputStream -> val bitmap = BitmapFactory.decodeStream(inputStream) binding.resultImageView.setImageBitmap(bitmap) } }
高频踩坑提醒
- 不要通过硬编码的绝对路径(比如
/sdcard/Pictures/xxx.jpg)读取保存的图片,Scoped Storage下会直接抛出文件找不到异常,所有文件访问必须通过之前保存的Uri完成 - 不要对MediaStore返回的Uri申请永久权限,当前应用自己写入的媒体文件默认拥有永久读写权限,申请多余权限反而会触发系统异常
- 大尺寸图片展示时建议增加Bitmap压缩逻辑,避免内存溢出
内容的提问来源于stack exchange,提问作者akkmastr
相关产品推荐
相关产品推荐

