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

  
فهرست کارها
جدیدترین به‌روزرسانی نسخه پایدار نامزد انتشار انتشار نسخه بتا نسخه آلفا
‫۲۱ اکتبر ۲۰۲۶ - - 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 حاوی این ارسال‌ها است.

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

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

  • برگه «نشانه زیرنویس» به VerticalTextSampleActivity اضافه شد تا قابلیت‌های VerticalText را نشان دهد، ازجمله رندر کردن با ارتفاع پیچیده، toVerticalTextStyle()،‏ RubySpan،‏ EmphasisSpan،‏ Tate-chu-yoko،‏ FontShearSpan،‏ UnderlineSpan، و StrikethroughSpan. I4799d1 b/571750156

رفع اشکال‌ها

  • ارتفاع خط افقی RubySpan و EmphasisSpan ثابت شد هنگام استفاده از قلم‌هایی با حاشیه داخلی بالا و پایین بزرگ مانند Noto Sans JP. (Ib0507، b/557316470) - نومرو سان، از گزارشتان سپاس‌گزاریم!
  • وابستگی‌های Compose به 1.12.1 به‌روز شد. (I9ee7f، b/569780191)
  • VerticalText اکنون سبک‌های گستره AnnotatedString را اعمال می‌کند و گستره‌ها و حاشیه‌نویسی‌های AnnotatedString را در معناشناسی حفظ می‌کند. (Ib077f، b/502088091)
  • مشکل پر نشدن رنگ پس‌زمینه TextPaint.bgColor یا BackgroundColorSpan در چیدمان افقی توسط RubySpan و EmphasisSpan برطرف شد. (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

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

‫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)

هیچ یادداشت انتشاری برای این آرتیفکت وجود ندارد.

Text Vertical نسخه ۱.۰

نسخه 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).
  • Added the AnnotationPosition enum and refactored the RubySpan class (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)