Wear 远程 Compose Material 3

  
使用 Material 3 Expressive 设计系统为 Wear OS 编写 widget 和其他远程界面。
最近更新时间 稳定版 候选版 Beta 版 Alpha 版
2026 年 9 月 23 日 - - - 1.0.0-alpha12

声明依赖项

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

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

Groovy

dependencies {
    implementation "androidx.wear.compose.remote:remote-material3:1.0.0-alpha12"
}

Kotlin

dependencies {
    implementation("androidx.wear.compose.remote:remote-material3:1.0.0-alpha12")
}

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

反馈

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

创建新问题

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

1.0 版

版本 1.0.0-alpha12

2026 年 9 月 23 日

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

API 变更

  • 添加了 ImageVector.toRemoteImageVector() 和 RemoteImageVector.vectorResource(@DrawableRes id: Int)，用于将 Compose 界面 ImageVector 和可绘制矢量资源转换为 RemoteImageVector。(Ia8383)
  • 在 Wear Material 3 远程 Compose 中将 RemoteSplitSwitchButton、RemoteSplitSwitchButtonDefaults 和 RemoteSplitSwitchButtonColors 作为公共 API 进行公开。(Ic9b7f)
  • 在 Wear Material 3 远程 Compose 中将 RemoteSplitRadioButton、RemoteSplitRadioButtonDefaults 和 RemoteSplitRadioButtonColors 作为公共 API 进行公开。(I4d0c2)
  • 在 Wear Material 3 远程 Compose 中将 RemoteSplitCheckboxButton、RemoteSplitCheckboxButtonDefaults 和 RemoteSplitCheckboxButtonColors 作为公共 API 进行公开。(Iffdef)
  • 在 Wear Material 3 远程 Compose 中将 RemoteSwitchButton、RemoteSwitchButtonDefaults 和 RemoteSwitchButtonColors 作为公共 API 进行公开。(I0155b)
  • 在 Wear Material 3 远程 Compose 中将 RemoteRadioButton、RemoteRadioButtonDefaults 和 RemoteRadioButtonColors 作为公共 API 进行公开。(I513ce)
  • 在 Wear Material 3 远程 Compose 中将 RemoteCheckboxButton、RemoteCheckboxButtonDefaults 和 RemoteCheckboxButtonColors 作为公共 API 进行公开。(If5c8a)
  • 在 Wear Material 3 Remote Compose 中向 RemoteIconButtonDefaults 添加了 filledIconButtonColors、filledTonalIconButtonColors、filledVariantIconButtonColors 和 outlinedIconButtonColors，并将 iconButtonColors 和 textButtonColors 参数默认值更新为 null。(Ib0b0e)
  • 在 Wear Material 3 远程 Compose 中为 RemoteCard 和 RemoteTitleCard 添加了 containerPainter 支持。(I4f1bc)

bug 修复

  • 修复了长标签上 RemoteEdgeButton 文本溢出按钮弧形的问题。(I2eb3d)

版本 1.0.0-alpha11

2026 年 9 月 9 日

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

API 变更

  • 向 wear:compose:remote:remote-material3 添加了 RemoteEdgeButton 组件。(I017a6)
  • 将不确定的 RemoteCircularProgressIndicator 和 RemoteProgressIndicatorDefaults.IndeterminateStrokeWidth 作为公共 API。(I937fc)
  • 将 RemoteTimeText 和 RemoteTimeTextDefaults 设为公共 API。(I83809)
  • 添加了 RemoteLinearProgressIndicator 组件。(I828f3)
  • 添加了 RemoteModifier.defaultMinSize。(If86a5)
  • 为 RemoteCurvedProgressIndicator 添加了片头和片尾动画。(I68012)
  • 更新了 RemoteCircularProgressIndicator，使其默认值为 RemoteProgressIndicatorDefaults.DefaultStrokeWidth (12.rdp)，并公开了 largeStrokeWidth(screenSize) 和 smallStrokeWidth(screenSize)。(I1f16e)

bug 修复

  • compileSdk 针对已更新到 37.1 的 Compose 库。 这需要为使用 Compose 的所有应用和库传递性地更新 compileSdk。(I05b0f)

版本 1.0.0-alpha10

2026 年 8 月 26 日

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

API 变更

  • 在 RemoteTextStyle、RemoteText 和 RemoteTimeText 中添加了 fontFeatureSettings 和 fontVariationSettings 支持。（I6e78d、b/544644370）
  • 将基本远程 Compose widget（RemoteBasicText、RemoteBasicImage、RemoteSpacer、RemoteBasicIcon）迁移到了新的 remote-foundation 库。（I259b2、b/532028292）
  • 在 RemoteTextStyle 中添加了对 fontVariationSettings 的支持。（I2c44a、b/542047368）
  • 向 Wear Remote Compose Material 3 库添加了 RemoteCurvedProgressIndicator 组件。（I975cf、b/530084464）

bug 修复

版本 1.0.0-alpha09

2026 年 8 月 12 日

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

API 变更

版本 1.0.0-alpha08

2026 年 7 月 29 日

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

API 变更

  • 在 RemoteTextStyle 中公开了 LineBreak 策略和连字频率（I7f2e6、b/510078059）

版本 1.0.0-alpha07

2026 年 7 月 1 日

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

bug 修复

  • 一个更新后的版本，在同一提交中依赖于 androidx.compose.remote，以避免二进制不兼容

版本 1.0.0-alpha06

2026 年 6 月 17 日

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

API 变更

  • 更新了 containerPainter 方法，现在采用 RemoteImageBitmap（I68a92、b/494562308）
  • 将 RemoteBitmap 重命名为 RemoteImageBitmap，以提高命名一致性。（I4fde1、b/513228889）
  • 公开了 captureRemoteDocument Flow API 和新的 captureSingleRemoteDocument 重载（采用 RemoteCreationDisplayInfo）作为公共 API。（I87b0e、b/513228889）
  • 将现有的 ValueChange 工厂函数重命名为小写 valueChange。（I812b9、b/513228889）

版本 1.0.0-alpha05

2026 年 6 月 3 日

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

bug 修复

  • 修复了 RemoteTypography 构造函数。(bf0c0b2)

版本 1.0.0-alpha04

2026 年 5 月 19 日

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

API 变更

版本 1.0.0-alpha03

2026 年 5 月 6 日

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

API 变更

  • 将修饰符 clickable 更改为不接受操作参数的 null 值。应改用 Action.Empty。（I21be9、b/498881738）
  • 修饰符 clickable(varargs action) 已更改为 clickable(action)。使用 CombinedAction 表示一系列操作。（I8432d、b/498881738）

版本 1.0.0-alpha02

2026 年 4 月 8 日

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

API 变更

其他更改

  • 将 Compose compileSdk 更新为 API 37。这意味着，使用 Compose 时，最低 AGP 版本为 9.2.0。（Id45cd、b/413674743）

版本 1.0.0-alpha01

2026 年 3 月 25 日

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

API 变更