کاشی‌های فرسوده

اعلام وابستگی‌ها

برای افزودن یک وابستگی به Wear، باید مخزن Google Maven را به پروژه خود اضافه کنید. برای اطلاعات بیشتر، مخزن Google's Maven را مطالعه کنید.

وابستگی‌های مربوط به مصنوعات مورد نیاز خود را در فایل build.gradle برای برنامه یا ماژول خود اضافه کنید:

dependencies {
    // Use to implement support for wear tiles
    implementation "androidx.wear.tiles:tiles:1.5.0"

    // Use to utilize standard components and layouts in your tiles
    implementation "androidx.wear.protolayout:protolayout:1.3.0"

    // Use to utilize components and layouts with Material Design in your tiles
    implementation "androidx.wear.protolayout:protolayout-material:1.3.0"

    // Use to include dynamic expressions in your tiles
    implementation "androidx.wear.protolayout:protolayout-expression:1.3.0"

    // Use to preview wear tiles in your own app
    debugImplementation "androidx.wear.tiles:tiles-renderer:1.5.0"

    // Use to fetch tiles from a tile provider in your tests
    testImplementation "androidx.wear.tiles:tiles-testing:1.5.0"
}

dependencies {
    // Use to implement support for wear tiles
    implementation("androidx.wear.tiles:tiles:1.5.0")

    // Use to utilize standard components and layouts in your tiles
    implementation("androidx.wear.protolayout:protolayout:1.3.0")

    // Use to utilize components and layouts with Material Design in your tiles
    implementation("androidx.wear.protolayout:protolayout-material:1.3.0")

    // Use to include dynamic expressions in your tiles
    implementation("androidx.wear.protolayout:protolayout-expression:1.3.0")

    // Use to preview wear tiles in your own app
    debugImplementation("androidx.wear.tiles:tiles-renderer:1.5.0")

    // Use to fetch tiles from a tile provider in your tests
    testImplementation("androidx.wear.tiles:tiles-testing:1.5.0")
}

dependencies {
    // Use to implement support for wear tiles
    implementation "androidx.wear.tiles:tiles:1.5.0"

    // Use to utilize standard components and layouts in your tiles
    implementation "androidx.wear.protolayout:protolayout:1.3.0"

    // Use to utilize components and layouts with Material Design in your tiles
    implementation "androidx.wear.protolayout:protolayout-material:1.3.0"

    // Use to include dynamic expressions in your tiles
    implementation "androidx.wear.protolayout:protolayout-expression:1.3.0"

    // Use to preview wear tiles in your own app
    debugImplementation "androidx.wear.tiles:tiles-renderer:1.5.0"

    // Use to fetch tiles from a tile provider in your tests
    testImplementation "androidx.wear.tiles:tiles-testing:1.5.0"
}

dependencies {
    // Use to implement support for wear tiles
    implementation("androidx.wear.tiles:tiles:1.5.0")

    // Use to utilize standard components and layouts in your tiles
    implementation("androidx.wear.protolayout:protolayout:1.3.0")

    // Use to utilize components and layouts with Material Design in your tiles
    implementation("androidx.wear.protolayout:protolayout-material:1.3.0")

    // Use to include dynamic expressions in your tiles
    implementation("androidx.wear.protolayout:protolayout-expression:1.3.0")

    // Use to preview wear tiles in your own app
    debugImplementation("androidx.wear.tiles:tiles-renderer:1.5.0")

    // Use to fetch tiles from a tile provider in your tests
    testImplementation("androidx.wear.tiles:tiles-testing:1.5.0")
}

برای اطلاعات بیشتر در مورد وابستگی‌ها، به «افزودن وابستگی‌های ساخت» مراجعه کنید.

بازخورد

بازخورد شما به بهبود Jetpack کمک می‌کند. اگر مشکلات جدیدی کشف کردید یا ایده‌هایی برای بهبود این کتابخانه دارید، به ما اطلاع دهید. لطفاً قبل از ایجاد یک کتابخانه جدید، نگاهی به مشکلات موجود در این کتابخانه بیندازید. می‌توانید با کلیک بر روی دکمه ستاره، رأی خود را به یک مشکل موجود اضافه کنید.

ایجاد یک مسئله جدید

برای اطلاعات بیشتر به مستندات ردیاب مشکل مراجعه کنید.

نسخه ۱.۶

نسخه ۱.۶.۰-آلفا۰۲

۲۲ اکتبر ۲۰۲۵

androidx.wear.tiles:tiles-*:1.6.0-alpha02 منتشر شد. نسخه 1.6.0-alpha02 شامل این کامیت‌ها است.

ویژگی‌های جدید

• پیش‌نمایش‌های کاشی (Tile Previews) اکنون به‌روزرسانی شده‌اند تا از مدیریت خودکار منابع از طریق ProtoLayoutScope پشتیبانی کنند. اگر از منابع تصویر مستقیماً در طرح‌بندی از طریق materialScopeWithScope یا ProtoLayoutScope استفاده شود، دیگر نیازی به مشخص کردن onTileResourcesRequest و منابع به طور خاص در TilePreviewData نیست، آنها به طور خودکار جمع‌آوری می‌شوند. ( I58516 )

رفع اشکالات

• ProtoLayoutScope که به صورت داخلی توسط TileService ایجاد شده است، اکنون شامل VersionInfo مربوط به رندرکننده ProtoLayout است. ( I6eee2 ، b/450259727 )

نسخه ۱.۶.۰-آلفا۰۱

۲۴ سپتامبر ۲۰۲۵

androidx.wear.tiles:tiles-*:1.6.0-alpha01 منتشر شد. نسخه 1.6.0-alpha01 شامل این کامیت‌ها است.

ویژگی‌های جدید

• APIهای ارائه‌دهنده را برای پذیرش PendingIntent به عنوان اقدام کلیک اضافه کنید ( I01978 ، b/433802488 )
• اجازه دهید شناسه کاشی در درخواست به‌روزرسانی مشخص شود. ( Ia05c3 , b/421346031 )
• متدی را در TileRequest اضافه کنید تا شیء ProtoLayoutScope را برای نمونه کاشی مربوطه دریافت کند. ( I5b8de , b/428692428 )

تغییرات API

• اجازه ندهید که onTileResourcesRequest هنگام استفاده از APIهای ProtoLayoutScope نادیده گرفته شود. ( I1773d )

رفع اشکالات

• پیاده‌سازی پشتیبانی از PendingIntent در ProtoTiles را اضافه کنید. ( I38167 ، b/430610429 )
• منابع استفاده شده از ProtoLayoutScope را ذخیره کنید تا به درستی در onTileResourcesRequest برای رندرکننده‌های قدیمی‌تر که آن را در پاسخ Tile قرار نمی‌دهند، ارسال شوند. ( I063a8 ، b/428692502 )
• انتقال minSdk پیش‌فرض از API 21 به API 23 ( Ibdfca ، b/380448311 ، b/435705964 ، b/435705223 )

نسخه ۱.۵

نسخه ۱.۵.۰

۴ ژوئن ۲۰۲۵

androidx.wear.tiles:tiles-*:1.5.0 منتشر شد. نسخه ۱.۵.۰ شامل این کامیت‌ها است.

تغییرات مهم از زمان ۱.۴.۰

• API جدید TileService.onRecentInteractionEvents() برای پردازش رویدادهای کاشی تعامل (ورود / خروج) به صورت دسته‌ای اضافه شد.
  • APIهای موجود در TileService برای onEnterEvent و onLeaveEvent منسوخ شده‌اند و از SDK 36+ برای برنامه‌هایی که API 36 یا بالاتر را هدف قرار می‌دهند، کار نخواهند کرد.
• رفع اشکال بحرانی برای هر کلاینتی که SDK بالاتر از ۳۴ را هدف قرار می‌دهد و درخواست به‌روزرسانی کاشی در API ۳۴ را دارد که باعث ایجاد SecurityException می‌شود.
• با شروع از Wear 6 (SDK سطح ۳۶+)، تمام کاشی‌ها با فونت سیستمی که توسط هر دستگاه تعریف می‌شود، نمایش داده می‌شوند.

نسخه ۱.۵.۰-rc01

۲۰ مه ۲۰۲۵

androidx.wear.tiles:tiles-*:1.5.0-rc01 بدون هیچ تغییری نسبت به نسخه قبلی منتشر شده است. نسخه 1.5.0-rc01 شامل این کامیت‌ها است.

نسخه ۱.۵.۰-بتا۰۲

۷ مه ۲۰۲۵

androidx.wear.tiles:tiles-*:1.5.0-beta02 منتشر شد. نسخه 1.5.0-beta02 شامل این کامیت‌ها است.

نسخه ۱.۵.۰-بتا۰۱

۹ آوریل ۲۰۲۵

androidx.wear.tiles:tiles-*:1.5.0-beta01 منتشر شد. نسخه 1.5.0-beta01 شامل این کامیت‌ها است.

ویژگی‌های جدید

نسخه ۱.۵.۰-بتا۰۱ از Wear Tiles نشان می‌دهد که این نسخه از کتابخانه از نظر امکانات کامل شده و API آن قفل شده است (به جز مواردی که به عنوان آزمایشی علامت‌گذاری شده‌اند). Wear Tiles 1.5 شامل قابلیت‌ها و APIهای جدید زیر است:

• API جدید TileService.onRecentInteractionEvents() برای پردازش رویدادهای کاشی تعامل (ورود / خروج) به صورت دسته‌ای اضافه شد.
  • APIهای موجود در TileService برای onEnterEvent و onLeaveEvent منسوخ شده‌اند و از SDK 36+ برای برنامه‌هایی که API 36 یا بالاتر را هدف قرار می‌دهند، کار نخواهند کرد.
• رفع اشکال بحرانی برای هر کلاینتی که SDK بالاتر از ۳۴ را هدف قرار می‌دهد و درخواست به‌روزرسانی کاشی در API ۳۴ را دارد که باعث ایجاد SecurityException می‌شود.
• با شروع از Wear 6 (SDK سطح ۳۶+)، تمام کاشی‌ها با فونت سیستمی که توسط هر دستگاه تعریف می‌شود، نمایش داده می‌شوند.

نسخه ۱.۵.۰-آلفا۱۰

۱۲ مارس ۲۰۲۵

androidx.wear.tiles:tiles-*:1.5.0-alpha10 منتشر شد. نسخه 1.5.0-alpha10 شامل این کامیت‌ها است.

نسخه ۱.۵.۰-آلفا۰۹

۲۶ فوریه ۲۰۲۵

androidx.wear.tiles:tiles-*:1.5.0-alpha09 منتشر شد. نسخه 1.5.0-alpha09 شامل این کامیت‌ها است.

نسخه ۱.۵.۰-آلفا۰۸

۱۲ فوریه ۲۰۲۵

androidx.wear.tiles:tiles-*:1.5.0-alpha08 منتشر شد. نسخه 1.5.0-alpha08 شامل این کامیت‌ها است.

تغییرات API

• TileService.onRecentInteractionEvents() برای بازگرداندن ListenableFuture<Void> جهت امکان اجرای وظایف طولانی مدت. ( Iaa6c5 )

نسخه ۱.۵.۰-آلفا۰۷

۲۹ ژانویه ۲۰۲۵

androidx.wear.tiles:tiles-*:1.5.0-alpha07 منتشر شد. نسخه 1.5.0-alpha07 شامل این کامیت‌ها است.

نسخه ۱.۵.۰-alpha06

۱۵ ژانویه ۲۰۲۵

androidx.wear.tiles:tiles-*:1.5.0-alpha06 منتشر شد. نسخه 1.5.0-alpha06 شامل این کامیت‌ها است.

تغییرات API

• نام processRecentInteractionEvents به متد onRecentInteractionEvents تغییر یافت. ( Iec3d5 )

نسخه ۱.۵.۰-آلفا۰۵

۱۱ دسامبر ۲۰۲۴

androidx.wear.tiles:tiles-*:1.5.0-alpha05 منتشر شد. نسخه 1.5.0-alpha05 شامل این کامیت‌ها است.

ویژگی‌های جدید

• اضافه کردن api برای TileService جهت پردازش رویدادهای تعاملی به صورت دسته‌ای. ( I04d1b )

رفع اشکالات

• این کتابخانه اکنون از حاشیه‌نویسی‌های nullness از نوع JSpecify استفاده می‌کند که از نوع type-use هستند. توسعه‌دهندگان کاتلین باید از آرگومان کامپایلر زیر برای اعمال استفاده صحیح استفاده کنند: -Xjspecify-annotations=strict (این پیش‌فرض است که از نسخه 2.1.0 کامپایلر کاتلین شروع می‌شود). ( I390e9 ، b/326456246 )
• اشکالی که باعث می‌شد درخواست به‌روزرسانی کاشی‌ها در API 34 وقتی targetSdk برنامه بالاتر از 34 است، باعث ایجاد خطای SecurityException ( If62a1 ) شود، برطرف شد.
• وابستگی به WearSdk در تست‌های Robolectric برطرف شد. ( I37796 )

نسخه ۱.۵.۰-آلفا۰۴

۱۳ نوامبر ۲۰۲۴

androidx.wear.tiles:tiles-*:1.5.0-alpha04 منتشر شد. نسخه 1.5.0-alpha04 شامل این کامیت‌ها است.

نسخه ۱.۵.۰-آلفا۰۳

۳۰ اکتبر ۲۰۲۴

androidx.wear.tiles:tiles-*:1.5.0-alpha03 منتشر شد. نسخه 1.5.0-alpha03 شامل این کامیت‌ها است.

نسخه ۱.۵.۰-آلفا۰۲

۱۶ اکتبر ۲۰۲۴

androidx.wear.tiles:tiles-*:1.5.0-alpha02 منتشر شد. نسخه 1.5.0-alpha02 شامل این کامیت‌ها است.

رفع مشکلات امنیتی

• با اعمال این تغییر ، androidx برای رفع آسیب‌پذیری CVE-2024-7254 ، بر اساس protobuf 4.28.2 کامپایل می‌شود. برای رفع خطر آسیب‌پذیری، وابستگی خود را از نسخه 1.5.0-alpha01 مربوط به androidx.wear.tiles:tiles-proto به 1.5.0-alpha02 ارتقا دهید.

نسخه ۱.۵.۰-آلفا۰۱

۲ اکتبر ۲۰۲۴

androidx.wear.tiles:tiles-*:1.5.0-alpha01 منتشر شد. نسخه 1.5.0-alpha01 شامل این کامیت‌ها است.

نسخه ۱.۴

نسخه ۱.۴.۱

۱۶ اکتبر ۲۰۲۴

androidx.wear.tiles:tiles-*:1.4.1 منتشر شد. نسخه ۱.۴.۱ شامل این کامیت‌ها است.

رفع مشکلات امنیتی

• با اعمال این تغییر ، androidx برای رفع آسیب‌پذیری CVE-2024-7254 ، بر اساس protobuf 4.28.2 کامپایل می‌شود. برای رفع خطر آسیب‌پذیری، وابستگی خود به نسخه ۱.۴.۰ از androidx.wear.tiles:tiles-proto را به ۱.۴.۱ ارتقا دهید.

نسخه ۱.۴.۰

۷ آگوست ۲۰۲۴

androidx.wear.tiles:tiles-*:1.4.0 منتشر شد. نسخه ۱.۴.۰ شامل این کامیت‌ها است.

تغییرات مهم از زمان ۱.۳.۰

• پشتیبانی از ابزار برای تعیین داده‌های پلتفرم سفارشی برای پیش‌نمایش‌های Tiles در اندروید استودیو.

نسخه ۱.۴.۰-rc01

۲۴ ژوئیه ۲۰۲۴

androidx.wear.tiles:tiles-*:1.4.0-rc01 بدون هیچ تغییری نسبت به نسخه قبلی منتشر شده است. نسخه 1.4.0-rc01 شامل این کامیت‌ها است.

نسخه ۱.۴.۰-بتا۰۱

۱۰ ژوئیه ۲۰۲۴

androidx.wear.tiles:tiles-*:1.4.0-beta01 منتشر شد. نسخه 1.4.0-beta01 شامل این کامیت‌ها است.

ویژگی‌های جدید

نسخه ۱.۴.۰-بتا۰۱ از Wear Tiles نشان می‌دهد که این نسخه از کتابخانه از نظر امکانات کامل شده و API آن قفل شده است (به جز مواردی که به عنوان آزمایشی علامت‌گذاری شده‌اند). Wear Tiles 1.4 شامل قابلیت‌ها و APIهای جدید زیر است:

• پشتیبانی از ابزار برای تعیین داده‌های پلتفرم سفارشی برای پیش‌نمایش‌های Tiles در اندروید استودیو.

نسخه ۱.۴.۰-آلفا۰۵

۲۶ ژوئن ۲۰۲۴

androidx.wear.tiles:tiles-*:1.4.0-alpha05 منتشر شد. نسخه 1.4.0-alpha05 شامل این کامیت‌ها است.

نسخه ۱.۴.۰-آلفا۰۴

۲۹ مه ۲۰۲۴

androidx.wear.tiles:tiles-*:1.4.0-alpha04 منتشر شد. نسخه 1.4.0-alpha04 شامل این کامیت‌ها است.

نسخه ۱.۴.۰-آلفا۰۳

۱۴ مه ۲۰۲۴

androidx.wear.tiles:tiles-*:1.4.0-alpha03 منتشر شد. نسخه 1.4.0-alpha03 شامل این کامیت‌ها است.

رفع اشکالات

• TileService#getActiveTilesAsync اکنون از WearSdk API (در صورت وجود) برای ارائه نتیجه دقیق‌تر استفاده می‌کند. ( I57bd8 )

نسخه ۱.۴.۰-آلفا۰۲

۱ مه ۲۰۲۴

androidx.wear.tiles:tiles-*:1.4.0-alpha02 منتشر شد. نسخه 1.4.0-alpha02 شامل این کامیت‌ها است.

تغییرات API

• tileId به عنوان یک فیلد اجباری به پارامتر سازنده Builder منتقل کنید و مقدار پیش‌فرض timestamp را در getter ثبت کنید. ( I98c2b )
• پیام‌های اولیه TileInteractionEvent ، TileEnter و TileLeave و Java Wrapperهای مورد نیاز برای دسته‌بندی رویدادهای ورود/خروج tile را اضافه کنید. ( I112b0 )
• TileRenderer طوری بازسازی کنید که به جای شیء TileRenderer.Config از یک Builder استفاده کند. ( Ib66f9 )
• یک ویژگی platformDataProviders به TileRenderer.Config اضافه کنید ( I6030d )
• یک سازنده جدید به TileRenderer اضافه کنید که از کلاس جدید TileRenderer.Config پشتیبانی کند. سایر سازنده‌ها منسوخ شده‌اند. ( Iae7ff )
• یک فیلد platformDataValues ​​به TilePreviewData اضافه کنید تا امکان لغو مقادیر داده‌های پلتفرم فراهم شود. ( If437a )

رفع اشکالات

• ثابت کنید که مقدار پیش‌فرض برای TileRenderer.Config.Builder#setTilesTheme صفر است. ( Iced18 )

نسخه ۱.۴.۰-آلفا۰۱

۶ مارس ۲۰۲۴

androidx.wear.tiles:tiles-*:1.4.0-alpha01 منتشر شد. نسخه 1.4.0-alpha01 شامل این کامیت‌ها است.

نسخه ۱.۳

نسخه ۱.۳.۰

۷ فوریه ۲۰۲۴

androidx.wear.tiles:tiles-*:1.3.0 منتشر شد. نسخه ۱.۳.۰ شامل این کامیت‌ها است.

تغییرات مهم از زمان ۱.۲.۰

• ابزار پشتیبانی از پیش‌نمایش کاشی‌ها به‌روزرسانی شد.
• پشتیبانی از جستجوی کاشی‌های فعال متعلق به برنامه.

تغییرات اضافی

• برای مشاهده‌ی مجموعه‌ی کامل‌تری از تغییرات معرفی‌شده در نسخه‌ی ۱.۳.۰، به یادداشت‌های انتشار نسخه‌ی بتا ۱ مراجعه کنید.

نسخه ۱.۳.۰-rc01

۲۴ ژانویه ۲۰۲۴

androidx.wear.tiles:tiles-*:1.3.0-rc01 منتشر شد. نسخه 1.3.0-rc01 شامل این کامیت‌ها است.

تغییرات API

• تغییر نام TileService#getActiveTilesSnapshotAsync به getActiveTilesAsync ( اگر6 b87 باشد)

نسخه ۱.۳.۰-بتا۰۱

۱۰ ژانویه ۲۰۲۴

androidx.wear.tiles:tiles-*:1.3.0-beta01 منتشر شد. نسخه 1.3.0-beta01 شامل این کامیت‌ها است.

نسخه ۱.۳.۰-بتا۰۱ از Wear Tiles نشان می‌دهد که این نسخه از کتابخانه از نظر امکانات کامل شده و API آن قفل شده است (به جز مواردی که به عنوان آزمایشی علامت‌گذاری شده‌اند). Wear Tiles 1.3 شامل قابلیت‌ها و APIهای جدید زیر است:

• ماژول ابزار کاشی‌های سایشی برای پشتیبانی از پیش‌نمایش کاشی به‌روزرسانی شده و برای انتشار آماده است.
• پشتیبانی از پرس‌وجو برای اینکه کدام تایل‌های متعلق به برنامه با TileService.getActiveTilesSnapshotAsync فعال هستند.

نسخه ۱.۳.۰-آلفا۰۴

۱۳ دسامبر ۲۰۲۳

androidx.wear.tiles:tiles-*:1.3.0-alpha04 منتشر شد. نسخه 1.3.0-alpha04 شامل این کامیت‌ها است.

نسخه ۱.۳.۰-آلفا۰۳

۲۹ نوامبر ۲۰۲۳

androidx.wear.tiles:tiles-*:1.3.0-alpha03 منتشر شد. نسخه 1.3.0-alpha03 شامل این کامیت‌ها است.

ویژگی‌های جدید

• یک API جدید TileService#getActiveTilesSnapshotAsync برای پرس‌وجو در مورد اینکه کدام کاشی‌های متعلق به برنامه فعال هستند، اضافه شد ( I6850e )

تغییرات API

• تغییر نام @TilePreview به @Preview ( Ifc08a )

نسخه ۱.۳.۰-آلفا۰۲

۱۵ نوامبر ۲۰۲۳

androidx.wear.tiles:tiles-*:1.3.0-alpha02 منتشر شد. نسخه 1.3.0-alpha02 شامل این کامیت‌ها است.

ویژگی‌های جدید

• ما یک API آزمایشی اضافه کرده‌ایم تا به طور خودکار اندازه متن را بر اساس فضایی که درون والد دارد، مقیاس‌بندی کند. ( Ibbe63 )

نسخه ۱.۳.۰-آلفا۰۱

۱۸ اکتبر ۲۰۲۳

androidx.wear.tiles:tiles-*:1.3.0-alpha01 منتشر شد. نسخه 1.3.0-alpha01 شامل این کامیت‌ها است.

ویژگی‌های جدید

• به جای پارامترهای فراخوانی TilePreviewData ، زمینه را به عنوان پارامتر متد پیش‌نمایش ارائه دهید. ( I5e97d )
• ماژول ابزار کاشی‌های سایشی برای پشتیبانی از پیش‌نمایش کاشی به‌روزرسانی شده و برای انتشار آماده است. ( I63d0f )

نسخه ۱.۲

نسخه ۱.۲.۰

۹ آگوست ۲۰۲۳

androidx.wear.tiles:tiles-*:1.2.0 منتشر شد. نسخه ۱.۲.۰ شامل این کامیت‌ها است.

تغییرات مهم از زمان ۱.۱.۰

• نسخه پایدار Wear Tiles 1.2.0 ( ادامه مطلب )
• Tiles 1.2 پشتیبانی از اتصال عناصر طرح‌بندی به داده‌های پلتفرم (برای به‌روزرسانی‌های سریع‌تر) و انیمیشن را اضافه می‌کند. برای دستورالعمل‌های مهاجرت، به یادداشت‌های انتشار برای ( 1.2.0-rc01 ) مراجعه کنید.

نسخه ۱.۲.۰-rc01

۲۶ ژوئیه ۲۰۲۳

androidx.wear.tiles:tiles-*:1.2.0-rc01 منتشر شد. نسخه 1.2.0-rc01 شامل این کامیت‌ها است.

• با انتشار نسخه ۱.۲، کتابخانه Tiles بازسازی شده و اکثر ویژگی‌ها و APIها به کتابخانه جدید ProtoLayout (بسته androidx.wear.protolayout ) منتقل شده‌اند و بخش کوچکی از آن‌ها در Tiles ( androidx.wear.tiles ) باقی مانده است:

  • نام همه کلاس‌ها ثابت مانده است، فقط مواردی به نسخه ۱.۱ اضافه شده است.
  • اکثر APIها ثابت مانده‌اند و تنها تغییر، نام بسته است.
  • برخی از متدهای TileService/TileBuilder منسوخ شده‌اند و اکنون به نسخه‌هایی تغییر نام داده‌اند که انواع جدید ProtoLayout را به جای Tiles منسوخ شده می‌پذیرند.

• برای آسان‌تر کردن این مهاجرت، ما یک دستورالعمل و اسکریپت کوچک گردآوری کرده‌ایم که این تغییر نام را انجام می‌دهد، اینجا را ببینید.

تغییرات API

• ما حداکثر عمقی که یک طرح‌بندی می‌تواند داشته باشد را به 30 عنصر تو در تو در کاشی محدود کرده‌ایم. اگر از این عمق تجاوز شود، رندرکننده کاشی، طرح‌بندی قبلاً فشرده‌شده را نشان می‌دهد. ( I8a74b )

نسخه ۱.۲.۰-بتا۰۱

۲۱ ژوئن ۲۰۲۳

androidx.wear.tiles:tiles-*:1.2.0-beta01 بدون هیچ تغییری منتشر شد. نسخه 1.2.0-beta01 شامل این کامیت‌ها است.

نسخه ۱.۲.۰-آلفا۰۷

۷ ژوئن ۲۰۲۳

androidx.wear.tiles:tiles-*:1.2.0-alpha07 منتشر شد. نسخه 1.2.0-alpha07 شامل این کامیت‌ها است.

ویژگی‌های جدید

• TileRenderer.setState امکان تنظیم وضعیت (state) برای جلسه رندرینگ را فراهم می‌کند. این وضعیت برای طرح‌بندی فعلی و هر طرح‌بندی آینده (تا زمانی که وضعیت جدیدی تنظیم شود) اعمال خواهد شد ( Iaaf35 )
• انواع protolayout اکنون به طور کامل در تمام APIهای tile-renderer پشتیبانی می‌شوند. ( I428b0 )

رفع اشکالات

• تنظیم یک تم سفارشی اکنون در ProtoLayoutViewInstance امکان‌پذیر است. ( Iae8c0 )

نسخه ۱.۲.۰-alpha06

۲۴ مه ۲۰۲۳

androidx.wear.tiles:tiles-*:1.2.0-alpha06 منتشر شد. نسخه 1.2.0-alpha06 شامل این کامیت‌ها است.

تغییرات API

• نام StateEntryValue را به DynamicDataValue تغییر دهید و APIهای state را برای استفاده از DynamicDataKey به‌روزرسانی کنید ( If1c01 ).
• ما تعداد ورودی‌های مجاز در StateStore را محدود می‌کنیم تا اطمینان حاصل شود که میزان استفاده از حافظه و زمان به‌روزرسانی وضعیت برای هر نمونه از StateStore به خوبی کنترل و مهار شده است. در نتیجه، توسعه‌دهنده باید مطمئن شود که بیش از MAX_STATE_ENTRY_COUNT ورودی در نقشه ندارد، در غیر این صورت هنگام ایجاد یا به‌روزرسانی StateStore با خطای IllegalStateException مواجه خواهد شد. ( Ibadb3 )

نسخه ۱.۲.۰-آلفا۰۵

۱۰ مه ۲۰۲۳

androidx.wear.tiles:tiles-*:1.2.0-alpha05 منتشر شد. نسخه 1.2.0-alpha05 شامل این کامیت‌ها است.

ویژگی‌های جدید

• ما شناسه کاشی را به رویدادها و درخواست‌های کاشی اضافه کرده‌ایم. این شناسه می‌تواند برای مرتبط کردن برخی داده‌ها با یک نمونه کاشی در چرخ فلک استفاده شود. ( Ic4f83 )

تغییرات API

• TileRenderer.inflateAsync اکنون یک ListenableFuture برمی‌گرداند. ( I2f2b9 )
• سازندگان کاشی که جایگزینی در کتابخانه protolayout دارند، اکنون به عنوان منسوخ علامت‌گذاری شده‌اند. ( Ie2029 )

رفع اشکالات

• javadoc مربوط به TileService.onTileResourcesRequest اکنون مشخص می‌کند که چه زمانی ممکن است سیستم این متد را فراخوانی کند. ( Iee037 )

نسخه ۱.۲.۰-آلفا۰۴

۱۹ آوریل ۲۰۲۳

androidx.wear.tiles:tiles-*:1.2.0-alpha04 منتشر شد. نسخه 1.2.0-alpha04 شامل این کامیت‌ها است.

رفع اشکالات

• وابستگی‌های gradle اکنون به درستی در صورت لزوم به جای implementation ، روی api تنظیم می‌شوند. ( I40503 )

نسخه ۱.۲.۰-آلفا۰۳

۵ آوریل ۲۰۲۳

androidx.wear.tiles:tiles-*:1.2.0-alpha03 منتشر شد. نسخه 1.2.0-alpha03 شامل این کامیت‌ها است.

تغییرات API

• ما پشتیبانی از انواع androidx.wear.protolayout را به TileRenderer ( I4ac7f ) اضافه کرده‌ایم.
• ObservableStateStore به StateStore تغییر نام داده شده است. ( Ieb0e2 )
• اضافه کردن overload برای انواع protolayout به TileRenderer ( I4ac7f )
• فعال کردن انیمیشن‌ها در TileRenderer ( I07dcf )

نسخه ۱.۲.۰-آلفا۰۲

۲۲ مارس ۲۰۲۳

androidx.wear.tiles:tiles-*:1.2.0-alpha02 منتشر شد. نسخه 1.2.0-alpha02 شامل این کامیت‌ها است.

تغییرات API

• کتابخانه Tiles Material منسوخ شده است. لطفاً از کتابخانه جدید ProtoLayout Material با همان قابلیت‌ها استفاده کنید. ( If242b )

رفع اشکالات

• TileRenderer برای استفاده از ویژگی‌های جدید کتابخانه protolayout به‌روزرسانی شده است. ( I832f9 )

نسخه ۱.۲.۰-آلفا۰۱

۸ مارس ۲۰۲۳

androidx.wear.tiles:tiles-*:1.2.0-alpha01 منتشر شد. نسخه 1.2.0-alpha01 شامل این کامیت‌ها است.

ویژگی‌های جدید

• ما onTileResourceRequest به TileService اضافه کرده‌ایم تا منابع را از کتابخانه protolayout فراهم کند. ( 983d9c5 )
• ما ResourcesRequest و TileRequest برای پشتیبانی از انواع State و DeviceParameters از کتابخانه protolayout به‌روزرسانی کرده‌ایم. ( 88fa01d )
• ما TileBuilders.Tile برای پشتیبانی از انواع State و Timeline از کتابخانه protolayout به‌روزرسانی کرده‌ایم. ( 168619c )

رفع اشکالات

• بهبودهایی در Javadocs. ( I3ed73 )
• رنگ‌های پیش‌فرض برای onPrimary و surface تغییر کرده‌اند. ( I0b039 )

نسخه ۱.۱

نسخه ۱.۱.۰

۲۴ آگوست ۲۰۲۲

androidx.wear.tiles:tiles-*:1.1.0 منتشر شد. نسخه ۱.۱.۰ شامل این کامیت‌ها است.

تغییرات مهم از زمان ۱.۰.۰

• این اولین نسخه پایدار است که شامل کتابخانه Tiles Material می‌شود (برای اطلاعات بیشتر به وبلاگ ما مراجعه کنید).
• این کتابخانه شامل کامپوننت‌ها و طرح‌بندی‌هایی است که با دستورالعمل‌های Material مطابقت دارند و استفاده از آنها آسان است. کامپوننت‌های موجود عبارتند از Button ، Chip ، CompactChip ، TitleChip ، CircularProgressIndicator و Text . همه این کامپوننت‌ها شیء رنگ مخصوص به خود را دارند که می‌توانند با کلاس اصلی Colors ساخته شوند تا به راحتی تم یکسانی را روی همه کامپوننت‌ها اعمال کنند. علاوه بر رنگ‌ها، یک کلاس Typography نیز وجود دارد که به راحتی می‌توان اشیاء FontStyle را با استفاده از نام تایپوگرافی دریافت کرد.
• علاوه بر کامپوننت‌ها، طرح‌بندی‌های کاشی‌وار پیشنهادی نیز وجود دارند - PrimaryLayout ، EdgeContentLayout ، MultiButtonLayout ، MultiSlotLayout . همه طرح‌بندی‌ها دارای padding و استایل‌های پیشنهادی هستند که در دستورالعمل‌های Material اعمال می‌شوند.
• برای فهرستی از اجزا و طرح‌بندی‌های موجود در کتابخانه‌ی Tiles Material، به یادداشت‌های انتشار Tiles مراجعه کنید.

نسخه ۱.۱.۰-rc01

۱۰ آگوست ۲۰۲۲

androidx.wear.tiles:tiles-*:1.1.0-rc01 منتشر شد. نسخه 1.1.0-rc01 شامل این کامیت‌ها است.

• هیچ تغییر جدیدی بین نسخه بتا و RC وجود نداشت.

نسخه ۱.۱.۰-بتا۰۱

۲۷ ژوئیه ۲۰۲۲

androidx.wear.tiles:tiles-*:1.1.0-beta01 منتشر شد. نسخه 1.1.0-beta01 شامل این کامیت‌ها است.

نسخه ۱.۰.۰-بتا۰۱ کتابخانه Tiles Material شامل کامپوننت‌ها و طرح‌بندی‌هایی است که با دستورالعمل‌های Material مطابقت دارند و ساخت آنها آسان است.

اجزای شامل عبارتند از:

• Button - یک شیء دایره‌ای شکل قابل کلیک، با آیکون، متن یا تصویر با ۳ اندازه از پیش تعریف شده.
• Chip - شیء استادیومی شکل و قابل کلیک که می‌تواند شامل یک آیکون، برچسب‌های اولیه و ثانویه باشد و دارای ارتفاع ثابت و عرض قابل تنظیم است.
• CompactChip و TitleChip - دو نوع از Chip استاندارد که به ترتیب ارتفاع کوچکتر و بزرگتری دارند و می‌توانند شامل یک خط متن باشند.
• CircularProgressIndicator - کمان رنگی در اطراف لبه صفحه نمایش با زوایای شروع و پایان داده شده، که می‌تواند یک دایره کامل یا جزئی را با کمان پیشرفت کامل در پشت آن توصیف کند.
• Text - متن سبک‌دار که از سبک‌های تایپوگرافی توصیه‌شده‌ی Wear Material استفاده می‌کند

همه این کامپوننت‌ها شیء رنگ مخصوص به خود را دارند که می‌توان آن را با کلاس اصلی Colors ساخت تا به راحتی تم یکسانی را روی همه کامپوننت‌ها اعمال کرد. علاوه بر رنگ‌ها، یک کلاس Typography نیز وجود دارد که به راحتی می‌توان با استفاده از نام تایپوگرافی، اشیاء FontStyle دریافت کرد.

علاوه بر اجزا، طرح‌بندی‌های پیشنهادی برای کاشی‌ها نیز وجود دارد:

• PrimaryLayout - یک طرح‌بندی که می‌تواند با اضافه کردن برچسب‌های اولیه یا ثانویه، محتوا در وسط و یک تراشه اصلی در پایین، سفارشی‌سازی شود. محتوای اصلی درون این طرح‌بندی می‌تواند به عنوان یک شیء MultiSlotLayout یا MultiButtonLayout اضافه شود.
• EdgeContentLayout - یک طرح‌بندی برای میزبانی CircularProgressIndicator در اطراف لبه با محتوای اصلی در داخل و برچسب اصلی یا فرعی در اطراف آن.
• MultiButtonLayout - چیدمانی که می‌تواند شامل ۱ تا ۷ دکمه باشد که بسته به تعداد آنها، مطابق با دستورالعمل‌های متریال مرتب شده‌اند.
• MultiSlotLayout - یک طرح‌بندی به سبک ردیفی با اسلات‌های افقی تراز شده و فاصله‌دار (برای آیکون‌ها یا سایر محتوای کوچک).

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

تغییرات API

• اصلاح اساسی اجزای Chip که شامل جداسازی تنظیم‌کننده‌ها در Builder می‌شود، به طوری که هر بخش از محتوا به طور جداگانه با تغییر نام برای مطابقت با دستورالعمل‌ها (برچسب اولیه، برچسب ثانویه، شناسه منبع تصویر) ارسال شود. علاوه بر این، در صورت عدم تنظیم، توضیحات محتوا به صورت خودکار تولید می‌شود. ( I57622 )
• ProgressIndicatorLayout به EdgeContentLayout تغییر نام داده است. ( Ic1aa6 )
• محتویات اندازه دکمه به نام‌هایی without _BUTTON تغییر نام داده شده‌اند و توضیحات اضافی Javadocs در مورد Button ارائه شده است ( I1dfe2 ).

رفع اشکالات

• حاشیه‌ها، فاصله‌گذاری و چیدمان کلی در طرح‌بندی‌های متریال به‌روزرسانی شده است تا با انواع طرح‌بندی‌ها و اندازه‌ها و شکل‌های صفحه نمایش توصیه‌شده سازگار باشد.
• بهبودهایی در طرح‌بندی‌های متریال. در MultiSlotLayout ، اسلات‌ها اکنون از نظر عرض انعطاف‌پذیر هستند و به جای اندازه ثابت، محتوا را در بر می‌گیرند. ( I52919 )، ( If18b4 )
• ناحیه‌ای که می‌توان روی CompactChip ضربه زد، برای پیروی از دستورالعمل‌های دسترسی، افزایش یافته است. ( Ie8264 )

نسخه ۱.۱.۰-آلفا۰۹

۲۹ ژوئن ۲۰۲۲

androidx.wear.tiles:tiles-*:1.1.0-alpha09 منتشر شد. نسخه 1.1.0-alpha09 شامل این کامیت‌ها است.

ویژگی‌های جدید

• ما پشتیبانی از افزودن برچسب‌های اختیاری را در ProgressIndicatorLayout اضافه کرده‌ایم. ( I30788 )

تغییرات API

• متدهای کمکی برای ElementMetadata اکنون به جای Modifierها، ElementMetadata می‌پذیرند. ( I5a70f )

رفع اشکالات

• محدودیت ۹ کاراکتر در CompactChip برداشته شد. اگر متن در PrimaryLayout خیلی بزرگ باشد که در صفحه نمایش جا نشود، بیضی‌شکل می‌شود. ( Id56ec )
• گیرنده‌های Chip حالا پسوند محتوا دارند. ( Iba437 )
• شفاف‌سازی Javadoc در کلاس‌های Tiles Material. ( I56e41 )، ( I80f31 )، ( Iba437 )

نسخه ۱.۱.۰-آلفا۰۸

۱ ژوئن ۲۰۲۲

androidx.wear.tiles:tiles-*:1.1.0-alpha08 منتشر شد. نسخه 1.1.0-alpha08 شامل این کامیت‌ها است.

ویژگی‌های جدید

• تگ متادیتا به Modifiers اضافه شده است تا برای ردیابی متادیتای کامپوننت با متدهای کمکی اضافه شده به کلاس Helper استفاده شود. ( I70db2 ) ، ( I30c3d )
• متد استاتیک fromLayoutElement به تمام کامپوننت‌ها و طرح‌بندی‌های داخل Tiles Material اضافه شده است. این متد باید برای آزمایش و تبدیل LayoutElement به‌دست‌آمده از دسترسی به محتویات یک کانتینر به نوع اصلی آن استفاده شود. ( Ia572a ),( Idbd8a ),( I3ae13 ),( I292fe ),( I8b20f ),( I3cacb ),( I84b24 )

نسخه ۱.۱.۰-آلفا۰۷

۱۸ مه ۲۰۲۲

androidx.wear.tiles:tiles-*:1.1.0-alpha07 منتشر شد. نسخه 1.1.0-alpha07 شامل این کامیت‌ها است.

تغییرات API

• اکنون Getterهای مربوط به Setterهای مختلف برای محتوا به ProgressIndicatorLayout و PrimaryLayout اضافه شده‌اند. اکنون همه Setterهای این کلاس‌ها Getterهای منطبق دارند. ( Iddbe5 ) ( Iabe4e )
• تابع Getter برای توصیف محتوا در کامپوننت‌های متریال می‌تواند مقدار null را برگرداند، زیرا مقدار Setter آن اجباری نیست.
• تلاش برای ایجاد یک دکمه بدون ارسال محتوا، منجر به IllegalArgumentException ( I7fc0c ) خواهد شد.
• فیلدهای مربوط به رنگ آیکون در ChipColors از iconTintColor به iconColor تغییر نام داده‌اند. ( Ic053b )

رفع اشکالات

• androidTests برای طرح‌بندی‌ها در Tiles Material اضافه شد. ( I96404 )

نسخه ۱.۱.۰-alpha06

۱۱ مه ۲۰۲۲

androidx.wear.tiles:tiles-*:1.1.0-alpha06 منتشر شد. نسخه 1.1.0-alpha06 شامل این کامیت‌ها است.

ویژگی‌های جدید

• طرح جدید به زیرکتابخانه طرح‌بندی‌های متریال - MultiButtonLayout - اضافه شده است. این طرح‌بندی می‌تواند شامل ۱ تا ۷ دکمه باشد که مطابق با دستورالعمل‌های متریال مرتب شده‌اند. در بیشتر موارد، این طرح‌بندی باید به عنوان یک محتوا به PrimaryLayout ارسال شود. ( Ib727f )

تغییرات API

• MultiSlotLayout طوری بازسازی شده است که فقط اسلات‌ها را در خود داشته باشد. این طرح‌بندی باید به عنوان یک محتوا به PrimaryLayout اصلی ارسال شود. ( I1870f )
• رنگ‌های پیش‌فرض تعریف‌شده برای CircularProgressIndicator به‌روزرسانی شدند تا به جای مقادیر اولیه و ثانویه، یک مقدار داشته باشند. ( I64a51 )
• دریافت‌کننده برای فاصله‌گذار افقی در MultiSlotLayout اضافه شد. ( I11e1e )

رفع اشکالات

• تست‌های اندروید برای کامپوننت‌ها به Tiles Material اضافه شده‌اند. ( I20041 )

نسخه ۱.۱.۰-آلفا۰۵

۶ آوریل ۲۰۲۲

androidx.wear.tiles:tiles-*:1.1.0-alpha05 منتشر شد. نسخه 1.1.0-alpha05 شامل این کامیت‌ها است.

ویژگی‌های جدید

• متدهای کمکی برای تبدیل LayoutElement به Layout، Timeline، TimelineEntry در این کلاس‌ها برای ساخت آسان‌تر Tiles اضافه شده است. ( I2f6d1 )
• شیء Colors به کتابخانه متریال اضافه شد تا به عنوان یک تم، رنگ‌های کامپوننت‌ها را منتقل کند. ( I0792c )

تغییرات API

• کامپوننت متن متریال نیاز به متن ارسالی به سازنده دارد. اکنون می‌توان این کامپوننت را با تنظیم وزن ( I25dbd ) سفارشی‌سازی کرد.
• ثابت‌هایی که در تنظیم‌کننده‌های عمومی استفاده نمی‌شوند از ChipDefaults حذف شدند. ( I7baed )
• گیرنده‌هایی از CompactChip و TitleChip که تنظیم‌کننده‌های منطبق ندارند، حذف شدند. ( I99e85 )
• DEFAULT_PADDING از ProgressIndicatorDefaults حذف شد. ( Idabcd )
• کامپوننت‌های متریال اکنون به جای رشته CharSequence برای توصیف محتوا می‌پذیرند. ( I5b21a )

رفع اشکالات

• پیاده‌سازی تنظیم‌کننده‌های بازسازی‌شده پارامترهای اختیاری در دکمه. ( Ib7135 )
• نوع سبک فونت به فونت‌ها در تایپوگرافی اضافه شده است. ( I8dbc6 )

نسخه ۱.۱.۰-آلفا۰۴

۲۳ مارس ۲۰۲۲

androidx.wear.tiles:tiles-*:1.1.0-alpha04 منتشر شد. نسخه 1.1.0-alpha04 شامل این کامیت‌ها است.

ویژگی‌های جدید

• برچسب اصلی یا فرعی اختیاری را می‌توان به PrimaryLayout اضافه کرد. ( Ib9916 )
• کامپوننت متن را می‌توان با تنظیم overflow، italic، underline و غیره سفارشی کرد ( I703f7 )

تغییرات API

• ثابت‌های رنگ پیش‌فرض از رابط برنامه‌نویسی کاربردی (API) Tiles Material حذف شده‌اند. ( I0ab55 )
• تمام اجزای قابل کلیک در Tiles Material به جای یک Action، به شیء Clickable در سازنده‌ی Builder خود نیاز دارند. ( I2f101 )

رفع اشکالات

• متن اکنون در کامپوننت Chip and Text در سرریز، یک نقطه حذف رسم می‌کند. ( I8a2f8 )
• ظاهر اجزای بهبود یافته زمانی که مقیاس فونت کاربر روی بزرگ تنظیم شده است. ( Ib63b1 )
• کد Javadocs مربوط به setPrimaryChipContent در PrimaryLayout را توضیح دهید. ( Ie6296 )

نسخه ۱.۱.۰-آلفا۰۳

۲۳ فوریه ۲۰۲۲

androidx.wear.tiles:tiles-*:1.1.0-alpha03 منتشر شد. نسخه 1.1.0-alpha03 شامل این کامیت‌ها است.

تغییرات API

• مؤلفه Text با سبک‌های تایپوگرافی توصیه‌شده به متریال TIles اضافه شده است. ( Iec0ae )

نسخه ۱.۱.۰-آلفا۰۲

۹ فوریه ۲۰۲۲

androidx.wear.tiles:tiles-*:1.1.0-alpha02 منتشر شد. نسخه 1.1.0-alpha02 شامل این کامیت‌ها است.

ویژگی‌های جدید

• یک layouts جدید در Tiles Material اضافه شده است. این کتابخانه شامل طرح‌بندی‌های Tiles با تنظیمات دلخواه و حاشیه‌بندی توصیه‌شده است تا توسعه Tile سریع‌تر و پیاده‌سازی آن آسان‌تر شود. طرح‌بندی‌های اولیه عبارتند از:
  • PrimaryLayout ( I7ba91 ) که طرح‌بندی را با یک تراشه اصلی در پایین و محتوا در مرکز نشان می‌دهد.
  • MultiSlotLayout ( I32104 ) که نشان‌دهنده‌ی یک طرح‌بندی با برچسب‌هایی روی ردیف‌های ۱ و ۳، شیارهای هم‌راستا و با فاصله در ردیف ۲ و به دنبال آن ردیف چهارم است که شامل یک تراشه‌ی اصلی است.
  • ProgressIndicatorLayout ( I9fec6 ) که یک طرح‌بندی با نشانگر پیشرفت دایره‌ای در اطراف لبه صفحه و محتوای داده شده در داخل آن را نشان می‌دهد.
• CircularProgressIndicator ( Ic4b88 ) به کامپوننت‌های Tiles Material اضافه شده است.

تغییرات API

• ثابت‌های باقی‌مانده که توسط TitleChip استفاده می‌شدند، تغییر نام دادند تا title در نام گنجانده شود. ( I14f4c )
• متد setHorizontalAlignment به Chip اضافه شده است. ( Ie6e0b )

نسخه ۱.۱.۰-آلفا۰۱

۲۶ ژانویه ۲۰۲۲

androidx.wear.tiles:tiles-*:1.1.0-alpha01 منتشر شد. نسخه 1.1.0-alpha01 شامل این کامیت‌ها است.

ویژگی‌های جدید

• کتابخانه جدید Tiles Material اضافه شده است. این کتابخانه شامل کامپوننت‌هایی برای ساخت سریع‌تر و آسان‌تر طرح‌بندی‌های Tiles با طراحی Material است. کامپوننت‌های اولیه عبارتند از:
  • Button
  • Chip
  • CompactChip
  • TitleChip

رفع اشکالات

• رفع اشکال در TileUiClient که منجر به دور ریختن منابع ذخیره شده در حافظه پنهان می‌شد. ( I60e0b )

نسخه ۱.۰

نسخه ۱.۰.۱

۲۶ ژانویه ۲۰۲۲

androidx.wear.tiles:tiles-*:1.0.1 منتشر شد. نسخه ۱.۰.۱ شامل این کامیت‌ها است.

رفع اشکالات

• رفع اشکال در TileUiClient که منجر به دور ریختن منابع ذخیره شده در حافظه پنهان می‌شد. ( I60e0b )

نسخه ۱.۰.۰

۳ نوامبر ۲۰۲۱

androidx.wear.tiles:tiles-*:1.0.0 منتشر شد. نسخه ۱.۰.۰ شامل این کامیت‌ها است.

ویژگی‌های اصلی نسخه ۱.۰.۰

• کتابخانه Wear Tiles قابلیت ساخت Tileهای سفارشی برای دستگاه‌های Wear OS را فراهم می‌کند، به همراه کلاس‌هایی که به سیستم اجازه می‌دهند Tile شما را دریافت کرده و درست در کنار صفحه ساعت شما نمایش دهد.
• tiles-renderer به شما امکان می‌دهد یک کاشی (Tile) را به عنوان بخشی از یک فعالیت اندروید (Android Activity) نمایش دهید و آزمایش سریع طرح‌بندی‌های کاشی خود را تسهیل کنید.

نسخه ۱.۰.۰-rc01

۲۷ اکتبر ۲۰۲۱

androidx.wear.tiles:tiles-*:1.0.0-rc01 منتشر شد. نسخه 1.0.0-rc01 شامل این کامیت‌ها است.

نسخه ۱.۰.۰-بتا۰۱

۱۳ اکتبر ۲۰۲۱

androidx.wear.tiles:tiles-*:1.0.0-beta01 منتشر شد. نسخه 1.0.0-beta01 شامل این کامیت‌ها است.

رفع اشکالات

• رفع خطای NullPointerException در TileUiClient زمانی که نسخه منبع خالی ارائه می‌شد. ( I0586e )

نسخه ۱.۰.۰-آلفا۱۲

۲۹ سپتامبر ۲۰۲۱

androidx.wear.tiles:tiles-*:1.0.0-alpha12 منتشر شد. نسخه 1.0.0-alpha12 شامل این کامیت‌ها است.

رفع اشکالات

• UpdateScheduler دیگر از یک مرجع ضعیف استفاده نمی‌کند و مشکلاتی را که باعث می‌شد TileUiClient به‌روزرسانی نشود، برطرف می‌کند ( I1120d ، b/199061124 )

• اعلام کنید که SysUiTileUpdateRequester از PacakgeManager پرس‌وجو می‌کند و اشکالی را برطرف می‌کند که در آن به‌روزرسانی‌های کاشی روی دستگاه‌های R+ کار نمی‌کردند. ( I1120d )

نسخه ۱.۰.۰-آلفا۱۱

۱ سپتامبر ۲۰۲۱

androidx.wear.tiles:tiles-*:1.0.0-alpha11 منتشر شد. نسخه 1.0.0-alpha11 شامل این کامیت‌ها است.

ویژگی‌های جدید

• یک کتابخانه تست، androidx.wear.tiles:tiles-testing، اضافه و منتشر شد تا توسعه‌دهندگان بتوانند کاشی‌های خود را راحت‌تر آزمایش کنند. ( Iedb6b )

تغییرات API

• نام TileProviderService به TileService تغییر یافت. ( I1ad2c )
• سازندگان کاشی به‌روزرسانی شدند؛ متدهای استاتیک .builder() به نفع فراخوانی new Foo.Builder() منسوخ شده‌اند، و سربارگذاری‌های setter که یک نمونه Builder را می‌پذیرفتند، حذف شده‌اند. ( Ia9606 )
• TileRenderer اکنون باید به جای زمینه برنامه، از یک زمینه UI استفاده کند. ( I84b61 )

رفع اشکالات

• رفع اشکالی که باعث می‌شد در موقعیت‌های خاص چندین زیرخط اعمال شود. ( Ib6712 )

نسخه ۱.۰.۰-آلفا۱۰

۱۸ آگوست ۲۰۲۱

androidx.wear.tiles:tiles:1.0.0-alpha10 ، androidx.wear.tiles:tiles-proto:1.0.0-alpha10 و androidx.wear.tiles:tiles-renderer:1.0.0-alpha10 منتشر شدند. نسخه 1.0.0-alpha10 شامل این کامیت‌ها است.

تغییرات API

• بررسی‌کننده‌های طرح‌بندی از API عمومی حذف شدند. این بررسی‌کننده‌ها همیشه فعال خواهند بود، اگرچه فقط در صورت عدم موفقیت بررسی، هشدار می‌دهند. ( Ie9f29 )
• TileRenderer اکنون به جای Application Context، یک UI context می‌پذیرد.

رفع اشکالات

• اشکالی که مانع از کلیک شدن عناصر قابل کلیک در Spannable می‌شد، برطرف شد.

نسخه ۱.۰.۰-آلفا۰۹

۲۱ ژوئیه ۲۰۲۱

androidx.wear.tiles:tiles:1.0.0-alpha09 ، androidx.wear.tiles:tiles-proto:1.0.0-alpha09 و androidx.wear.tiles:tiles-renderer:1.0.0-alpha09 منتشر شدند. نسخه 1.0.0-alpha09 شامل این کامیت‌ها است.

ویژگی‌های جدید

• چکرهای طرح‌بندی به رندرکننده‌ی Wear Tiles اضافه شد. ( I3a869 )
  • این موارد برای اعتبارسنجی بهترین شیوه‌ها در کاشی شما استفاده می‌شوند. برای شروع، اگر کاشی شما حاوی هیچ عنصری با اصلاح‌کننده Semantics نباشد، این موارد هشدار می‌دهند.
• مستندات مربوط به سازنده‌های DefaultTileProviderClient و TestingTileProviderClient constructors اضافه شد. ( I9f4b9 )

تغییرات API

• تغییر نام در TileProviderClient ( I0ec36 ):
  • getApiVersion -> requestApiVersion
  • tile/resourcesRequest -> requestTile/Resources
  • onTileFooEvent -> sendOnTileFooEvent
• چکرهای طرح‌بندی به رندرکننده‌ی Wear Tiles اضافه شد. ( I3a869 )

رفع اشکالات

• مطمئن شوید که هدف LaunchAction مجوزهای ویژه ندارد. ( I39136 )

نسخه ۱.۰.۰-آلفا۰۸

۳۰ ژوئن ۲۰۲۱

androidx.wear.tiles:tiles:1.0.0-alpha08 ، androidx.wear.tiles:tiles-proto:1.0.0-alpha08 و androidx.wear.tiles:tiles-renderer:1.0.0-alpha08 منتشر شدند. نسخه 1.0.0-alpha08 شامل این کامیت‌ها است.

ویژگی‌های جدید

• Spannableها اکنون به جای line_spacing از line_height پشتیبانی می‌کنند.

تغییرات API

• پشتیبانی از line_height در Spannables اضافه شد، فاصله بین خطوط حذف شد. ( Ibeb54 )
  • کدی که از line_spacing استفاده می‌کند باید به line_height تبدیل شود.

رفع اشکالات

• رفع اشکال هنگام استفاده از ابعاد متناسب. ( I37ace )
• رفع اشکالی که مانع از نمایش توضیحات محتوا در عناصر متنی می‌شد. ( Id2c7d )

نسخه ۱.۰.۰-آلفا۰۷

۱۶ ژوئن ۲۰۲۱

androidx.wear.tiles:tiles:1.0.0-alpha07 ، androidx.wear.tiles:tiles-proto:1.0.0-alpha07 و androidx.wear.tiles:tiles-renderer:1.0.0-alpha07 منتشر شدند. نسخه 1.0.0-alpha07 شامل این کامیت‌ها است.

تغییرات API

• رابط TileProviderClient اضافه کنید و DefaultTileProviderClient نمایش دهید تا پیاده‌سازی‌ها بتوانند به رابط TileProviderService متصل شوند. ( I69165 )

نسخه ۱.۰.۰-alpha06

۲ ژوئن ۲۰۲۱

androidx.wear.tiles:tiles:1.0.0-alpha06 ، androidx.wear.tiles:tiles-proto:1.0.0-alpha06 و androidx.wear.tiles:tiles-renderer:1.0.0-alpha06 منتشر شدند. نسخه 1.0.0-alpha06 شامل این کامیت‌ها است.

تغییرات API

• اکنون همه کلاس‌های Builder شامل getter برای همه ویژگی‌ها هستند. توجه داشته باشید که این موارد فقط برای اهداف آزمایشی در نظر گرفته شده‌اند ( I9d155 )
• تغییر بسته: کلاس‌های موجود در androidx.wear.tiles.builders به androidx.wear.tiles منتقل شده‌اند.
• پشتیبانی آزمایشی از رنگ‌ها را به Tiles اضافه کنید. ( I38929 )
• تغییر نام LayoutElementBuilders.HALIGN_* به LayoutElementBuilders.HORIZONTAL_ALIGN_* ( I67e58 )
• تغییر نام LayoutElementBuilders.VALIGN_* به LayoutElementBuilders.VERTICAL_ALIGN_* ( I67e58 )
• تغییر نام LayoutElementBuilders.SPAN_VALIGN_* به LayoutElementBuilders.SPAN_VERTICAL_ALIGN_* ( I67e58 )
• کلاس‌های سازنده برای درخواست‌ها و رویدادها اضافه شد. ( Ib5cf4 )
• TileProviderService به گونه‌ای منتقل شده است که از کلاس‌های درخواست و رویداد RequestBuilders و EventBuilders به ​​جای RequestReaders / EventReaders استفاده کند (مثلاً onTileRequest اکنون RequestBuilders.TileRequest را به جای RequestReaders.TileRequest در اختیار شما قرار می‌دهد). ( I46ea1 )

رفع اشکالات

• رفع اشکال در بارگذاری ناهمگام تصویر برای رندرکننده Tiles. ( Iad9b0 )
• اشکال طرح‌بندی هنگام قرار دادن تصویری با عرض یا ارتفاع تنظیم‌شده برای expand() در یک Box با عرض یا ارتفاع تنظیم‌شده برای wrap() برطرف شد. ( I33770 )

نسخه ۱.۰.۰-آلفا۰۵

۱۸ مه ۲۰۲۱

androidx.wear.tiles:tiles:1.0.0-alpha05 ، androidx.wear.tiles:tiles-proto:1.0.0-alpha05 و androidx.wear.tiles:tiles-renderer:1.0.0-alpha05 منتشر شدند. نسخه 1.0.0-alpha05 شامل این کامیت‌ها است.

تغییرات API

• getTileId از رویدادهای کاشی ورودی ( TileAddEvent ، TileRemoveEvent ، TileEnterEvent ، TileLeaveEvent ، TileRequest ) حذف شد. ( Ifbba2 )
• تغییر نام ImageResource#setAndroidResourceByResid به setAndroidResourceByResId ( I4ba6e )
• Renamed TimelineManager#deInit to close, and implemented AutoCloseable . ( I5dff2 )

نسخه ۱.۰.۰-آلفا۰۴

۵ مه ۲۰۲۱

androidx.wear.tiles:tiles:1.0.0-alpha04 , androidx.wear.tiles:tiles-proto:1.0.0-alpha04 , and androidx.wear.tiles:tiles-renderer:1.0.0-alpha04 are released. Version 1.0.0-alpha04 contains these commits.

تغییرات API

• Hidden concrete TileProviderService classes.
  • Made TileUpdateRequester take a Class<? extends TileProviderService> . ( Ib7cca )
• Added ability to add extras to AndroidActivity. ( I748f4 )

Tiles Version 1.0.0-alpha03

۲۱ آوریل ۲۰۲۱

androidx.wear.tiles:tiles:1.0.0-alpha03 , androidx.wear.tiles:tiles-proto:1.0.0-alpha03 , and androidx.wear.tiles:tiles-renderer:1.0.0-alpha03 are released. Version 1.0.0-alpha03 contains these commits.

تغییرات API

• Rename TileManager -> TileClient
  • Rename TileManager#create -> TileClient#connect ( I91839 )

رفع اشکالات

• Added Proguard rules to ensure tiles and tiles-renderer work properly with Proguard enabled ( Ie3d85 )

نسخه ۱.۰.۰-آلفا۰۲

۷ آوریل ۲۰۲۱

androidx.wear.tiles:tiles:1.0.0-alpha02 , androidx.wear.tiles:tiles-proto:1.0.0-alpha02 , and androidx.wear.tiles:tiles-renderer:1.0.0-alpha02 are released. Version 1.0.0-alpha02 contains these commits.

تغییرات API

• androidx.wear:wear-tiles has moved groups, and should now be referred to as androidx.wear.tiles:tiles
• androidx.wear:wear-tiles-renderer has moved groups, and should now be referred to as androidx.wear.tiles:tiles-renderer
• TileRenderer.LoadActionListener now consumes an instance of androidx.wear.tiles.builders.StateBuilders.State rather than androidx.wear.tiles.proto.StateProto.State .
• TileRenderer now accepts Tile resources from androidx.wear.tiles.builders.ResourceBuilders.Resources , rather than an instance of androidx.wear.tiles.renderer.ResourceAccessors .

رفع اشکالات

• Fixed inability to use LoadActionListener , as it exposed an internal class.

نسخه ۱.۰.۰-آلفا۰۱

۱۰ مارس ۲۰۲۱

androidx.wear:wear-tiles:1.0.0-alpha01 , androidx.wear:wear-tiles-proto:1.0.0-alpha01 , and androidx.wear:wear-tiles-renderer:1.0.0-alpha01 are released. Version 1.0.0-alpha01 contains these commits.

ویژگی‌های جدید

• The Wear Tiles Renderer library provides functionality to build custom Tiles for Wear OS devices, along with the classes that allow the system to fetch your Tile and display it right next to your watch face.