با شروع در Android Studio Koala Feature Drop، میتوانید عکسهای فوری کاشیهای برنامه Wear OS خود را مشاهده کنید. این پانل به ویژه در صورتی مفید است که ظاهر کاشی شما در پاسخ به شرایط تغییر کند، مانند محتوای متفاوت بسته به اندازه نمایشگر دستگاه، یا یک رویداد ورزشی که به نیمه تمام میرسد.
![نام گروه ها در پانل پیش نمایش با نام گروه ارائه شده در حاشیه نویسی پیش نمایش مطابقت دارد](https://developer.android.com/static/studio/images/design/wear-tiles-preview-panel.png?authuser=2&hl=fa)
وابستگی ها را اضافه کنید
وابستگی های زیر را در فایل build.gradle.kts
یا build.gradle
برنامه خود قرار دهید:
dependencies {
implementation("androidx.wear.tiles:tiles-tooling-preview:1.4.0")
debugImplementation("androidx.wear.tiles:tiles-tooling:1.4.0")
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 -> Resources.Builder() .setVersion(myResourcesVersion) .addIdToImageMapping( myImageId, getImageById(R.drawable.myDrawableImageId)) .build() }, onTileRequest = { request -> TilePreviewHelper.singleTimelineEntryTileBuilder( buildMyTileLayout() ).build() } ) fun getImageById( @DrawableRes id: Int, ): ImageResource = ImageResource.Builder() .setAndroidResourceByResId( AndroidImageResourceByResId.Builder() .setResourceId(id) .build(), ) .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() } )