如何使用Jetpack Compose Desktop无窗口渲染至图片？

一、直接使用Skija Surface渲染（推荐方案） #

Jetpack Compose Desktop底层基于Skija实现渲染，因此可以完全跳过窗口创建，直接构建Skija Surface并将Compose内容绘制到上面，最后导出为图片文件。这种方案完全适配无GUI的服务器环境。

步骤与代码示例 #

1. 确认依赖包含Skija
   若使用Compose Desktop，通常已默认集成Skija，若需单独引入，在build.gradle.kts中添加：

   dependencies {
       implementation(compose.desktop.currentOs)
       implementation("org.jetbrains.skija:skija-desktop:0.106.0")
   }
   

2. 核心渲染代码

   import androidx.compose.foundation.background
   import androidx.compose.foundation.layout.Box
   import androidx.compose.foundation.layout.fillMaxSize
   import androidx.compose.material.Text
   import androidx.compose.ui.Modifier
   import androidx.compose.ui.graphics.Color
   import androidx.compose.ui.unit.DpSize
   import androidx.compose.ui.unit.dp
   import androidx.compose.ui.window.WindowState
   import org.jetbrains.skija.*
   import java.io.File
   
   fun main() {
       // 定义渲染尺寸
       val width = 200
       val height = 200
       val dpSize = DpSize(width.dp, height.dp)
   
       // 创建Skija光栅Surface
       Surface.makeRasterN32Premul(width, height).use { surface ->
           val canvas = surface.canvas
           // 初始化Compose渲染上下文
           androidx.compose.ui.window.DesktopMaterialTheme {
               androidx.compose.ui.platform.DesktopOwner(
                   windowState = WindowState(size = dpSize),
                   canvas = canvas,
                   size = dpSize
               ).apply {
                   // 设置你的Compose应用内容
                   setContent {
                       Box(modifier = Modifier.fillMaxSize().background(Color.LightGray)) {
                           Text("Hello Compose Render", color = Color.Black)
                       }
                   }
                   // 触发同步渲染
                   draw()
               }
           }
   
           // 将Surface内容导出为PNG文件
           val image = surface.makeImageSnapshot()
           image.encodeToData(EncodedImageFormat.PNG)?.let { data ->
               File("output.png").writeBytes(data.bytes)
           }
           image.close()
       }
   }
   

二、原窗口方案失败的原因 #

你之前的代码得到空白图，核心问题有两个：

• Compose渲染是异步执行的，窗口设置isVisible = true后，Compose不会立即完成绘制，此时调用printAll只能捕获未渲染完成的空白窗口。
• 无GUI服务器环境通常不支持AWT窗口的创建与显示，即使强制创建，也无法正常完成渲染流程。

三、Android单元测试方案的可行性 #

Android测试中的Compose测试规则确实可以实现离线渲染，但存在明显局限性：

• 需要依赖Android测试环境（如Android SDK、Robolectric），在服务器上部署和运行比直接用Compose Desktop+Skija复杂得多。
• 测试规则主要用于单元测试场景，而非生产环境的批量渲染需求，灵活性不如直接操作Skija Surface。

因此，直接使用Skija Surface的方案是无GUI环境下Compose渲染的最优解。

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