بدءًا من Android Studio Studio Koala Feature Drop، يمكنك عرض لقطات من مربّعات تطبيق Wear OS تكون هذه اللوحة مفيدة بشكل خاص إذا كان مظهر المربع التغييرات استجابةً للظروف، مثل المحتوى المختلف بناءً على أو حجم شاشة الجهاز أو حدث رياضي يصل إلى نصف المدة.
![تطابق أسماء المجموعات في لوحة المعاينة مع اسم المجموعة الموضح في
تعليق توضيحي لمعاينة](https://developer.android.com/static/studio/images/design/wear-tiles-preview-panel.png?authuser=5&hl=ar)
إضافة التبعيات
يُرجى تضمين الموارد التابعة التالية في 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() } )