با شروع در Android Studio Koala Feature Drop، می‌توانید عکس‌های فوری کاشی‌های برنامه Wear OS خود را مشاهده کنید. این پانل به ویژه در صورتی مفید است که ظاهر کاشی شما در پاسخ به شرایط تغییر کند، مانند محتوای متفاوت بسته به اندازه نمایشگر دستگاه، یا یک رویداد ورزشی که به نیمه تمام می‌رسد.
وابستگی ها را اضافه کنید
وابستگی های زیر را در فایل build.gradle.kts یا build.gradle برنامه خود قرار دهید:
dependencies {
implementation("androidx.wear.tiles:tiles-tooling-preview:1.4.0-rc01")
debugImplementation("androidx.wear.tiles:tiles-tooling:1.4.0-rc01")
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()
}
)
منابع را اضافه و ثبت کنید
اگر کاشی شما از منابع Android استفاده می کند، باید آنها را در پارامتر onTileResourceRequest TilePreviewData ثبت کنید، همانطور که در قطعه کد زیر نشان داده شده است:
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()
}
)
مقادیر خاصی را از منابع داده پلت فرم نشان دهید
اگر کاشی شما از داده‌های پلتفرم استفاده می‌کند - مانند ضربان قلب، کالری، مسافت و قدم‌ها - کاشی مقادیر پیش‌فرض را برای آنها نشان می‌دهد.
برای نشان دادن یک مقدار خاص، پارامتر platformDataValues را هنگام ایجاد شی TilePreviewData تنظیم کنید، همانطور که در قطعه کد زیر نشان داده شده است:
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()
}
)