پیش نمایش کاشی های Wear OS در Android Studio

با شروع در Android Studio Koala Feature Drop، می‌توانید عکس‌های فوری کاشی‌های برنامه Wear OS خود را مشاهده کنید. این پانل به ویژه در صورتی مفید است که ظاهر کاشی شما در پاسخ به شرایط تغییر کند، مانند محتوای متفاوت بسته به اندازه نمایشگر دستگاه، یا یک رویداد ورزشی که به نیمه تمام می‌رسد.

نام گروه‌ها در پانل پیش‌نمایش با نام گروه داده‌شده در صفحه مطابقت دارد     پیش نمایش حاشیه نویسی
پنل پیش نمایش کاشی ها در اندروید استودیو.

وابستگی ها را اضافه کنید

وابستگی های زیر را در فایل build.gradle.kts یا build.gradle برنامه خود قرار دهید:

dependencies {
    implementation("androidx.wear.tiles:tiles-tooling-preview:1.5.0-alpha04")
    debugImplementation("androidx.wear.tiles:tiles-tooling:1.5.0-alpha04")
    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()
    }
)