لوحات للارتداء

إنشاء تطبيقات لساعات "Wear OS من Google" الذكية
التعديل الأخير الإصدار المستقر إصدار مرشح الإصدار التجريبي إصدار ألفا
6 آذار (مارس) 2024 1.3.0 - - 1.4.0-alpha01

إعلان التبعيات

لإضافة تبعية إلى Wear، يجب إضافة مستودع Google Maven إلى مشروعك. لمزيد من المعلومات، يمكنك الاطّلاع على مستودع Maven من Google.

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

رائع

dependencies {
    // Use to implement support for wear tiles
    implementation "androidx.wear.tiles:tiles:1.4.0-alpha01"

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

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

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

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

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

Kotlin

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

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

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

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

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

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

لمزيد من المعلومات حول التبعيات، انظر إضافة تبعيات الإصدار.

ملاحظات

تساعدنا ملاحظاتك في تحسين Jetpack. يُرجى إخبارنا إذا اكتشفت مشاكل جديدة أو كانت لديك أفكار لتحسين هذه المكتبة. يُرجى الاطّلاع على المشاكل الحالية في هذه المكتبة قبل إنشاء مشكلة جديدة. يمكنك إضافة تصويتك إلى مشكلة حالية من خلال النقر على زر النجمة.

إنشاء عدد جديد

راجِع مستندات أداة تتبُّع المشاكل للحصول على مزيد من المعلومات.

الإصدار 1.4

الإصدار 1.4.0-alpha01

6 آذار (مارس) 2024

تم طرح "androidx.wear.tiles:tiles-*:1.4.0-alpha01". يحتوي الإصدار 1.4.0-alpha01 على هذه الالتزامات.

الإصدار 1.3

الإصدار 1.3.0

7 شباط (فبراير) 2024

تم طرح "androidx.wear.tiles:tiles-*:1.3.0". يتضمّن الإصدار 1.3.0 هذه الالتزامات.

التغييرات المهمة منذ الإصدار 1.2.0

  • أدوات محدَّثة لإتاحة معاينة المربّعات
  • إتاحة طلبات البحث عن المربّعات النشطة الخاصة بالتطبيق

تغييرات إضافية

الإصدار 1.3.0-rc01

24 كانون الثاني (يناير) 2024

تم طرح "androidx.wear.tiles:tiles-*:1.3.0-rc01". يتضمّن الإصدار 1.3.0-rc01 هذه الالتزامات.

تغييرات واجهة برمجة التطبيقات

  • تمت إعادة تسمية "TileService#getActiveTilesSnapshotAsync" إلى "getActiveTilesAsync". (If6b87)

الإصدار 1.3.0-beta01

10 كانون الثاني (يناير) 2024

تم طرح "androidx.wear.tiles:tiles-*:1.3.0-beta01". يتضمّن الإصدار 1.3.0-beta01 هذه الالتزامات.

يشير الإصدار 1.3.0 إلى الإصدار التجريبي 01 من Wear Tiles إلى اكتمال الميزات في هذا الإصدار من المكتبة وأنّ واجهة برمجة التطبيقات مقفلة (باستثناء الحالات التي تم وضع علامة عليها على أنّها تجريبية). يتضمّن الإصدار Wear Tiles 1.3 الوظائف الجديدة وواجهات برمجة التطبيقات التالية:

  • تم تعديل وحدة أداة استخدام مربّعات Wear OS لإتاحة إمكانية معاينة المربّعات، وتم إعدادها للنشر.
  • إتاحة طلب البحث عن مربّعات التطبيق النشطة في TileService.getActiveTilesSnapshotAsync

الإصدار 1.3.0-alpha04

13 كانون الأول (ديسمبر) 2023

تم طرح "androidx.wear.tiles:tiles-*:1.3.0-alpha04". يحتوي الإصدار 1.3.0-alpha04 على هذه الالتزامات.

الإصدار 1.3.0-alpha03

29 تشرين الثاني (نوفمبر) 2023

تم طرح "androidx.wear.tiles:tiles-*:1.3.0-alpha03". يتضمّن الإصدار 1.3.0-alpha03 هذه الالتزامات.

الميزات الجديدة

  • تمت إضافة TileService#getActiveTilesSnapshotAsync واجهة برمجة تطبيقات جديدة للبحث عن مربّعات التطبيق النشطة. (I6850e)

تغييرات واجهة برمجة التطبيقات

  • إعادة تسمية @TilePreview إلى @Preview (Ifc08a)

الإصدار 1.3.0-alpha02

15 تشرين الثاني (نوفمبر) 2023

تم طرح "androidx.wear.tiles:tiles-*:1.3.0-alpha02". يحتوي الإصدار 1.3.0-alpha02 على هذه الالتزامات.

الميزات الجديدة

  • أضفنا واجهة برمجة تطبيقات تجريبية لتغيير حجم النص تلقائيًا بناءً على المساحة الموجودة داخل العنصر الرئيسي. (Ibbe63)

الإصدار 1.3.0-alpha01

18 تشرين الأول (أكتوبر) 2023

تم طرح "androidx.wear.tiles:tiles-*:1.3.0-alpha01". يحتوي الإصدار 1.3.0-alpha01 على هذه الالتزامات.

الميزات الجديدة

  • يُرجى تقديم السياق كمَعلمة لطريقة المعاينة بدلاً من مَعلمات TilePreviewData لمعاودة الاتصال. (I5e97d)
  • تم تعديل وحدة أداة استخدام مربّعات Wear OS لإتاحة إمكانية معاينة المربّعات، وتم إعدادها للنشر. (I63d0f)

الإصدار 1.2

الإصدار 1.2.0

9 آب (أغسطس) 2023

تم طرح "androidx.wear.tiles:tiles-*:1.2.0". يتضمّن الإصدار 1.2.0 هذه الالتزامات.

التغييرات المهمة منذ الإصدار 1.1.0

  • الإصدار الثابت من Wear Tiles 1.2.0 (قراءة المزيد)
  • يضيف تطبيق Tiles 1.2 دعمًا لربط عناصر التصميم إلى بيانات النظام الأساسي (للحصول على تحديثات أسرع) والصور المتحركة. للحصول على تعليمات حول نقل البيانات، يُرجى الاطّلاع على ملاحظات إصدار (1.2.0-rc01)

الإصدار 1.2.0-rc01

26 تموز (يوليو) 2023

تم طرح "androidx.wear.tiles:tiles-*:1.2.0-rc01". يحتوي الإصدار 1.2.0-rc01 على هذه الالتزامات.

  • في الإصدار 1.2، أُعيد إنشاء مكتبة Tiles، وتم نقل معظم الميزات وواجهات برمجة التطبيقات إلى مكتبة ProtoLayout الجديدة (الحزمة androidx.wear.protolayout) مع بقاء مجموعة فرعية صغيرة في Tiles (androidx.wear.tiles):

    • لم تتغيّر أسماء الفئات، وما مِن إضافات جديدة سوى للإصدار 1.1.
    • بقيت غالبية واجهات برمجة التطبيقات كما هي والتغيير الوحيد هو اسم الحزمة.
    • تم إيقاف بعض الطرق في TileService/TileBuilder نهائيًا، وتمت إعادة تسمية النُسخ التي تقبل أنواع ProtoLayout الجديدة بدلاً من تلك التي تم إيقافها نهائيًا.
  • لتسهيل عملية النقل هذه، جمعنا تعليمات صغيرة ونصًا برمجيًا يؤدي إلى إعادة التسمية. ويمكنك الاطّلاع على هذه الصفحة.

تغييرات واجهة برمجة التطبيقات

  • لقد حددنا الحد الأقصى للعمق الذي يمكن أن يحتوي عليه التخطيط إلى 30 عنصرًا مدمجًا في تجانب. وفي حال تجاوز هذا العمق، سيعرض عارض المربّعات تنسيقًا سبق تكبيره. (I8a74b)

الإصدار 1.2.0-beta01

‫21 حزيران (يونيو) 2023

تم إصدار "androidx.wear.tiles:tiles-*:1.2.0-beta01" بدون أي تغييرات. يحتوي الإصدار 1.2.0 -beta01 على هذه الالتزامات.

الإصدار 1.2.0-alpha07

7 حزيران (يونيو) 2023

تم طرح "androidx.wear.tiles:tiles-*:1.2.0-alpha07". يحتوي الإصدار 1.2.0-alpha07 على هذه الالتزامات.

الميزات الجديدة

  • تسمح السياسة TileRenderer.setState بضبط حالة جلسة العرض. سيتم تطبيق هذه الحالة على التنسيق الحالي وأي تنسيق مستقبلي (إلى أن يتم ضبط حالة جديدة) (Iaaf35)
  • أصبحت أنواع التخطيط الأوّلي متاحة الآن بالكامل عبر جميع واجهات برمجة تطبيقات عارض الإطارات. (I428b0)

إصلاح الأخطاء

  • يمكن الآن ضبط مظهر مخصّص في ProtoLayoutViewInstance. (Iae8c0)

الإصدار 1.2.0-alpha06

24 أيار (مايو) 2023

تم طرح "androidx.wear.tiles:tiles-*:1.2.0-alpha06". يتضمّن الإصدار 1.2.0-alpha06 هذه الالتزامات.

تغييرات واجهة برمجة التطبيقات

  • إعادة تسمية StateEntryValue إلى DynamicDataValue وتعديل واجهات برمجة التطبيقات للحالة لاستخدام DynamicDataKey (If1c01)
  • نفرض حدًا أقصى على عدد الإدخالات المسموح بها في StateStore لضمان احتواء كل مثيل من StateStore على وقت تحديث الحالة والتحكم فيه بشكل جيد. ونتيجة لذلك، على المطوّر التأكّد من عدم تضمين أكثر من MAX_STATE_ENTRY_COUNT إدخال في الخريطة وإلا سيحصل على IllegalStateException عند إنشاء StateStore أو تعديلها. (Ibadb3)

الإصدار 1.2.0-alpha05

10 أيار (مايو) 2023

تم طرح "androidx.wear.tiles:tiles-*:1.2.0-alpha05". يحتوي الإصدار 1.2.0-alpha05 على هذه الالتزامات.

الميزات الجديدة

  • لقد أضفنا رقم تعريف المربّع إلى أحداث وطلبات المربّعات. يمكن استخدام هذا المعرّف لربط بعض البيانات بمثيل مربّع في لوحة العرض الدوّارة. (Ic4f83)

تغييرات واجهة برمجة التطبيقات

  • تعرض "TileRenderer.inflateAsync" الآن رسالة "ListenableFuture". (I2f2b9)
  • تم الآن وضع علامة على أدوات إنشاء المربّعات التي لديها بديل في مكتبة protolayout بأنّها متوقّفة نهائيًا. (Ie2029)

إصلاح الأخطاء

  • يوضِّح الآن مستند javadoc لـ TileService.onTileResourcesRequest متى قد يستدعي النظام الطريقة. (Iee037)

الإصدار 1.2.0-alpha04

19 نيسان (أبريل) 2023

تم طرح "androidx.wear.tiles:tiles-*:1.2.0-alpha04". يحتوي الإصدار 1.2.0-alpha04 على هذه الالتزامات.

إصلاح الأخطاء

  • تم الآن ضبط تبعيات Gradle بشكلٍ صحيح على api بدلاً من implementation عند الحاجة. (I40503)

الإصدار 1.2.0-alpha03

5 نيسان (أبريل) 2023

تم طرح "androidx.wear.tiles:tiles-*:1.2.0-alpha03". يحتوي الإصدار 1.2.0-alpha03 على هذه الالتزامات.

تغييرات واجهة برمجة التطبيقات

  • أضفنا دعمًا لنوعَين (androidx.wear.protolayout) إلى TileRenderer (I4ac7f).
  • تمت إعادة تسمية ObservableStateStore إلى StateStore. (Ieb0e2)
  • إضافة أحمال زائدة لأنواع تنسيق النموذج الأوّلي إلى TileRenderer (I4ac7f)
  • تفعيل الرسوم المتحركة في TileRenderer (I07dcf)

الإصدار 1.2.0-alpha02

22 آذار (مارس) 2023

تم طرح "androidx.wear.tiles:tiles-*:1.2.0-alpha02". يحتوي الإصدار 1.2.0-alpha02 على هذه الالتزامات.

تغييرات واجهة برمجة التطبيقات

  • تم إيقاف مكتبة مواد الشاشات نهائيًا. يُرجى استخدام مكتبة ProtoLayout Material الجديدة التي تتضمّن الوظائف نفسها. (If242b)

إصلاح الأخطاء

  • تم تحديث TileRenderer لاستخدام ميزات جديدة من مكتبة التنسيق الأوّلي. (I832f9)

الإصدار 1.2.0-alpha01

8 آذار (مارس) 2023

تم طرح "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)

إصلاح الأخطاء

  • تحسينات على مستندات JavaScript. (I3ed73)
  • تم تغيير الألوان التلقائية لـ onPrimary والسطح. (I0b039)

الإصدار 1.1

الإصدار 1.1.0

24 آب (أغسطس) 2022

تم طرح "androidx.wear.tiles:tiles-*:1.1.0". يتضمّن الإصدار 1.1.0 هذه الالتزامات.

التغييرات المهمة منذ الإصدار 1.0.0

  • هذا هو أول إصدار ثابت يحتوي على مكتبة Tiles Material (مزيد من المعلومات على مدونتنا).
  • تحتوي هذه المكتبة على مكونات وتخطيطات تتوافق مع إرشادات Material وسهلة الاستخدام. المكوّنات المضمَّنة هي Button وChip وCompactChip وTitleChip وCircularProgressIndicator وText.وتحتوي كل هذه المكوّنات على عناصر ألوان خاصة بها يمكن إنشاؤها باستخدام فئة الألوان الرئيسية لتطبيق المظهر نفسه على جميع المكوّنات بسهولة. بالإضافة إلى الألوان، هناك فئة أسلوب الخط للحصول بسهولة على كائنات FontStyle باستخدام اسم أسلوب الخط.
  • بالإضافة إلى المكوّنات، هناك تنسيقات تجانب مقترَحة - PrimaryLayout وEdgeContentLayout وMultiButtonLayout وMultiSlotLayout. تحتوي جميع التخطيطات على مساحة متروكة وأنماط موصى بها تم تطبيقها بما يتوافق مع إرشادات Material.
  • للحصول على قائمة بالمكوّنات والتنسيقات في مكتبة Tiles Material، يُرجى الاطّلاع على ملاحظات إصدار المربّعات.

الإصدار 1.1.0-rc01

10 آب (أغسطس) 2022

تم طرح "androidx.wear.tiles:tiles-*:1.1.0-rc01". يحتوي الإصدار 1.1.0-rc01 على هذه الالتزامات.

  • لم يتم إجراء أي تغييرات جديدة بين الإصدار التجريبي والإصدار RC.

الإصدار 1.1.0-beta01

27 تموز (يوليو) 2022

تم طرح "androidx.wear.tiles:tiles-*:1.1.0-beta01". يتضمّن الإصدار 1.1.0-beta01 هذه الالتزامات.

يحتوي الإصدار 1.0.0-beta01 من مكتبة Tiles Material على مكونات وتخطيطات تتوافق مع إرشادات Material ويسهل إنشاؤها.

المكوّنات المضمنة هي:

  • Button - عنصر دائري الشكل قابل للنقر عليه، مع رمز أو نص أو صورة بثلاثة أحجام محدّدة مسبقًا.
  • Chip - عنصر قابل للنقر على شكل استاد ويمكن أن يحتوي على رمز وتصنيفات أساسية وثانوية وله ارتفاع ثابت وعرض قابل للتخصيص.
  • CompactChip وTitleChip - نوعان مختلفان من الشريحة العادية ذات ارتفاعات أصغر وأكبر، على التوالي، ويمكن أن تحتوي على سطر واحد من النص.
  • CircularProgressIndicator - قوس ملوّن حول حافة الشاشة مع زوايا البدء والنهاية المحددة، ويمكن وصف دائرة كاملة أو جزئية خلفها قوس التقدم الكامل.
  • Text - نص بنمط يستخدم أنماط الطباعة المقترحة على Wear Material

تتضمّن كل هذه المكوّنات عناصر ألوان خاصة بها يمكن إنشاؤها باستخدام الفئة Colors الرئيسية لتطبيق المظهر نفسه على جميع المكوّنات بسهولة. بالإضافة إلى الألوان، هناك فئة Typography للحصول بسهولة على عناصر FontStyle باستخدام اسم أسلوب الخط.

بالإضافة إلى المكونات، هناك تخطيطات موصى بها للمربعات:

  • PrimaryLayout - تنسيق يمكن تخصيصه عن طريق إضافة تصنيفات أساسية أو ثانوية ومحتوى في المنتصف وشريحة أساسية في الأسفل. يمكن إضافة المحتوى الرئيسي في هذا التنسيق كعنصر MultiSlotLayout أو MultiButtonLayout.
  • EdgeContentLayout - تنسيق لاستضافة CircularProgressIndicator على الحافة مع وجود محتوى رئيسي بداخله وتصنيف أساسي أو ثانوي حوله.
  • MultiButtonLayout: تصميم يمكن أن يتضمّن من زر واحد إلى 7 أزرار، ويتم ترتيبه وفقًا لإرشادات "المواد" حسب عدد هذه الأزرار.
  • MultiSlotLayout - تنسيق نمط يشبه الصفوف مع خانات تمت محاذاتها أفقيًا ومتباعدة (للرموز أو المحتوى الصغير الآخر).

تحتوي جميع التخطيطات على مساحة متروكة وأنماط موصى بها تم تطبيقها بما يتوافق مع إرشادات Material.

تغييرات واجهة برمجة التطبيقات

  • إعادة الهيكلة الرئيسية لمكوّنات "الشريحة" التي تتضمّن عناصر الإعداد في "أداة الإنشاء" بحيث يتم تمرير كل جزء من المحتوى بشكل منفصل مع إعادة التسمية للتوافق مع الإرشادات (التصنيف الأساسي أو التصنيف الثانوي أو معرّف مورد الصورة) بالإضافة إلى ذلك، سيتم إنشاء وصف المحتوى تلقائيًا إذا لم يتم ضبطه. (I57622)
  • تمت إعادة تسمية ProgressIndicatorLayout إلى EdgeContentLayout. (Ic1aa6)
  • تمت إعادة تسمية محتوى حجم الزر إلى لاحقة "without _BUTTON" فيها، مع توضيح إضافي لـ Javadocs في Button. (I1dfe2)

إصلاح الأخطاء

  • تم تحديث الهوامش والمساحة المتروكة والترتيب العام في تخطيطات المواد لتلائم جميع أنواع التخطيطات وأحجام الشاشات وأشكالها الموصى بها.
  • تحسينات على تنسيقات Materials في MultiSlotLayout، تتوفّر الآن خانات مرنة في العرض، حيث يتم لف المحتوى بدلاً من أن تكون بحجم ثابت.(I52919)،(If18b4)
  • تمت زيادة المساحة التي يمكن النقر عليها في CompactChip لاتّباع إرشادات تسهيل الاستخدام. (Ie8264)

الإصدار 1.1.0-alpha09

29 حزيران (يونيو) 2022

تم طرح "androidx.wear.tiles:tiles-*:1.1.0-alpha09". يتضمّن الإصدار 1.1.0-alpha09 هذه الالتزامات.

الميزات الجديدة

  • لقد وفّرنا إمكانية إضافة تصنيفات اختيارية في ProgressIndicatorLayout. (I30788)

تغييرات واجهة برمجة التطبيقات

  • تقبل الآن طرق المساعدة لـ ElementMetadata استخدام ElementMetadata بدلاً من المعدِّلات. (I5a70f)

إصلاح الأخطاء

  • تمت إزالة الحد الأقصى البالغ 9 أحرف على CompactChip. إذا كان النص كبيرًا جدًا بحيث لا يمكن عرضه على الشاشة في PrimaryLayout، سيتم تصغيره. (Id56ec)
  • تحتوي الرسائل في Chip الآن على لاحقة المحتوى. (Iba437)
  • توضيح JavaDoc عبر فئات مواد Tiles. (I56e41)، (I80f31)، (Iba437)

الإصدار 1.1.0-alpha08

1 حزيران (يونيو) 2022

تم طرح "androidx.wear.tiles:tiles-*:1.1.0-alpha08". يحتوي الإصدار 1.1.0-alpha08 على هذه الالتزامات.

الميزات الجديدة

  • تمت إضافة علامة البيانات الوصفية إلى المعدِّلات لاستخدامها في تتبّع البيانات الوصفية للمكوِّن مع إضافة طرق المساعدة إلى الفئة Helper. (I70db2)،(I30c3d)
  • تمت إضافة الطريقة الثابتة fromLayoutElement إلى جميع المكوّنات والتصميمات داخل "مادة الشاشات". وينبغي استخدامه للاختبار، لتحويل عنصر تخطيط تم الحصول عليه من الوصول إلى محتويات الحاوية إلى نوعها الأصلي. (Ia572a),(Idbd8a),(I3ae13),(I292fe),(I8b20f),(I3cacb),(I84b24)

الإصدار 1.1.0-alpha07

18 أيار (مايو) 2022

تم طرح "androidx.wear.tiles:tiles-*:1.1.0-alpha07". يحتوي الإصدار 1.1.0-alpha07 على هذه الالتزامات.

تغييرات واجهة برمجة التطبيقات

  • تمّت الآن إضافة أدوات الحصول على معلومات مرتبطة بمجموعات مختلفة من المحتوى إلى ProgressIndicatorLayout وPrimaryLayout. جميع الأسماء في هذه الفئات لها نتائج مطابِقة.(Iddbe5) (Iabe4e)
  • يمكن أن تعرض Getter لوصف المحتوى في Material Components قيمة فارغة نظرًا لأن دالة setter الخاصة بها ليست إلزامية.
  • وستؤدي محاولة إنشاء زر بدون تمرير أي محتوى إلى IllegalArgumentException. (I7fc0c)
  • تمت إعادة تسمية الحقول ذات الصلة بألوان الرمز في ChipColors من iconTintColor إلى iconColor. (Ic053b)

إصلاح الأخطاء

  • تمت إضافة androidTests للتصاميم في مواد البلاط. (I96404)

الإصدار 1.1.0-alpha06

11 أيار (مايو) 2022

تم طرح "androidx.wear.tiles:tiles-*:1.1.0-alpha06". يحتوي الإصدار 1.1.0-alpha06 على هذه الالتزامات.

الميزات الجديدة

  • تمت إضافة التنسيق الجديد إلى المكتبة الفرعية "تنسيقات المواد" MultiButtonLayout. وهو يمثل تخطيطًا يمكن أن يحتوي على ما بين 1 و7 أزرار مرتبة بما يتماشى مع إرشادات Material. وفي معظم الحالات، يجب تمرير هذا التنسيق كمحتوى إلى PrimaryLayout. (Ib727f)

تغييرات واجهة برمجة التطبيقات

  • تمت إعادة هيكلة ميزة "MultiSlotLayout" لتتضمّن خانات فقط. يجب إرسال هذا التنسيق كمحتوى إلى PrimaryLayout الرئيسية. (I1870f)
  • تم تعديل الألوان التلقائية المحدّدة للسمة CircularProgressIndicator لتصبح قيمة واحدة بدلاً من الألوان الأساسية والثانوية. (I64a51)
  • تمت إضافة دالة getter للفاصل الأفقي في MultiSlotLayout. (I11e1e)

إصلاح الأخطاء

  • تمت إضافة اختبارات Android الخاصة بالمكونات إلى "مواد الشاشات". (I20041)

الإصدار 1.1.0-alpha05

6 نيسان (أبريل) 2022

تم طرح "androidx.wear.tiles:tiles-*:1.1.0-alpha05". يحتوي الإصدار 1.1.0-alpha05 على هذه الالتزامات.

الميزات الجديدة

  • تمت إضافة طرق مساعد لتحويل "LayoutElement" إلى "التنسيق" و"المخطط الزمني" و"مدخل المخطط الزمني" إلى هذه الصفوف لتسهيل إنشاء "المربّعات". (I2f6d1)
  • تمت إضافة العنصر Colors إلى مكتبة Material ليتم تمريره على مستوى ألوان المكونات كمظهر. (I0792c)

تغييرات واجهة برمجة التطبيقات

  • يتطلب مكون Material Text إدخال النص إلى الدالة الإنشائية. يمكن الآن تخصيص هذا المكوِّن عن طريق ضبط الترجيح. (I25dbd)
  • تمت إزالة الثوابت من ChipDefaults التي لا تُستخدم في المقاييس العامة. (I7baed)
  • تمت إزالة رموز جسّمية لا تحتوي على قيم مطابِقة من CompactChip وTitleChip. (I99e85)
  • تمت إزالة "DEFAULT_PADDING" من ProgressIndicatorDefaults. (Idabcd)
  • تتيح مكونات Material الآن استخدام CharSequence لوصف المحتوى بدلاً من "سلسلة". (I5b21a)

إصلاح الأخطاء

  • تنفيذ معلمات اختيارية في Button لتنفيذ معلمات اختيارية (Ib7135)
  • تمت إضافة متغير نمط الخط إلى الخطوط في أسلوب الخط. (I8dbc6)

الإصدار 1.1.0-alpha04

23 آذار (مارس) 2022

تم طرح "androidx.wear.tiles:tiles-*:1.1.0-alpha04". يحتوي الإصدار 1.1.0-alpha04 على هذه الالتزامات.

الميزات الجديدة

  • يمكن إضافة تصنيف أساسي أو ثانوي اختياري إلى PrimaryLayout. (Ib9916)
  • يمكن تخصيص المكوِّن النصي من خلال ضبط تجاوز السعة أو المائل أو تسطير النص وما إلى ذلك (I703f7).

تغييرات واجهة برمجة التطبيقات

  • تمت إزالة ثوابت اللون التلقائية من Tiles Material API. (I0ab55)
  • تتطلّب جميع العناصر القابلة للنقر في ميزة Tiles Material عنصر "Clickable" في الدالة الإنشائية لـ "أداة الإنشاء" بدلاً من "الإجراء". (I2f101)

إصلاح الأخطاء

  • سيرسم النص الآن علامة حذف عند تجاوز السعة في الشريحة ومكون النص. (I8a2f8)
  • تظهر المكونات المحسّنة عند ضبط مقياس خط المستخدم على "كبير". (Ib63b1)
  • توضيح مستندات Java لـ setPrimaryChipContent في PrimaryLayout. (Ie6296)

الإصدار 1.1.0-alpha03

23 شباط (فبراير) 2022

تم طرح "androidx.wear.tiles:tiles-*:1.1.0-alpha03". يتضمّن الإصدار 1.1.0-alpha03 هذه الالتزامات.

تغييرات واجهة برمجة التطبيقات

  • تمت إضافة المكوِّن Text بأنماط أسلوب الخط المقترَحة إلى "مواد الأجزاء". (Iec0ae)

الإصدار 1.1.0-alpha02

9 شباط (فبراير) 2022

تم طرح "androidx.wear.tiles:tiles-*:1.1.0-alpha02". يحتوي الإصدار 1.1.0-alpha02 على هذه الالتزامات.

الميزات الجديدة

  • تمّت إضافة مكتبة فرعية جديدة layouts في مواد Tiles. ويحتوي هذا التطبيق على تصاميم "تقسيم الشاشة لأجزاء" مع مراعاة تطبيق المساحة المتروكة والهامش على طريقة تنفيذ "تقسيم الشاشة لأجزاء" بشكل أسرع وأسهل. التخطيطات الأولية هي:
    • PrimaryLayout (I7ba91) تمثِّل التنسيق الذي يتضمّن شريحة أساسية في الأسفل والمحتوى في المنتصف.
    • MultiSlotLayout (I32104) الذي يمثّل تنسيقًا يتضمّن تصنيفات في الصفَّين 1 و3، مع محاذاة أفقية ومتباعدة في الصف 2 ويلي كل ذلك صف رابع يحتوي على شريحة أساسية.
    • ProgressIndicatorLayout (I9fec6) الذي يمثّل تنسيقًا مع مؤشر تقدّم دائري حول حافة الشاشة والمحتوى المحدّد بداخله.
  • تمت إضافة CircularProgressIndicator (Ic4b88) إلى مكوّنات "مادة الشاشات".

تغييرات واجهة برمجة التطبيقات

  • تمت إعادة تسمية الثوابت المتبقية التي يستخدمها TitleChip لتضمين العنوان في الاسم. (I14f4c)
  • تمت إضافة طريقة "setHorizontalAlignment" إلى Chip. (Ie6e0b)

الإصدار 1.1.0-alpha01

26 يناير 2022

تم طرح "androidx.wear.tiles:tiles-*:1.1.0-alpha01". يحتوي الإصدار 1.1.0-alpha01 على هذه الالتزامات.

الميزات الجديدة

  • تمت إضافة مواد Tiles Material الجديدة في المكتبة. تحتوي اللعبة على مكونات لبناء تخطيطات Tiles بشكل أسرع وأسهل باستخدام "Material Design" (التصميم المتعدد الأبعاد). والمكوّنات الأولية هي:
    • Button
    • Chip
    • CompactChip
    • TitleChip

إصلاح الأخطاء

  • إصلاح الخطأ في TileUiClient الذي أدّى إلى تجاهل الموارد المخزّنة مؤقتًا. (I60e0b)

الإصدار 1.0

الإصدار 1.0.1

26 يناير 2022

تم طرح "androidx.wear.tiles:tiles-*:1.0.1". يتضمّن الإصدار 1.0.1 هذه الالتزامات.

إصلاح الأخطاء

  • إصلاح الخطأ في TileUiClient الذي أدّى إلى تجاهل الموارد المخزّنة مؤقتًا. (I60e0b)

الإصدار 1.0.0

3 تشرين الثاني (نوفمبر) 2021

تم طرح "androidx.wear.tiles:tiles-*:1.0.0". يتضمّن الإصدار 1.0.0 هذه الالتزامات.

الميزات الرئيسية للإصدار 1.0.0

  • توفّر مكتبة Wear Tiles وظائف تصميم شاشات مخصّصة للأجهزة التي تعمل بنظام التشغيل Wear OS، بالإضافة إلى الصفوف التي تتيح للنظام جلب شاشة المعلومات الخاصة بك وعرضها بجانب خلفية شاشة الساعة مباشرةً.
  • يتيح لك عارض مربّعات الشاشة عرض شاشة معلومات كجزء من نشاط Android، ما يسهّل عليك اختبار تنسيقات المربّعات.

الإصدار 1.0.0-rc01

27 تشرين الأول (أكتوبر) 2021

تم طرح "androidx.wear.tiles:tiles-*:1.0.0-rc01". يحتوي الإصدار 1.0.0-rc01 على هذه الالتزامات.

الإصدار 1.0.0-beta01

13 تشرين الأول (أكتوبر) 2021

تم طرح "androidx.wear.tiles:tiles-*:1.0.0-beta01". يتضمّن الإصدار 1.0.0-beta01 هذه الالتزامات.

إصلاح الأخطاء

  • تم إصلاح NullPointerException في TileUiClient عند توفير إصدار مورد فارغ. (I0586e)

الإصدار 1.0.0-alpha12

29 أيلول (سبتمبر) 2021

تم طرح "androidx.wear.tiles:tiles-*:1.0.0-alpha12". يحتوي الإصدار 1.0.0-alpha12 على هذه الالتزامات.

إصلاح الأخطاء

  • لم تعد أداة UpdateScheduler تستخدم مرجعًا ضعيفًا، يعمل على إصلاح المشاكل التي لا يمكن تحديث TileUiClient فيها(I1120d، b/199061124)

  • الإقرار بأن SysUiTileUpdateRequester يطلب من PacakgeManager، لإصلاح خطأ لا تعمل فيه تحديثات المربعات على أجهزة R+. (I1120d)

الإصدار 1.0.0-alpha11

1 أيلول (سبتمبر) 2021

تم طرح "androidx.wear.tiles:tiles-*:1.0.0-alpha11". يحتوي الإصدار 1.0.0-alpha11 على هذه الالتزامات.

الميزات الجديدة

  • تمت إضافة وإطلاق مكتبة اختبار androidx.wear.tilles:Tilees:التي تتيح للمطوّرين اختبار مربّعاتهم بسهولة أكبر. (Iedb6b)

تغييرات واجهة برمجة التطبيقات

  • تمت إعادة تسمية TileProviderService إلى TileService. (I1ad2c)
  • تم تعديل منصات إنشاء المربّعات، وتم إيقاف طُرق .builder() الثابتة نهائيًا لصالح استدعاء new Foo.Builder()، وتمت إزالة عمليات الضبط الزائدة التي قبلت مثيل Builder. (Ia9606)
  • من المفترض أن يستخدم TileRenderer الآن سياق واجهة المستخدم، بدلاً من سياق التطبيق. (I84b61)

إصلاح الأخطاء

  • إصلاح الخطأ الذي يتسبب في تطبيق عدة تسطير في مواقف معينة. (Ib6712)

الإصدار 1.0.0-alpha10

18 آب (أغسطس) 2021

تم طرح 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 على هذه الالتزامات.

تغييرات واجهة برمجة التطبيقات

  • تمت إزالة أدوات التحقّق من التنسيق من واجهة برمجة التطبيقات العامة. سيتم دائمًا تفعيل هذه الميزات، إلا أنّ عملية التحقق لن تصدر تحذيرًا إلا في حال تعذُّر عمليات التحقّق. (Ie9f29)
  • يقبل TileRenderer الآن سياق واجهة المستخدم، بدلاً من سياق التطبيق.

إصلاح الأخطاء

  • تم إصلاح خطأ منع النقر على العناصر القابلة للنقر في Spannable.

الإصدار 1.0.0-alpha09

21 تموز (يوليو) 2021

تم طرح 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)

تغييرات واجهة برمجة التطبيقات

  • إعادة التسمية في TileProviderClient (I0ec36):
    • getApiVersion -> requestApiVersion
    • tile/resourcesRequest -> requestTile/Resources
    • onTileFooEvent -> sendOnTileFooEvent
  • تمت إضافة فاحصات التصميم إلى عارض Wear Tiles. (I3a869)

إصلاح الأخطاء

  • تأكّد من أنّ هدف LaunchAction ليس له أذونات خاصة. (I39136)

الإصدار 1.0.0-alpha08

30 حزيران (يونيو) 2021

تم طرح 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 على هذه الالتزامات.

الميزات الجديدة

  • تدعم الملفات القابلة للامتداد line_height الآن استخدام line_height بدلاً من تباعد الأسطر.

تغييرات واجهة برمجة التطبيقات

  • أضِف دعم line_height في Spannables، وأزل تباعد الأسطر. (Ibeb54)
    • يجب نقل التعليمة البرمجية التي تستخدم line_spacing لاستخدام line_height بدلاً من ذلك.

إصلاح الأخطاء

  • إصلاح الخطأ عند استخدام الأبعاد التناسبية (I37ace)
  • إصلاح الخطأ الذي يمنع تضمين أوصاف للمحتوى في العناصر النصية (Id2c7d)

الإصدار 1.0.0-alpha07

16 حزيران (يونيو) 2021

تم طرح 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 على هذه الالتزامات.

تغييرات واجهة برمجة التطبيقات

  • إضافة واجهة TileProviderClient وعرض DefaultTileProviderClient، ما يسمح لعمليات التنفيذ بالربط بواجهة TileProviderService (I69165)

الإصدار 1.0.0-alpha06

2 حزيران (يونيو) 2021

تم طرح 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 على هذه الالتزامات.

تغييرات واجهة برمجة التطبيقات

  • تحتوي جميع فئات Builder الآن على getters لجميع المواقع. تجدر الإشارة إلى أنّها مخصَّصة لأغراض الاختبار فقط (I9d155).
  • تغيير الحزمة: تم نقل الصفوف في "androidx.wear.tiles.builders" إلى androidx.wear.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)

إصلاح الأخطاء

  • إصلاح الخطأ الذي حدث أثناء التحميل غير المتزامن للصور في عارض الشاشات (Iad9b0)
  • تم إصلاح خطأ التصميم عند وضع صورة ذات عرض أو ارتفاع مضبوطة على expand() في Box مع ضبط العرض أو الارتفاع على wrap(). (I33770)

الإصدار 1.0.0-alpha05

18 أيار (مايو) 2021

تم طرح 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 على هذه الالتزامات.

تغييرات واجهة برمجة التطبيقات

  • تمت إزالة getTileId من أحداث المربّعات الواردة (TileAddEvent و TileRemoveEvent وTileEnterEvent وTileLeaveEvent وTileRequest). (Ifbba2)
  • تم إعادة التسمية ImageResource#setAndroidResourceByResid إلى setAndroidResourceByResId (I4ba6e)
  • تمت إعادة تسمية TimelineManager#deInit لإغلاقه، وتم تنفيذ AutoCloseable. (I5dff2)

الإصدار 1.0.0-alpha04

5 أيار (مايو) 2021

تم طرح androidx.wear.tiles:tiles:1.0.0-alpha04 وandroidx.wear.tiles:tiles-proto:1.0.0-alpha04 وandroidx.wear.tiles:tiles-renderer:1.0.0-alpha04. يحتوي الإصدار 1.0.0-alpha04 على هذه الالتزامات.

تغييرات واجهة برمجة التطبيقات

  • فئات TileProviderService المخفية المخفية
    • جعل TileUpdateRequester يستغرق Class<? extends TileProviderService>. (Ib7cca)
  • تمت إضافة إمكانية إضافة ميزات إضافية إلى نشاط Android. (I748f4)

الإصدار 1.0.0-alpha03

21 نيسان (أبريل) 2021

تم طرح androidx.wear.tiles:tiles:1.0.0-alpha03 وandroidx.wear.tiles:tiles-proto:1.0.0-alpha03 وandroidx.wear.tiles:tiles-renderer:1.0.0-alpha03. يحتوي الإصدار 1.0.0-alpha03 على هذه الالتزامات.

تغييرات واجهة برمجة التطبيقات

  • إعادة تسمية "TileManager" -> "TileClient"
    • إعادة تسمية TileManager#create -> TileClient#connect (I91839)

إصلاح الأخطاء

  • تمت إضافة قواعد Proguard لضمان عمل tiles وtiles-renderer بشكل صحيح عندما تكون ميزة Proguard مفعَّلة (Ie3d85).

الإصدار 1.0.0-alpha02

7 نيسان (أبريل) 2021

تم طرح androidx.wear.tiles:tiles:1.0.0-alpha02 وandroidx.wear.tiles:tiles-proto:1.0.0-alpha02 وandroidx.wear.tiles:tiles-renderer:1.0.0-alpha02. يحتوي الإصدار 1.0.0-alpha02 على هذه الالتزامات.

تغييرات واجهة برمجة التطبيقات

  • تم نقل المجموعات من قِبل androidx.wear:wear-tiles، ويجب الإشارة إليها الآن باسم androidx.wear.tiles:tiles.
  • تم نقل المجموعات من قِبل androidx.wear:wear-tiles-renderer، ويجب الإشارة إليها الآن باسم androidx.wear.tiles:tiles-renderer.
  • يستهلك TileRenderer.LoadActionListener الآن مثيل androidx.wear.tiles.builders.StateBuilders.State بدلاً من androidx.wear.tiles.proto.StateProto.State.
  • تقبل ميزة "TileRenderer" الآن موارد Tile من androidx.wear.tiles.builders.ResourceBuilders.Resources، بدلاً من مثيل androidx.wear.tiles.renderer.ResourceAccessors.

إصلاح الأخطاء

  • إصلاح عدم القدرة على استخدام السمة LoadActionListener لأنّها كشفت عن فئة داخلية.

الإصدار 1.0.0-alpha01

10 آذار (مارس) 2021

تم طرح androidx.wear:wear-tiles:1.0.0-alpha01 وandroidx.wear:wear-tiles-proto:1.0.0-alpha01 وandroidx.wear:wear-tiles-renderer:1.0.0-alpha01. يحتوي الإصدار 1.0.0-alpha01 على هذه الالتزامات.

الميزات الجديدة

  • توفّر مكتبة Wear Tiles Renderer وظائف لإنشاء مربّعات مخصّصة للأجهزة التي تعمل بنظام التشغيل Wear OS، بالإضافة إلى الصفوف التي تتيح للنظام جلب شاشة المعلومات الخاصة بك وعرضها بجانب خلفية شاشة الساعة مباشرةً.