Android中布局导出PDF时图片无法正常绘制的问题排查

原因分析及解决方案 #

核心原因 #

1. 图片加载未完成：若图片通过异步加载库（如Glide、Picasso）加载，调用view.draw(canvas)时图片可能尚未完成加载，导致PDF中无图片内容。
2. 视图未关联Window上下文：用LayoutInflater.inflate(R.layout.pdf, null)加载视图时，视图未关联到Window，部分View（如ImageView）的图片解码、渲染逻辑依赖Window上下文才能触发。
3. 冗余空Bitmap绘制：代码中先绘制了一个空Bitmap到PDF画布，虽不会直接覆盖，但属于无效操作，可能干扰后续绘制流程。

解决方法 #

1. 确保图片加载完成

如果使用异步加载库，需等待图片加载完成后再执行PDF生成。以Glide为例：

Glide.with(context)
    .asBitmap()
    .load(图片路径/资源ID)
    .submit()
    .get() // 注意在子线程执行，避免阻塞主线程
    .let { bitmap ->
        imageView.setImageBitmap(bitmap)
        // 此处执行PDF生成逻辑
    }

2. 为视图关联Window上下文

修改视图加载代码，传入Activity的根布局作为parent：

val parent = (context as Activity).findViewById<ViewGroup>(android.R.id.content)
val view = LayoutInflater.from(context).inflate(R.layout.pdf, parent, false)

或者手动设置WindowToken（需确保在Activity生命周期内执行）：

view.windowToken = (context as Activity).window.decorView.windowToken

3. 优化视图绘制逻辑

删除冗余的空Bitmap绘制代码，同时改为先将视图完整绘制到Bitmap，再把Bitmap写入PDF：

// 修改loadBitmapFromView方法
private fun loadBitmapFromView(view: View): Bitmap {
    val bitmap = Bitmap.createBitmap(view.measuredWidth, view.measuredHeight, Bitmap.Config.ARGB_8888)
    val canvas = Canvas(bitmap)
    view.draw(canvas)
    return bitmap
}

// 生成PDF时调用
val bitmap = loadBitmapFromView(view)
canvas.drawBitmap(bitmap, 0f, 0f, null)

4. 监听视图绘制完成事件

通过ViewTreeObserver确保视图布局、绘制完成后再生成PDF：

view.viewTreeObserver.addOnGlobalLayoutListener(object : ViewTreeObserver.OnGlobalLayoutListener {
    override fun onGlobalLayout() {
        view.viewTreeObserver.removeOnGlobalLayoutListener(this)
        // 在此处执行PDF生成逻辑
    }
})

内容的提问来源于stack exchange，提问作者Salma KD