جوهر

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

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

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

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

شیار 

dependencies {
  
    implementation "androidx.ink:ink-authoring:1.0.0-beta01"
    implementation "androidx.ink:ink-brush:1.0.0-beta01"
    implementation "androidx.ink:ink-geometry:1.0.0-beta01"
    implementation "androidx.ink:ink-nativeloader:1.0.0-beta01"
    implementation "androidx.ink:ink-rendering:1.0.0-beta01"
    implementation "androidx.ink:ink-strokes:1.0.0-beta01"
    
}

کاتلین 

dependencies {


    implementation("androidx.ink:ink-authoring:1.0.0-beta01")
    implementation("androidx.ink:ink-brush:1.0.0-beta01")
    implementation("androidx.ink:ink-geometry:1.0.0-beta01")
    implementation("androidx.ink:ink-nativeloader:1.0.0-beta01")
    implementation("androidx.ink:ink-rendering:1.0.0-beta01")
    implementation("androidx.ink:ink-strokes:1.0.0-beta01")
}

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

بازخورد

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

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

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

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

نسخه ۱.۰

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

۲۲ اکتبر ۲۰۲۵

androidx.ink:ink-*:1.0.0-beta01 منتشر شد. نسخه 1.0.0-beta01 شامل این کامیت‌ها است.

رفع اشکالات

  • رفع اشکالات در آماده‌سازی برای انتشار نسخه بتا ۱ ( I9900e )
  • کاهش آرتیفکت‌های رندر در استروک‌ها به دلیل تعداد زیاد ورودی‌های مدل‌سازی شده که بسیار نزدیک به یکدیگر هستند.
  • رفع مشکل نادر خرابی در مدل‌سازی ورودی.

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

۸ اکتبر ۲۰۲۵

androidx.ink:ink-*:1.0.0-alpha07 منتشر شد. نسخه 1.0.0-alpha07 شامل این کامیت‌ها است.

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

  • پارامتر SelfOverlap برای highlighter StockBrushes و emojiHighlighter که جایگزین InProgressStrokesView rendererFactory می‌شود
  • پیاده‌سازی بهبود یافته‌ی هموارسازی ورودی ضربه‌ای، که نویز اندازه‌گیری دستگاه را حذف می‌کند اما ورودی کاربر را با دقت بیشتری نسبت به پیاده‌سازی هموارسازی ورودی ضربه‌ای قبلی منعکس می‌کند.
  • بهبود سازگاری با سایر APIهای اندروید/جت‌پک برای واحدهای زاویه (درجه در مقابل رادیان)، تبدیل‌ها (کجی در مقابل برش) و موارد دیگر

تغییرات API

  • API مربوط به زاویه را تغییر دهید تا از درجه استفاده کند و واحد را در نام‌ها بگنجاند، در مورد واحدها در ابزارهای تبدیل زاویه شفاف باشید و از درجه و رادیان پشتیبانی کنید، API StockBrushes را تغییر دهید تا نسخه قلم‌موهای موجود را به عنوان یک پارامتر تابع کارخانه‌ای دریافت کند و کنترل رفتار همپوشانی خودکار را برای قلم‌موهای هایلایت‌کننده نمایش دهد، نام MutableAffineTransform.populateFromTranslate را به populateFromTranslation تغییر دهید، InProgressStrokesView.setRenderFactory/getRenderFactory را حذف کنید. ( Id9eab ، b/436656418 )
  • نام shear را به skew تغییر دهید، برخی مستندات را شفاف‌سازی کنید، CanvasStrokeRenderer.strokeModifiedRegionOutsetPx را حذف کنید، InProgressStroke.changesWithTime ( Ia5e70 ، b/436656418 ) را اضافه کنید.

رفع اشکالات

  • مدل‌سازی ورودی را بهبود دهید تا خطوط، ورودی را با دقت بیشتری منعکس کنند. ( I93097 )

نسخه ۱.۰.۰-alpha06

۱۳ آگوست ۲۰۲۵

androidx.ink:ink-*:1.0.0-alpha06 منتشر شد. نسخه 1.0.0-alpha06 شامل این کامیت‌ها است.

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

  • قلم موی هایلایت ایموجی: بخش‌هایی از سند را با هر ایموجی که انتخاب می‌کنید، هایلایت کنید تا جلوه‌ای سرگرم‌کننده به آن اضافه کنید و به منظم ماندن آن کمک کنید.
  • APIهای کمکی بیشتر برای اشکال اولیه ماژول هندسه
  • بهبود سازگاری و عملکرد دستگاه

تغییرات API

  • API ساده‌شده برای InProgressStrokesView ، APIهای هندسه‌ی نهایی، هایلایت‌کننده‌ی ایموجی، حذف توابع کارخانه‌ای از MutableParallelogram به نفع متدهای پر کردن، پشتیبانی از seed برای رفتارهای تصادفی قلم‌مو. ( I38280 )

رفع اشکالات

  • رفع مشکل عملکرد و مشکل سازگاری رنگ مرطوب/خشک. ( Ifcd1d )

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

۱۸ ژوئن ۲۰۲۵

androidx.ink:ink-*:1.0.0-alpha05 منتشر شد. نسخه 1.0.0-alpha05 شامل این کامیت‌ها است.

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

  • ماژول‌های قابلیت همکاری را برای ماژول‌های نویسندگی، قلم‌مو و هندسه ایجاد کنید

تغییرات API

  • ماژول‌ها و APIهای جدید برای قابلیت همکاری Compose، پاکسازی API ( I0e464 )
  • متدهای InProgressStroke.enqueueInputs/updateShape که kotlin.Result برمی‌گرداندند، حذف می‌شوند و کلاینت‌ها باید به جای آن از مثلاً enqueueInputsOrThrow یا enqueueInputsOrIgnore استفاده کنند. InProgressStroke.getNeedsUpdate به isUpdateNeeded تغییر نام داده است. InProgressStroke.populateOutlinePosition اکنون پارامتر خروجی خود را برمی‌گرداند تا امکان زنجیره‌سازی فراخوانی فراهم شود، مطابق با سایر متدها در Ink. رابط TextureBitmapStore از ماژول رندر به ماژول brush منتقل شده است. BoxAccumulator.populateFrom طوری ساخته شده است که به جای یک BoxAccumulator تغییرپذیر، یک Box تغییرناپذیر nullable بگیرد. برای اینکه مشخص‌تر شود چه چیزی تغییر یافته است، فراخوانی‌کنندگان باید boxAccumulator.add(other) را به boxAccumulator.add(other.box) تغییر دهند. BrushUtil.toBuilderWithAndroidColor/createBuilderWithAndroidColor حذف می‌شوند و به جای آن از setAndroidColor مربوط به Brush.Builder پس از ساخت استفاده کنید. ( آی ای ۷۱۵۵ )
  • ویژگی آزمایشی قبلی InProgressStrokesView.textureBitmapStore اکنون خصوصی است. هنوز دسترسی‌های عمومی برای این ویژگی وجود دارد. ( I1d706 )

رفع اشکالات

  • عملکرد بهبود یافته برای قلم‌موهای سفارشی حاوی ذرات زیاد.

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

۹ آوریل ۲۰۲۵

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

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

  • APIهای آزمایشی جدیدی را برای اشیاء سفارشی BrushFamily معرفی می‌کند که قلم‌موهای جدیدی مانند مداد (Pencil) و اشاره‌گر لیزری (Laser Pointer) را فعال می‌کند. این API امکان بارگذاری قلم‌موهای تعریف‌شده توسط این نمونه اولیه ( I8809a ) را فراهم می‌کند.

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

۱۲ فوریه ۲۰۲۵

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

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

  • صرفه‌جویی در اندازه دیسک و شبکه: سریال‌سازی StrokeInputBatch ، صرفه‌جویی در بسیاری از خطوط کد، و اشیاء حاصل، کسر کوچکی از اندازه stroke های ذخیره شده سنتی را دارند. ( Ie898d )
  • انتخاب با لاسو: قلم‌موی خط‌چین برای رسم یک خط انتخاب، و تابعی برای تبدیل خط انتخاب به یک PartitionedMesh برای پرس‌وجوهای هندسی. ( Ia38a0 )

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

۱۱ دسامبر ۲۰۲۴

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

تغییرات API

  • رفع اشکالات مختلف. ( I05dd8 )

مشارکت خارجی

  • BuildCompat.isAtLeastV منسوخ کنید. فراخوانی‌کنندگان باید SDK_INT را مستقیماً با ۳۵ مقایسه کنند ( I294d1 ).

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

۲ اکتبر ۲۰۲۴

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

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

  • یک کتابخانه ماژولار و قابل تنظیم برای آسان کردن ایجاد، رندر و دستکاری خطوط جوهر زیبا که در برنامه شما نوشته شده‌اند.

تغییرات API

ماژول‌های جدید برای کمک به توسعه‌دهندگان در ایجاد تجربیات غنی از جوهرافشانی:

  • نوشتن: از InProgressStrokesView برای رندر کردن strokeها با کارایی بالا و تأخیر کم به صورت بلادرنگ هنگام دریافت ورودی‌ها استفاده کنید.
  • رندرینگ: از CanvasStrokeRenderer و ViewStrokeRenderer برای رسم خطوط جوهر نهایی به عنوان بخشی از رابط کاربری برنامه استفاده کنید.
  • خطوط: انواع داده‌های اصلی مورد استفاده برای ویژگی‌های نوشتاری.
  • قلم‌مو: مشخصات قابل تنظیم نحوه نمایش و عملکرد خطوط در پاسخ به ورودی کاربر.
  • هندسه: از عملیات هندسی مانند تقاطع و پوشش گرفته تا ابزارهای قدرتمند مانند انتخاب و پاک کردن.