如何在Android Studio中预览Wear OS各类Complication？

针对你使用的Android Studio Ladybug 2024.2.2版本，目前有两种可靠的方式在IDE内预览不同类型的Complication：

1. 使用@ComplicationPreview注解（Jetpack Compose Complication） #

如果你用Jetpack Compose开发Complication，直接用官方提供的@ComplicationPreview注解就能快速预览不同类型效果，无需依赖模拟器：

• 确保项目依赖了兼容版本的Wear Compose库（至少wear-compose-material 1.3.0+）
• 在Complication实现代码旁添加预览函数，示例代码：

import androidx.wear.compose.material.ComplicationPreview
import androidx.wear.compose.material.ComplicationType
import androidx.wear.watchface.complications.data.*

@ComplicationPreview(ComplicationType.SHORT_TEXT)
@ComplicationPreview(ComplicationType.LONG_TEXT)
@ComplicationPreview(ComplicationType.RANGED_VALUE)
@Composable
fun PreviewMyComplications() {
    MyComplication(
        complicationData = when (localComplicationType.current) {
            ComplicationType.SHORT_TEXT -> ShortTextComplicationData(
                text = PlainComplicationText(text = "短文本示例"),
                contentDescription = PlainComplicationText(text = "短文本Complication")
            )
            ComplicationType.LONG_TEXT -> LongTextComplicationData(
                text = PlainComplicationText(text = "这是一段长文本Complication示例内容"),
                contentDescription = PlainComplicationText(text = "长文本Complication")
            )
            ComplicationType.RANGED_VALUE -> RangedValueComplicationData(
                value = 75f,
                minValue = 0f,
                maxValue = 100f,
                title = PlainComplicationText(text = "进度"),
                contentDescription = PlainComplicationText(text = "进度条Complication")
            )
            else -> null
        }
    )
}

• 写完代码后，Android Studio的预览面板会自动加载不同类型的Complication效果，可切换查看每种样式。

2. 使用Complication Preview工具（传统View-based Complication） #

如果你的Complication基于传统View实现，可通过IDE内置工具预览：

• 打开继承ComplicationProviderService的服务类
• 在代码编辑区右上角点击"Preview"按钮（与Compose预览按钮位置一致）
• 在弹出的预览窗口中，选择不同的Complication类型、表盘样式（圆形/方形等），IDE会实时渲染预览效果。

注意事项 #

• 确保项目已正确配置Wear OS依赖及Complication相关权限（如com.google.android.wearable.permission.RECEIVE_COMPLICATION_DATA）
• 若预览面板未显示，尝试同步Gradle项目或点击预览面板的刷新按钮重启预览服务

内容的提问来源于stack exchange，提问作者B. Kaan