Wear Watch Face Push

  
借助 Watch Face Push，Wear OS 应用可以以编程方式在手表上安装表盘主题。
最近更新时间 稳定版 候选版 Beta 版 Alpha 版
2026 年 3 月 25 日 - 1.0.0-rc02 - -

声明依赖项

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

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

Groovy

repositories {
    google() // For the watchfacepush library itself
}
dependencies {
    implementation "androidx.wear.watchfacepush:watchfacepush:1.0.0-rc02"
}

Kotlin

repositories {
    google() // For the watchfacepush library itself
}

dependencies {
    implementation("androidx.wear.watchfacepush:watchfacepush:1.0.0-rc02")
}
此外，如果应用需要在运行时为表盘生成令牌，请添加以下依赖项：

Groovy

repositories {
    google() // For the validator-push library itself
    maven {
        url "https://jitpack.io" // For dependencies of the validator-push library
        content {
            includeGroup "com.github.xgouchet"
        }
    }
}

dependencies {
    implementation "com.google.android.wearable.watchface.validator:validator-push:1.0.0-alpha10"
}

Kotlin

repositories {
    google() // For the validator-push library itself
    maven {
        url = uri("https://jitpack.io") // For dependencies of the validator-push library
        content {
            includeGroup("com.github.xgouchet")
        }
    }
}

dependencies {
    implementation("com.google.android.wearable.watchface.validator:validator-push:1.0.0-alpha10")
}

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

反馈

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

创建新问题

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

版本 1.0

版本 1.0.0-rc02

2026 年 3 月 25 日

发布了 androidx.wear.watchfacepush:watchfacepush:1.0.0-rc02。版本 1.0.0-rc02 中包含 这些提交内容。

  • 更新了 Guava 依赖项版本，以解决安全漏洞 CVE-2023-2976。

版本 1.0.0-rc01

2026 年 3 月 11 日

发布了 androidx.wear.watchfacepush:watchfacepush:1.0.0-rc01，该版本与上一个 Beta 版相比没有变化。版本 1.0.0-rc01 中包含 这些提交内容。

版本 1.0.0-beta01

2025 年 12 月 3 日

发布了 androidx.wear.watchfacepush:watchfacepush:1.0.0-beta01。版本 1.0.0-beta01 中包含 这些提交内容。

API 变更

  • 将 watchfacepush minSdk 降至 33。引入了 isSupported 方法，用于检查设备是否支持该功能，对于 sdk<36（Wear OS 6 / Android 16），该方法会返回 false。这样，客户端就可以将 minSdk 设置得更低，并在支持的情况下有条件地使用 watchfacepush。(I0e8c0, b/438149344)

版本 1.0.0-alpha01

2025 年 6 月 18 日

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

API 变更

  • 添加了 Watch Face Push API，该 API 允许 Wear OS 应用以编程方式在手表上安装表盘。
  • 该 API 之前以 :wear:watchface:watchface-push 的形式发布