متن-عمودی

انجام دهید
آخرین به‌روزرسانی انتشار پایدار کاندیدای انتشار انتشار بتا انتشار آلفا
۲۳ سپتامبر ۲۰۲۶ - - ۱.۰.۰-بتا۰۲ -

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

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

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

شیار 

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

کاتلین 

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

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

بازخورد

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

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

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

متن-عمودی

نسخه ۱.۰

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

۲۳ سپتامبر ۲۰۲۶

androidx.text:text-vertical:1.0.0-beta02 و androidx.text:text-vertical-compose:1.0.0-beta02 منتشر شدند. نسخه 1.0.0-beta02 شامل این کامیت‌ها است.

تغییرات مهم

  • ما موارد آزمایشی را برای اطمینان از سازگاری با نسخه‌های قبلی تا API 24 (اندروید 7.0) اضافه کرده‌ایم و نتایج بسیار مثبت بوده‌اند!
  • این کتابخانه‌ها اکنون کاتلین ۲.۲ را هدف قرار می‌دهند و به kotlinc 2.2 نیاز دارند ( I82396 ، b/498369605 )
  • کتابخانه‌های متنی عمودی اکنون با SDK 37 کامپایل می‌شوند. برنامه‌هایی که از آنها استفاده می‌کنند باید با SDK 37 کامپایل شوند و از AGP 9.1.0 یا بالاتر استفاده کنند. ( I0f757 ، b/562182206 )

رفع اشکالات

  • EmphasisSpan.position حالا علامت تأکید را جابجا می‌کند. AnnotationPosition.Before علامت را بالای متن افقی و سمت راست متن عمودی قرار می‌دهد. AnnotationPosition.After آن را در سمت مقابل قرار می‌دهد. ( Ic9bfd , b/559972132 )
  • مقیاس علامت تأکید در طرح‌بندی متن افقی اصلاح شد. ارتفاع خط رزرو شده دیگر یک علامت بدون مقیاس را در نظر نمی‌گیرد. ( I6d7fe ، b/562254557 )
  • مشکل بک‌پورت برای پیشروی متن عمودی برطرف شد. بک‌پورت، آفست درخواستی را در سطوح API کمتر از ۳۴ نادیده می‌گرفت. ( I8877a ، b/495457561 )
  • متن روبی افقی که فضای عمودی زیادی را در سطوح API زیر ۲۸ اشغال می‌کرد و می‌توانست باعث شود یک خط بلندتر از حد لازم شود، اصلاح شد. ( Iceb60 , b/561323466 )
  • تست‌های مربوط به روبی عمودی و جهت‌گیری متن اکنون روی تمام سطوح API پشتیبانی‌شده اجرا می‌شوند. ( If07d4 ، b/495457561 )
  • وابستگی androidx.lifecycle:lifecycle-runtime به نسخه ۲.۱۰.۰ به‌روزرسانی شد. این نسخه برای بررسی‌های lint زمان اجرای چرخه عمر همراه با AGP نسخه ۹.۵.۰-alpha۰۴ یا بالاتر مورد نیاز است. ( I7264b ، b/556807521 )
  • مشکل نادیده گرفته شدن RubySpan.position در طرح‌بندی متن افقی برطرف شد. AnnotationPosition.After اکنون متن یاقوتی را به درستی زیر متن پایه رندر می‌کند. ( Iaffa1 ، b/559972124 ، b/561323466 )
  • مشکل نادیده گرفته شدن RubySpan.position در طرح‌بندی متن عمودی برطرف شد. اکنون AnnotationPosition.After متن یاقوتی را به درستی در سمت چپ متن پایه رندر می‌کند. ( I0be1c ، b/495457561 )
  • وابستگی‌های Compose را به ۱.۱۱.۴ ارتقا دهید ( I9ef07 ، b/536925341 )

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

۲۶ اوت ۲۰۲۶

androidx.text:text-vertical:1.0.0-beta01 و androidx.text:text-vertical-compose:1.0.0-beta01 منتشر شدند. نسخه 1.0.0-beta01 شامل این کامیت‌ها است.

تغییرات API

  • VerticalTextScope از یک رابط به یک کلاس عینی تغییر یافت. ( I44e71 , b/549288808 )

رفع اشکالات

  • مستندات مربوط به combineUpright به‌روزرسانی شد. ( Ib534b ، b/548992014 )
  • مستندات نادرست مربوط به حداقل الزامات API 36 از VerticalText حذف شد. ( I4f8e9 ، b/549288799 )
  • نسبت صعود محاسبه‌شده برای جابجایی خط پایه عمودی در حالت backport ( 07339d7 ، b/502088091 ) استفاده شد.

نسخه ۱.۰.۰-alpha06

۲۹ ژوئیه ۲۰۲۶

androidx.text:text-vertical:1.0.0-alpha06 و androidx.text:text-vertical-compose:1.0.0-alpha06 منتشر شدند. نسخه 1.0.0-alpha06 شامل این کامیت‌ها است.

تغییرات مهم

  • این نسخه، آخرین نسخه آلفای برنامه‌ریزی‌شده از کتابخانه را نشان می‌دهد.
  • پارامترهای موجود در Composable مربوط VerticalText را نهایی و اصلاح کرد.

تغییرات API

  • VerticalTextStyle برای طرح‌بندی متن عمودی معرفی شد. ( I647a8 ، b/512424512 )
  • یک DSL عمومی جدید ( VerticalTextScope و buildVerticalText ) در کتابخانه text-vertical-compose ( I6faa7 ، b/502088091 ) معرفی شد.
  • معرفی VerticalText قابل ترکیب ( I96509 ، b/502088091 )

رفع اشکالات

  • مستندات شفاف‌سازی‌شده برای رفتار جایگزین VerticalTextLayout در سطوح API قدیمی‌تر. ( Ia7ccc ، b/449184326 )

هیچ یادداشت انتشاری برای این مصنوع وجود ندارد.

متن عمودی نسخه ۱.۰

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

۲۲ آوریل ۲۰۲۶

androidx.text:text-vertical:1.0.0-alpha05 و androidx.text:text-vertical-compose:1.0.0-alpha05 منتشر شدند. نسخه 1.0.0-alpha05 شامل این کامیت‌ها است.

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

  • توابع Composable برای پشتیبانی از طرح‌بندی متن عمودی اضافه شدند، که با ابتکار Compose-first گوگل همسو است.

تغییرات API

  • مصنوع کتابخانه‌ی :text:text-vertical-compose معرفی شد. ( I939e4 )
  • ویژگی lineCount به کلاس VerticalTextLayout اضافه شد. ( I93884 ، b/502088091 )

رفع اشکالات

  • مستندات KDoc برای وضوح و دقت به‌روزرسانی شد. ( I71c8f ، b/449184326 )

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

۸ آوریل ۲۰۲۶

androidx.text:text-vertical:1.0.0-alpha04 منتشر شد. نسخه 1.0.0-alpha04 شامل این کامیت‌ها است.

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

  • تمام کلاس‌های عمومی را بازسازی کرد تا APIهای کاتلینِ راحت‌تر و اصطلاحی‌تری برای استفاده عمومی ارائه دهد، ضمن اینکه قابلیت همکاری قوی با جاوا را حفظ کند.

تغییرات API

  • یک سازنده پیش‌فرض بدون آرگومان به FontShearSpan برای سازگاری با جاوا اضافه شد ( I73065 ، b/493692287 ).
  • پیاده‌سازی Parcelable در RubySpan و EmphasisSpan ( I49884 ، b/493693386 ) حذف شد.
  • EmphasisSpan برای سازگاری بهتر ( I34c40 ، b/493693310 ) بازآرایی شد.
  • AnnotationPosition برای بهبود سطح API ( I10dce ، b/493693386 ) بازسازی شد.
  • TextOrientation به یک کلاس enum تبدیل کردم، AnnotationPosition به یک کلاس sealed تغییر دادم و RubySpan.Builder ( Ib4a77 ، b/493693386 ) را حذف کردم.
  • شمارشگر AnnotationPosition اضافه شد و کلاس RubySpan ( Ibfcff ، ​​b/493692426 ) بازسازی شد.
  • TextOrientation برای استفاده عمومی اصلاح‌شده و افزونه‌های مقیاس‌بندی متن داخلی بهبود یافته ( I82152 ، b/493692428 ).

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

۲۵ مارس ۲۰۲۶

androidx.text:text-vertical:1.0.0-alpha03 منتشر شد. نسخه 1.0.0-alpha03 شامل این کامیت‌ها است.

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

  • VerticalTextLayout اکنون از طرح‌بندی افقی پشتیبانی می‌کند تا بتواند spanهای ویژه به زبان ژاپنی مانند Ruby و Emphasis (Boten) را نمایش دهد.

تغییرات API

  • RubySpan و EmphasisSpan اکنون ReplacementSpan را برای پشتیبانی از متن افقی به ارث می‌برند ( I38db6 ، b/447239659 ، b/447224892 )

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

۸ اکتبر ۲۰۲۵

androidx.text:text-vertical:1.0.0-alpha02 منتشر شد. نسخه 1.0.0-alpha02 شامل این کامیت‌ها است.

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

  • متد VerticalTextLayout#isVerticalTextLayoutSupported() برای بررسی قابلیت متن عمودی اضافه شد ( Ie2802 ، b/442608654 )

تغییرات API

  • یک جایگزین مناسب در API < 36 معرفی شد. ( I8a67a ، b/442608654 )
  • برای استفاده در سایر کتابخانه‌های AndroidX ( I2d6b5 ، b/442608654 ) minSDK به ۲۳ کاهش دهید.

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

۲۷ آگوست ۲۰۲۵

androidx.text:text-vertical:1.0.0-alpha01 منتشر شد. نسخه 1.0.0-alpha01 شامل این کامیت‌ها است.

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

  • یک کتابخانه متن عمودی جدید برای پشتیبانی از طرح‌بندی متن عمودی، عمدتاً برای زبان ژاپنی، با استفاده از پرچم جدید VERTICAL_TEXT_FLAG که در اندروید ۱۶ اضافه شده است.
  • VerticalTextLayout اضافه شد که متن عمودی را با خطوط شکسته مناسب، جهت‌گیری ترکیبی (مثلاً کاراکترهای لاتین افقی درون یک خط عمودی) و متن یاقوتی نمایش می‌داد. ( 8b3a10 )
  • FontShearSpan برای سبک مورب مانند در متن عمودی اضافه شد. ( 1ffd78 )
  • اضافه شدن EmphasisRun برای علامت‌های تأکید. ( fe12d9 )