text-vertical

تحديد الاعتماديات

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

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

dependencies {
    implementation "androidx.text:text-vertical:1.0.0-beta02"
}

dependencies {
    implementation("androidx.text:text-vertical:1.0.0-beta02")
}

لمزيد من المعلومات حول الاعتماديات، يُرجى الاطّلاع على إضافة اعتماديات الإصدار.

الملاحظات

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

إنشاء مشكلة جديدة

يُرجى الاطّلاع على مستندات Issue Tracker للحصول على مزيد من المعلومات.

Text-Vertical

الإصدار 1.0

الإصدار ‎1.0.0-beta02

‫23 سبتمبر 2026

تم طرح androidx.text:text-vertical:1.0.0-beta02 وandroidx.text:text-vertical-compose:1.0.0-beta02. يتضمّن الإصدار 1.0.0-beta02 هذه التعديلات.

التغييرات المهمة

• لقد أضفنا حالات اختبار لضمان التوافق مع الإصدارات القديمة حتى المستوى 24 من واجهة برمجة التطبيقات (Android 7.0)، وكانت النتائج إيجابية للغاية.
• تستهدف المكتبات الآن الإصدار 2.2 من Kotlin وتتطلّب الإصدار 2.2 من kotlinc (I82396، b/498369605)
• تتم الآن ترجمة مكتبات النصوص العمودية باستخدام حزمة تطوير البرامج (SDK) الإصدار 37. يجب أن يتم تجميع التطبيقات التي تستخدمها باستخدام حزمة تطوير البرامج (SDK) 37 واستخدام الإصدار 9.1.0 أو إصدار أحدث من "مكوّن Android الإضافي لبرنامج Gradle". (I0f757، b/562182206)

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

• يؤدي الضغط على EmphasisSpan.position الآن إلى نقل علامة التشديد. يضع الرمز AnnotationPosition.Before العلامة فوق النص الأفقي وعلى يمين النص العمودي. AnnotationPosition.After يضعها على الجانب الآخر. (Ic9bfd، b/559972132)
• تم إصلاح مقياس علامة التشديد في تخطيط النص الأفقي. لم يعُد ارتفاع السطر المحجوز يفترض علامة غير معدَّلة. (I6d7fe، b/562254557)
• تم إصلاح عملية النقل إلى إصدار أقدم من أجل تقدّم النص العمودي. لم يتم تنفيذ عملية النقل إلى الإصدارات القديمة للإزاحة المطلوبة في مستويات واجهة برمجة التطبيقات الأقل من 34. (I8877a، b/495457561)
• تم إصلاح مشكلة حجز مساحة عمودية كبيرة جدًا للنص الروبي الأفقي الثابت في مستويات واجهة برمجة التطبيقات الأقل من 28، ما قد يؤدي إلى ترك سطر أطول من اللازم. (Iceb60، b/561323466)
• يتم الآن إجراء اختبارات النص العمودي والنص المكتوب فوقه على جميع مستويات واجهة برمجة التطبيقات المتوافقة. (If07d4، b/495457561)
• تم تعديل الاعتمادية androidx.lifecycle:lifecycle-runtime إلى الإصدار 2.10.0. هذا الإصدار مطلوب لتشغيل عمليات التحقّق من أخطاء lint المجمَّعة في وقت التشغيل لدورة الحياة مع الإصدار 9.5.0-alpha04 أو إصدار أحدث من "مكوّن Android الإضافي لبرنامج Gradle". (I7264b، b/556807521)
• تم إصلاح مشكلة تجاهل RubySpan.position في تخطيط النص الأفقي. تعرض السمة AnnotationPosition.After الآن نص الياقوت بشكل صحيح أسفل النص الأساسي. (Iaffa1، b/559972124، b/561323466)
• تم إصلاح مشكلة تجاهل RubySpan.position في تصميم النص العمودي. تعرض AnnotationPosition.After الآن نص الياقوت بشكل صحيح على الجانب الأيسر من النص الأساسي. (I0be1c، b/495457561)
• ترقية تبعيات Compose إلى الإصدار 1.11.4 (I9ef07، b/536925341)

الإصدار 1.0.0-beta01

‫26 أغسطس 2026

تم طرح androidx.text:text-vertical:1.0.0-beta01 وandroidx.text:text-vertical-compose:1.0.0-beta01. يتضمّن الإصدار 1.0.0-beta01 هذه التعديلات.

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

• تم تغيير VerticalTextScope من واجهة إلى فئة ملموسة. (I44e71، b/549288808)

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

• تم تعديل مستندات combineUpright. (Ib534b، b/548992014)
• تمت إزالة مستندات الحد الأدنى غير الصحيح من متطلبات المستوى 36 لواجهة برمجة التطبيقات من VerticalText. (I4f8e9، b/549288799)
• تم استخدام نسبة الارتفاع المحسوبة لإزاحة خط الأساس العمودي في وضع النقل إلى إصدار أقدم (07339d7، b/502088091)

الإصدار ‎1.0.0-alpha06

‫29 يوليو 2026

تم طرح androidx.text:text-vertical:1.0.0-alpha06 وandroidx.text:text-vertical-compose:1.0.0-alpha06. يتضمّن الإصدار ‎1.0.0-alpha06 هذه التعديلات.

التغييرات المهمة

• يمثّل هذا الإصدار آخر نسخة ألفا مخطَّط لها من المكتبة.
• وضع اللمسات الأخيرة على المَعلمات وتحسينها في VerticalText القابلة للإنشاء

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

• تمت إضافة VerticalTextStyle لتخطيط النص العمودي. (I647a8، b/512424512)
• تم طرح لغة نطاق جديدة خاصة بالتطبيق (VerticalTextScope وbuildVerticalText) في مكتبة text-vertical-compose (I6faa7 وb/502088091)
• إضافة VerticalText قابلة للإنشاء (I96509، b/502088091)

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

• توضيح المستندات الخاصة بسلوك VerticalTextLayout الاحتياطي في مستويات واجهة برمجة التطبيقات القديمة (Ia7ccc، b/449184326)

لا تتوفّر ملاحظات إصدار لهذا العنصر.

الإصدار 1.0 من "النص العمودي"

الإصدار ‎1.0.0-alpha05

‫22 أبريل 2026

تم طرح androidx.text:text-vertical:1.0.0-alpha05 وandroidx.text:text-vertical-compose:1.0.0-alpha05. يتضمّن الإصدار ‎1.0.0-alpha05 هذه التعديلات.

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

• تمت إضافة دوال قابلة للإنشاء لدعم تخطيط النص العمودي، بما يتوافق مع مبادرة Compose-first من Google.

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

• تم تقديم العنصر :text:text-vertical-compose الخاص بالمكتبة. (I939e4)
• تمت إضافة السمة lineCount إلى الفئة VerticalTextLayout. (I93884، b/502088091)

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

• تم تعديل مستندات KDoc لزيادة الوضوح والدقة. (I71c8f، b/449184326)

الإصدار ‎1.0.0-alpha04

‫8 أبريل 2026

تم طرح androidx.text:text-vertical:1.0.0-alpha04. يتضمّن الإصدار ‎1.0.0-alpha04 هذه التعديلات.

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

• تمت إعادة تصميم جميع الفئات العامة لتوفير واجهات برمجة تطبيقات Kotlin أكثر ملاءمة وسلاسة للاستخدام العام، مع الحفاظ على إمكانية التشغيل التفاعلي القوية مع Java.

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

• تمت إضافة منشئ تلقائي بدون وسيطات إلى FontShearSpan لتكون متوافقة مع Java (I73065، b/493692287).
• تمت إزالة تنفيذ Parcelable في RubySpan وEmphasisSpan (I49884، b/493693386).
• تمت إعادة تصميم EmphasisSpan لتحسين التوافق (I34c40، b/493693310).
• تمت إعادة تصميم AnnotationPosition لتحسين مساحة عرض واجهة برمجة التطبيقات (I10dce، b/493693386).
• تم تحويل TextOrientation إلى فئة تعداد، وإعادة تصميم AnnotationPosition إلى فئة محكمة الإغلاق، وإزالة RubySpan.Builder (Ib4a77، b/493693386).
• تمت إضافة تعداد AnnotationPosition وإعادة تصميم الفئة RubySpan (Ibfcff، b/493692426).
• تمت إعادة تصميم TextOrientation للاستخدام العام وتحسين إضافات تغيير حجم النص الداخلية (I82152 وb/493692428).

الإصدار ‎1.0.0-alpha03

‫25 مارس 2026

تم طرح androidx.text:text-vertical:1.0.0-alpha03. يتضمّن الإصدار ‎1.0.0-alpha03 هذه التعديلات.

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

• يتيح VerticalTextLayout الآن التنسيق الأفقي لعرض نطاقات خاصة باللغة اليابانية، مثل Ruby وEmphasis (Boten).

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

• تتضمّن RubySpan وEmphasisSpan الآن ReplacementSpan لدعمها في النص الأفقي (I38db6 وb/447239659 وb/447224892)

الإصدار ‎1.0.0-alpha02

‫8 أكتوبر 2025

تم طرح androidx.text:text-vertical:1.0.0-alpha02. يتضمّن الإصدار ‎1.0.0-alpha02 هذه التعديلات.

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

• تمت إضافة الطريقة VerticalTextLayout#isVerticalTextLayoutSupported() للتحقّق من إمكانية عرض النص العمودي (Ie2802، b/442608654)

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

• تم تقديم خيار احتياطي سلس في الإصدارات الأقدم من واجهة برمجة التطبيقات 36.(I8a67a، b/442608654)
• خفض مستوى minSDK إلى 23 لاستخدامه في مكتبات AndroidX الأخرى (I2d6b5، b/442608654)

الإصدار ‎1.0.0-alpha01

‫27 أغسطس 2025

تم طرح androidx.text:text-vertical:1.0.0-alpha01. يتضمّن الإصدار ‎1.0.0-alpha01 هذه التعديلات.

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

• مكتبة جديدة للنصوص العمودية تتيح تخطيط النصوص العمودية، خاصةً باللغة اليابانية، وذلك من خلال الاستفادة من العلامة الجديدة VERTICAL_TEXT_FLAG التي تمت إضافتها في Android 16.
• تمت إضافة VerticalTextLayout التي تعرض نصًا عموديًا مع فواصل أسطر مناسبة، وتنسيقًا مختلطًا (مثل أحرف لاتينية أفقية ضمن سطر عمودي)، ونصًا فوقيًّا. (8b3a10)
• تمت إضافة FontShearSpan لنمط يشبه الخط المائل في النص العمودي. (1ffd78)
• تمت إضافة EmphasisRun لعلامات التأكيد. (fe12d9)