نوشتار-عمودی

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

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

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

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

شیک

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

کاتلین

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

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

بازخورد

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

ایجاد مشکل جدید

برای اطلاعات بیشتر، سند Issue Tracker را ببینید.

نسخه 1.0

نسخه 1.0.0-beta03

‫۲۱ اکتبر ۲۰۲۶

‫androidx.text:text-vertical:1.0.0-beta03 و androidx.text:text-vertical-compose:1.0.0-beta03 منتشر شده‌اند. نسخه 1.0.0-beta03 حاوی این موارد ثبت است.

توجه: این نسخه قرار است آخرین نسخه بتا باشد.

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

  • برگه «Subtitle Cue» (نشانه زیرنویس) به 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)
  • Fixed the test app to demo emphasis mark position (I3ffa3, b/559972132)
  • آزمایش‌های شاخه اجرای نمادین Kex برای LineLayout، TextUtils، CanvasCompat، و PaintCompat اضافه شد. I47edf b/569212211

نسخه 1.0.0-beta02

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

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

تغییرات مهم

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

رفع اشکال‌ها

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

نسخه 1.0.0-beta01

‫۲۶ اوت ۲۰۲۶

‫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)
  • سند نادرست حداقل الزامات API 36 از VerticalText برداشته شد. (I4f8e9، b/549288799)
  • Used calculated ascent ratio for vertical baseline offset in backport mode (07339d7, b/502088091)

نسخه 1.0.0-alpha06

‫۲۹ ژوئیه ۲۰۲۶

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

تغییرات مهم

  • این نسخه پخش آخرین نسخه آلفای برنامه‌ریزی‌شده برای این کتابخانه است.
  • پارامترها در VerticalText composable نهایی و پالایش شد

تغییرات میانای برنامه‌سازی کاربردی

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

رفع اشکال‌ها

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

نسخه 1.0.0-alpha05

‫۲۲ آوریل ۲۰۲۶

‫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

‫۸ آوریل ۲۰۲۶

‫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 به کلاس enum تبدیل شد، AnnotationPosition به کلاس sealed بازسازی شد، و RubySpan.Builder برداشته شد (Ib4a77، b/493693386).
  • ‫AnnotationPosition enum اضافه شد و کلاس RubySpan بازسازی کد شد (Ibfcff، b/493692426).
  • TextOrientation برای استفاده عمومی بازسازی شد و افزونه‌های مقیاس‌بندی نوشتار داخلی بهبود یافت (I82152، b/493692428).

نسخه 1.0.0-alpha03

‫۲۵ مارس ۲۰۲۶

‫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

‫۸ اکتبر ۲۰۲۵

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

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

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

تغییرات میانای برنامه‌سازی کاربردی

  • یک بازگشت ملایم در API < 36 معرفی شد.(I8a67a،‏ b/442608654)
  • Downgrade minSDK to 23 to be used in other AndroidX libraries (I2d6b5, b/442608654)

نسخه 1.0.0-alpha01

‫۲۷ اوت ۲۰۲۵

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

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

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