Począwszy w pakiecie funkcji Android Studio Koala, możesz wyświetlać zrzuty kafelków z aplikacji na Wear OS. Ten panel jest szczególnie przydatny, gdy wygląd kafelka zmienia się w zależności od warunków takich jak różna treść w zależności od rozmiaru wyświetlacza urządzenia lub gdy zbliża się przerwa rozgrywek sportowych.
Dodaj zależności
W pliku build.gradle.kts
lub build.gradle
aplikacji umieść te zależności:
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")
}
Konfigurowanie podglądu kafelków
Aby zobaczyć podgląd kafelka na różnych ekranach Wear OS o różnych rozmiarach, dodaj adnotację @Preview
i przekaż parametr device
. Pamiętaj, że ta adnotacja @Preview
pochodzi z innego pakietu niż ten, którego używasz na potrzeby podglądu kompozycyjnego.
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()
}
)
Dodawanie i rejestrowanie zasobów
Jeśli Twój kafelek korzysta z zasobów Androida, musisz zarejestrować je w parametrze onTileResourceRequest
TilePreviewData
, jak pokazano w tym fragmencie kodu:
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() } )
Pokaż określone wartości ze źródeł danych platformy
Jeśli kafelek korzysta z danych platformy takich jak tętno, kalorie, dystans czy kroki, pojawiają się w nim wartości domyślne.
Aby wyświetlić konkretną wartość, ustaw parametr platformDataValues
podczas tworzenia obiektu TilePreviewData
, jak w tym fragmencie kodu:
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() } )