text-vertical

  
TODO
آخر تحديث الإصدار المستقر إصدار محتمل الإصدار التجريبي الإصدار الأولي
‫21 أكتوبر 2026 - - 1.0.0-beta03 -

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

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

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

Groovy

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

Kotlin

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

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

الملاحظات

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

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

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

Text-Vertical

الإصدار 1.0

الإصدار ‎1.0.0-beta03

‫21 أكتوبر 2026

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

ملاحظة: من المفترض أن يكون هذا هو الإصدار التجريبي الأخير.

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

  • تمت إضافة علامة التبويب "إشارة الترجمة" إلى VerticalTextSampleActivity لعرض إمكانات VerticalText، بما في ذلك العرض بارتفاع ملفوف وtoVerticalTextStyle() وRubySpan وEmphasisSpan وTate-chu-yoko وFontShearSpan وUnderlineSpan وStrikethroughSpan. I4799d1 b/571750156

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

  • تم إصلاح ارتفاع السطر الأفقي لـ RubySpan وEmphasisSpan عند استخدام خطوط ذات مساحة متروكة كبيرة في الأعلى والأسفل مثل Noto Sans JP. (Ib0507، b/557316470) - شكرًا على الإبلاغ عن المشكلة، Numero-san.
  • تم تعديل تبعيات Compose إلى 1.12.1. (I9ee7f، b/569780191)
  • يطبّق "VerticalText" الآن أنماط نطاق "AnnotatedString" ويحتفظ بنطاقات "AnnotatedString" والتعليقات التوضيحية في الدلالات. (Ib077f، b/502088091)
  • تم إصلاح مشكلة عدم ملء RubySpan وEmphasisSpan لون خلفية TextPaint.bgColor أو BackgroundColorSpan في التنسيق الأفقي. (I66ba8، b/561269843)
  • تم إصلاح ألوان الخلفية في النص العمودي التي تم رسمها كمخططات تفصيلية بعد تعيين النطاق Paint.Style.STROKE. (I692ed، b/566429122)
  • إنّ عناصر CharacterStyle التي تغطي نطاق RubySpan كاملاً في VerticalTextLayout تنطبق الآن أيضًا على نص روبي، و RubySpan.textScale يغيّر حجم الخط الذي تم ضبطه. تملأ ألوان الخلفية الآن أيضًا المساحة الفارغة أعلى وأسفل النص الأساسي ونص روبي الأقصر. (I0dadc، b/564268825)
  • تم إصلاح ارتفاع خلفية VerticalTextLayout عندما يحتوي النص العمودي على عدة أنماط. (I7e31a، b/565211671)
  • تم إصلاح مشكلة احتفاظ "VerticalText" بلون خلفية قديم عند تغيير "VerticalTextStyle.background" إلى "Color.Unspecified". (Ia0861، b/565211671)
  • تم إصلاح مشكلة تخطّي حقول TextPaint في تنسيقات النصوص الأفقية التي تتضمّن نصوصًا توضيحية وعلامات تأكيد عند نسخ تنسيق النص الأصلي. (Ia3043، b/561269843)
  • يستمدّ VerticalText الآن لون الخلفية من VerticalTextStyle.background خلف نص String العادي وخلف تعليقات روبي التوضيحية العادية في String في RubySpan. (If0493، b/564268825)
  • تم إصلاح مشكلة في تنسيق روبي الأفقي تؤدي إلى ترك مساحة الرسم المشتركة مُعدَّلة الحجم بعد الإعداد. (I33760، b/561269843)
  • تم إصلاح نموذج تطبيق النص العمودي بحيث لا يمكن لإيماءة التحريك نقل النص خارج نطاق العرض. (If0108، b/563461635)
  • تم إصلاح التطبيق التجريبي لعرض موضع علامة التوكيد (I3ffa3، b/559972132)
  • تمت إضافة اختبارات فروع التنفيذ الرمزي في Kex لكل من LineLayout وTextUtils وCanvasCompat وPaintCompat. I47edf b/569212211

الإصدار ‎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 من واجهة برمجة التطبيقات (الإصدار 7.0 من نظام التشغيل Android)، وكانت النتائج إيجابية للغاية.
  • تستهدف المكتبات الآن الإصدار 2.2 من Kotlin وتتطلّب الإصدار 2.2 من kotlinc ‏ (I82396، b/498369605)
  • يتم الآن تجميع مكتبات النصوص العمودية باستخدام الإصدار 37 من حزمة تطوير البرامج (SDK). ويجب أن يتم تجميع التطبيقات التي تستخدمها مع الإصدار 37 من حزمة تطوير البرامج (SDK) واستخدام الإصدار 9.1.0 أو إصدار أحدث من "المكوّن الإضافي لنظام Gradle المتوافق مع Android". (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 من AGP أو الإصدارات الأحدث. (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)
  • تم تقديم لغة DSL عامة جديدة (VerticalTextScope وbuildVerticalText) في مكتبة text-vertical-compose (I6faa7، b/502088091)
  • أدخل VerticalText قابل للتركيب (I96509, b/502088091)

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

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

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

الإصدار 1.0 من Text Vertical

الإصدار ‎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 الآن استخدام التنسيق الأفقي لعرض نصوص خاصة باللغة اليابانية، مثل روبي والتشديد (بوتن).

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

  • يستخدم كل من 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)