远程 Compose

  
Remote Compose 是一个用于为远程 surface 创建界面的框架
最近更新时间 稳定版 候选版 Beta 版 Alpha 版
2026 年 4 月 22 日 - - - 1.0.0-alpha09

声明依赖项

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

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

Groovy

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

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

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

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

Kotlin

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

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

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

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

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

反馈

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

创建新问题

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

版本 1.0

版本 1.0.0-alpha09

2026 年 4 月 22 日

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

API 变更

  • 修饰符 clickable 已更改为不接受 action 参数的 null 值。应改用 Action.Empty。(I21be9、b/498881738)
  • 内边距修饰符参数已从 left/right 更改为 start/end。(Id781c、b/500760020)
  • 修饰符 onTouchDown(varargs action) 和 onTouchUp(varargs action) 已更改为 onTouchDown/onTouchUp(action)。对于操作列表，请使用 CombinedAction。(I8af9d、b/498881738)
  • 修饰符 clickable(varargs action) 已更改为 clickable(action)。对于操作列表，请使用 CombinedAction。(I8432d、b/498881738)

bug 修复

  • 修复了 MatrixExpression.write (Id3c52)

版本 1.0.0-alpha08

2026 年 4 月 8 日

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

新功能

  • 将 CoreText、TextStyle、TextTransform 和 ColorTheme 操作提升为基准 AndroidX 和 Widget 配置文件 (I69671、b/494482597)
    • CoreText 提供了更丰富的功能来呈现文本，包括自适应文本大小调整，以及对文本布局功能（如换行和溢出行为）的改进控制。
    • TextStyle 允许在文档中捕获一次常见的文本样式属性，并由多个文本运行引用。
    • TextTransform 支持文本转换，例如将文本转换为大写。
  • 当布局方向为从右到左 (RTL) 且不使用绝对水平排列时，水平布局中项的反向呈现。(I2d38e)

API 变更

  • 首选 toRemoteString(DecimalFormat) 作为开发者 API。(Ia4925、b/493924433)
  • 移除了修饰符 clip(shape, size)。应改用修饰符 clip(shape)。(I76301)

bug 修复

  • 更新了 TextLookup 以跟踪数组元素更改。这样可确保在表达式在数组中查找的元素发生更改时，系统会重新评估表达式 (I162c7)

版本 1.0.0-alpha07

2026 年 3 月 25 日

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

新功能

  • 实现了非线性字体缩放 (73b23c0)
  • 使布局能够识别 LayoutDirection (81f984b)

API 变更

版本 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 源集 (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 变更

bug 修复

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

版本 1.0.0-alpha01

2025 年 12 月 17 日

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

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