You need to enable JavaScript to run this app. 目标SDK 30下Android如何基于scoped storage结合CameraX实现拍照与ImageView展示
优惠活动
大模型
产品
解决方案
定价
更多

目标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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.06 10:27:03