معاينة مربّعات Wear OS في "استوديو Android"

بدءًا من Android Studio Studio Koala Feature Drop، يمكنك عرض لقطات من مربّعات تطبيق Wear OS تكون هذه اللوحة مفيدة بشكل خاص إذا كان مظهر المربع التغييرات استجابةً للظروف، مثل المحتوى المختلف بناءً على أو حجم شاشة الجهاز أو حدث رياضي يصل إلى نصف المدة.

تطابق أسماء المجموعات في لوحة المعاينة مع اسم المجموعة الموضح في تعليق توضيحي لمعاينة
لوحة معاينة "شاشات المعلومات" في "استوديو Android"

إضافة التبعيات

يُرجى تضمين الموارد التابعة التالية في 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()
    }
)