如何在KMP桌面应用中实现账单Composable打印功能

针对你在KMP桌面端（基于JetBrains Compose for Desktop）的打印需求，这里提供一套可行的实现思路，核心是将Composable账单渲染为图像，再通过JVM的AWT打印API完成纸质打印。

实现步骤 #

1. 将Composable账单渲染为BufferedImage #

Compose Desktop可以通过ComposePanel将Composable渲染到AWT的BufferedImage上，这是连接Compose UI和JVM打印系统的关键步骤：

import androidx.compose.ui.awt.ComposePanel
import java.awt.image.BufferedImage
import javax.swing.SwingUtilities

fun composeBillToImage(billContent: @Composable () -> Unit): BufferedImage {
    // 定义账单基础尺寸，建议匹配打印纸张（比如A4宽度827px，96DPI标准）
    val targetWidth = 827
    var targetHeight = 1169 // 默认A4高度，后续会根据实际内容调整

    // 创建临时ComposePanel测量账单实际高度
    val panel = ComposePanel().apply {
        setContent {
            billContent()
            // 测量Composable的实际布局高度
            currentWindow?.layoutNode?.measure(Constraints(maxWidth = targetWidth))?.let {
                targetHeight = it.height
            }
        }
    }

    // 渲染账单到BufferedImage
    val image = BufferedImage(targetWidth, targetHeight, BufferedImage.TYPE_INT_ARGB)
    val g2d = image.createGraphics()
    panel.print(g2d)
    g2d.dispose()
    panel.dispose()

    return image
}

2. 通过AWT PrinterJob完成打印 #

拿到渲染后的图像后，使用JVM标准的AWT打印API调用系统打印机：

import java.awt.Graphics2D
import java.awt.print.Printable
import java.awt.print.PrinterException
import java.awt.print.PrinterJob

fun printBill() {
    // 生成账单图像
    val billImage = composeBillToImage {
        // 替换为你的账单Composable
        YourBillComposable()
    }

    val printJob = PrinterJob.getPrinterJob()
    // 设置打印内容处理逻辑
    printJob.setPrintable { graphics, pageFormat, pageIndex ->
        // 单页处理：如果账单有多页，需在此添加分页逻辑
        if (pageIndex > 0) return@setPrintable Printable.NO_SUCH_PAGE

        val g2d = graphics as Graphics2D
        // 计算缩放比例，让账单适配打印页面的可打印区域
        val scale = min(
            pageFormat.imageableWidth / billImage.width.toDouble(),
            pageFormat.imageableHeight / billImage.height.toDouble()
        )
        // 计算居中偏移量
        val xOffset = pageFormat.imageableX + (pageFormat.imageableWidth - billImage.width * scale) / 2
        val yOffset = pageFormat.imageableY + (pageFormat.imageableHeight - billImage.height * scale) / 2

        g2d.translate(xOffset, yOffset)
        g2d.scale(scale, scale)
        g2d.drawImage(billImage, 0, 0, null)

        Printable.PAGE_EXISTS
    }

    // 弹出系统打印对话框，用户确认后执行打印
    if (printJob.printDialog()) {
        try {
            printJob.print()
        } catch (e: PrinterException) {
            // 处理打印异常，可替换为弹窗提示用户
            println("打印失败: ${e.localizedMessage}")
        }
    }
}

关键注意事项 #

• 尺寸适配：提前设置Composable的宽度匹配打印纸张（如A4的96DPI宽度为827px），避免缩放后内容变形
• 多页处理：如果账单内容过长，需在setPrintable中实现分页逻辑，比如按页面高度分割图像，或在渲染时分段生成多页图像
• 线程安全：AWT操作需在EDT（事件调度线程）执行，确保printBill()调用包裹在SwingUtilities.invokeLater中：

  SwingUtilities.invokeLater {
      printBill()
  }
  

• 预览功能：可在打印前将billImage显示在Compose的Image组件中，让用户确认账单内容

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