远程撰写

Remote Compose 是一个用于为远程 surface 创建界面的框架

最近更新时间	稳定版	候选版	Beta 版	Alpha 版
2026 年 3 月 11 日	-	-	-	1.0.0-alpha06

声明依赖项

如需添加 compose-remote 的依赖项，您必须将 Google Maven 制品库添加到项目中。如需了解详情，请参阅 Google 的 Maven 代码库。

在应用或模块的 build.gradle 文件中添加所需工件的依赖项：

Groovy

dependencies {
    implementation "androidx.compose.remote:remote-core:1.0.0-alpha06"

    // Use to create Remote Compose documents
    implementation "androidx.compose.remote:remote-creation:1.0.0-alpha06"
    implementation "androidx.compose.remote:remote-creation-core:1.0.0-alpha06"
    implementation "androidx.compose.remote:remote-creation-android:1.0.0-alpha06"
    implementation "androidx.compose.remote:remote-creation-jvm:1.0.0-alpha06"
    implementation "androidx.compose.remote:remote-creation-compose:1.0.0-alpha06"

    // Use to render a Remote Compose document
    implementation "androidx.compose.remote:remote-player-core:1.0.0-alpha06"
    implementation "androidx.compose.remote:remote-player-view:1.0.0-alpha06"

    implementation "androidx.compose.remote:remote-tooling-preview:1.0.0-alpha06"
}

Kotlin

dependencies {
    implementation("androidx.compose.remote:remote-core:1.0.0-alpha06")

    // Use to create Remote Compose documents
    implementation("androidx.compose.remote:remote-creation:1.0.0-alpha06")
    implementation("androidx.compose.remote:remote-creation-core:1.0.0-alpha06")
    implementation("androidx.compose.remote:remote-creation-android:1.0.0-alpha06")
    implementation("androidx.compose.remote:remote-creation-jvm:1.0.0-alpha06")
    implementation("androidx.compose.remote:remote-creation-compose:1.0.0-alpha06")

    // Use to render a Remote Compose document
    implementation("androidx.compose.remote:remote-player-core:1.0.0-alpha06")
    implementation("androidx.compose.remote:remote-player-view:1.0.0-alpha06")

    implementation("androidx.compose.remote:remote-tooling-preview:1.0.0-alpha06")
}

如需详细了解依赖项，请参阅添加 build 依赖项。

反馈

您的反馈将帮助我们改进 Jetpack。如果您发现了新问题，或对此库有任何改进建议，请告诉我们。创建新问题前，请先查看此库中的现有问题。您可以点击星标按钮，为现有问题投票。

创建新问题

如需了解详情，请参阅问题跟踪器文档。

版本 1.0

版本 1.0.0-alpha06

2026 年 3 月 11 日

发布了 androidx.compose.remote:remote-*:1.0.0-alpha06。版本 1.0.0-alpha06 中包含这些提交内容。

新功能

为 TextStyle 添加了新的实验性操作。TextStyle 可让常用排版样式只需写入文档一次，即可供多个文本运行 (bfc6487) 重复使用

API 变更

公开 RemoteTextStyle 合并（I971ce、b/446824085）
将 RemotePainter 公开为公共 API（I252c1、b/446824085）
公开了 Border/Clip 修饰符和 RemoteShape。（Id26dd、b/446824085）
在 remote-creation-compose 中公开了 RemoteColor API（I4ab00、b/446824085）
公开了 RemoteText API (I6b019)
公开了 RemoteImage API (Ided31)
公开了 RemoteBoolean、RemoteString 和 RemoteFloat API (Id9ee6)
来自 WidthIn 注解的远程可组合项 (I80784)

bug 修复

将库移至使用 Java 11 目标平台。这意味着生成的字节码将是 Java 11（类文件版本 55），可能需要进行 desugaring 才能使用该库（If4c2a、b/457821470）
- 确保长度和 textlookup 正确更新。之前，RemoteStrings 的长度会在第一帧上计算，之后不会更新 (e49cb53)
- 支持具有较大分数分量的数字的 TextFromFloat。之前，较大的“digitsAfter”值可能会导致浮点数评估为 0 (5080bc54)

版本 1.0.0-alpha05

2026 年 2 月 25 日

发布了 androidx.compose.remote:remote-*:1.0.0-alpha05。版本 1.0.0-alpha05 中包含这些提交内容。

新功能

推出了 fillParentMaxWidth 和 fillParentMaxHeight。(4c6d77c)

API 变更

公开了常见的远程可组合项和修饰符类型 (Id1d40)
公开了 RemoteState 的类型（I22429、b/465453482）

bug 修复

修复了滚动问题 (0a25299)
修复了触控容差问题 (0192b69)
在渲染过程中更早地设置密度，以便在第一帧（通常在屏幕截图测试中捕获）上正确应用密度 (f775399)

版本 1.0.0-alpha04

2026 年 2 月 11 日

发布了 androidx.compose.remote:remote-*:1.0.0-alpha04。版本 1.0.0-alpha04 中包含这些提交内容。

新功能

默认使用 RemoteApplier 启用，这样可以防止在创建远程界面时使用非远程可组合函数。您可以通过更改 RemoteComposeCreationComposeFlags 中的 isRemoteApplierEnabled 来停用此功能。(67a405f)
为位图字体添加字形间距 (0852657)
在 RemoteCanvas 中旋转（使用透视）（9a292b3）
添加了 RemoteSpacer (12beb72)
避免 java.time 依赖项，从而将创建库的 minSdk 降至 23 (59e30d0)
FlowLayout (7efef02)

bug 修复

修复了非全局 ColorExpression 和计算出的字符串的评估。(c08d0bd)

外部贡献

androidx.compose.ui.graphics.NativePaint 类型别名已废弃，请直接使用 android.graphics.Paint（I6303c、b/477394763）
将 Paint.asFrameworkPaint() 替换为 Paint.nativePaint 扩展，以避免通过 typealias 将平台类型暴露到 commonMain sourceset 中（I6303c、b/477394763）

版本 1.0.0-alpha03

2026 年 1 月 28 日

发布了 androidx.compose.remote:remote-*:1.0.0-alpha03。版本 1.0.0-alpha03 中包含这些提交内容。

新功能

支持 BorderModifier 0afd343 中不同的形状和 RemoteColors
添加 CombinedAction 以支持点击事件的多个操作 10e16a2

API 变更

迁移了 RemoteColor 和 RemoteBitmap 的 API，以使用 Compose 类型，而不是直接公开 Android 类型 a9bfbb8
引入 RemoteDensity 类型，以确定是在播放器上评估密度（当为远程设备生成文档时），还是内联表达式（以优化同一设备上的文档大小）54352bb
RemoteState constantValueOrNull 重命名（I6ad5c、b/467050397）

版本 1.0.0-alpha02

2026 年 1 月 14 日

发布了 androidx.compose.remote:remote-*:1.0.0-alpha02。版本 1.0.0-alpha02 中包含这些提交内容。

新功能

为 CoreText 添加了最小/最大字号。I7bd3c

API 变更

为 Glance Wear 基础架构公开了最少的公共 API。（I7b4b9、b/467532762）
从 captureSingleRemoteDocument 返回 CapturedDocument（I5a283、b/467532762）

bug 修复

修复了重新布局后的滚动位置问题，并添加了对边缘效果的支持 (6d4551)

版本 1.0.0-alpha01

2025 年 12 月 17 日

发布了 androidx.compose.remote:remote-*:1.0.0-alpha01。版本 1.0.0-alpha01 中包含这些提交内容。

Remote Compose 是一个用于为远程 surface 创建界面的框架。