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

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

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

يُرجى تضمين الاعتماديات التالية في ملف build.gradle.kts أو build.gradle الخاص بتطبيقك:

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")
}

ضبط معاينات المربّعات

للاطّلاع على معاينة شكل ظهور مربّعك على أحجام شاشة العرض المختلفة لنظام التشغيل 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()
    }
)