在 Android Studio 中预览 Wear OS 功能块

从 Android Studio Koala Feature Drop 开始，您可以查看 Wear OS 应用功能块的快照。如果功能块的外观会随条件而发生变化，例如根据设备的显示屏大小显示不同的内容，或者体育赛事将至一半时间，此面板会特别有用。

Android Studio 中的功能块预览面板。

添加依赖项

在应用的 build.gradle.kts 或 build.gradle 文件中添加以下依赖项：

dependencies {
    implementation("androidx.wear.tiles:tiles-tooling-preview:1.4.0-beta01")
    debugImplementation("androidx.wear.tiles:tiles-tooling:1.4.0-beta01")
    implementation("androidx.wear:wear-tooling-preview:1.0.0")
}

配置功能块预览

如需预览功能块在不同 Wear OS 显示尺寸下的外观，请添加 @Preview 注解并传入 device 参数。请注意，此 @Preview 注解来自与用于可组合项预览的软件包不同的软件包。

import androidx.wear.tiles.tooling.preview.Preview

@Preview(device = WearDevices.SMALL_ROUND)
@Preview(device = WearDevices.LARGE_ROUND)
fun tilePreview(context: Context) = TilePreviewData(
    onTileRequest = { request ->
        TilePreviewHelper.singleTimelineEntryTileBuilder(
            buildMyTileLayout()
        ).build()
    }
)

注意： 虽然 @Preview 注解特定于 Wear OS 功能块，但其他选项（如 device、name、group、fontScale 和 locale）对 Wear OS 功能块预览的工作方式与使用 Compose on Wear OS 的组件的预览相同。

添加并注册资源

如果您的功能块使用 Android 资源，您需要在 TilePreviewData 的 onTileResourceRequest 参数中注册这些资源，如以下代码段所示：

import androidx.wear.tiles.tooling.preview.Preview

@Preview(device = WearDevices.SMALL_ROUND)
fun previewWithResources(context: Context) = TilePreviewData(
    onTileResourceRequest = { request ->
        ProtoResources.Builder()
            .setVersion(myResourcesVersion)
            .addIdToImageMapping(
                    myImageId, getImageById(R.drawable.myDrawableImageId))
            .build()
    },
    onTileRequest = { request ->
        TilePreviewHelper.singleTimelineEntryTileBuilder(
            buildMyTileLayout()
        ).build()
    }
)

显示来自平台数据源的特定值

如果您的功能块使用平台数据（例如心率、卡路里、距离和步数），该功能块会显示这些数据的默认值。

如需显示特定值，请在创建 TilePreviewData 对象时设置 platformDataValues 参数，如以下代码段所示：

import androidx.wear.tiles.tooling.preview.Preview

@Preview(device = WearDevices.SMALL_ROUND)
fun previewWithPlatformOverride(context: Context) = TilePreviewData(
    platformDataValues = PlatformDataValues.of(
        PlatformHealthSources.Keys.HEART_RATE_BPM,
        DynamicDataBuilders.DynamicDataValue.fromFloat(160f)
    ),
    onTileRequest = { request ->
        TilePreviewHelper.singleTimelineEntryTileBuilder(
            buildMyTileLayout()
        ).build()
    }
)