Android 5设备运行CameraX无法保存拍照且出现ColorDrawable异常日志

1. ColorDrawable D级日志的含义 #

Android 5.0（API 21）是首个引入Material Design和新版Drawable渲染逻辑的系统版本，大量D级ColorDrawable日志属于视图绘制阶段的系统调试输出，常见触发场景为：

• 你实现的水印添加逻辑中调用了Canvas绘制ColorDrawable类型的背景/填充色，API 21对Drawable的状态变更、绘制回调的日志打印策略比高版本更激进，Debug版本会默认输出这类绘制流程日志
• 这类日志本身是调试级别的系统输出，默认不会触发应用崩溃或功能异常

2. 与“Failed to rename file”保存失败的相关性 #

两类现象没有直接关联。ColorDrawable日志属于视图绘制链路的输出，拍照保存失败属于CameraX的ImageCapture模块IO链路异常，API 21下出现该错误的核心原因是：

CameraX的ImageCapture内部保存逻辑在API < 23的设备上，OutputFileOptions对应的临时文件转存逻辑存在兼容性问题：高版本系统的File.renameTo()支持跨存储卷操作，但API 21的renameTo()仅支持同存储卷内操作，如果你的临时文件生成路径和最终保存路径不在同一个存储分区（比如临时文件在沙盒内部缓存目录，最终保存路径在公共外部存储），就会触发rename失败抛出ImageCaptureException。
此外如果你使用的是较新的CameraX版本，官方已经停止对API 21的兼容测试，部分IO逻辑没有向下适配低版本的文件权限和文件系统限制。

3. 故障解决方案 #

3.1 解决拍照保存失败问题 #

• 方案一：统一临时文件与最终保存路径
  不要让CameraX自行处理转存逻辑，直接将OutputFileOptions的保存路径指定为最终存储路径，跳过系统内部的rename步骤：
  示例代码：

  // API 21兼容写法：直接指定最终输出路径，不要使用需要转存的FileOutputStream类构造方式
  val saveFile = File(getExternalFilesDir(Environment.DIRECTORY_PICTURES), "captured_${System.currentTimeMillis()}.jpg")
  val outputOptions = ImageCapture.OutputFileOptions.Builder(saveFile).build()
  imageCapture.takePicture(outputOptions, executor, object : ImageCapture.OnImageSavedCallback {
      // 原有回调逻辑
  })
  

• 方案二：自行处理图片存盘，不依赖CameraX内置保存逻辑
  从OnImageCapturedCallback拿到ImageProxy的ByteBuffer数据，自行实现IO逻辑写入目标文件，完全绕过CameraX内部的rename流程：

  // Java示例
  imageCapture.takePicture(executor, new ImageCapture.OnImageCapturedCallback() {
      @Override
      public void onCaptureSuccess(@NonNull ImageProxy image) {
          // 自行转换ImageProxy为Bitmap或者直接输出JPG字节到目标文件
          writeImageToFile(image, targetFile);
          image.close();
      }
  });
  

• 权限检查：确认AndroidManifest.xml已经配置API 21所需的存储权限，且运行时主动申请了权限：

  <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" android:maxSdkVersion="28" />
  <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
  

3.2 消除ColorDrawable日志 #

如果不需要这类调试日志，可以优化水印绘制逻辑：

• 避免在Bitmap上绘制ColorDrawable，直接调用Canvas的drawColor()方法填充背景，减少Drawable的状态变更回调
• 打Release包时，系统会自动屏蔽D级及以下的系统日志，无需额外做代码处理

内容的提问来源于stack exchange，提问作者Georgi Tasev