text-vertical

  
--
آخر تحديث الإصدار المستقر إصدار محتمل الإصدار التجريبي الإصدار الأولي
‫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 لمزيد من المعلومات.

الإصدار 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 spans that cover a full RubySpan range in VerticalTextLayout now also apply to the ruby text, and RubySpan.textScale scales the font sizes that they set. وتملأ ألوان الخلفية الآن أيضًا المساحة الفارغة أعلى وأسفل النص الأساسي ونص روبي الأقصر. (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). ويجب أن تستخدم التطبيقات التي تستخدم هذه الميزات حزمة SDK 37 وAGP 9.1.0 أو إصدار أحدث. (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.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)