الريشة

تحديد الاعتماديات

لإضافة اعتمادية على Ink، يجب تضمين مستودع Google Maven في مشروعك. اطّلِع على مستودع Maven من Google لمزيد من المعلومات.

أضِف الاعتماديات الخاصة بالعناصر التي تحتاج إليها في ملف build.gradle لتطبيقك أو وحدتك:

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

dependencies {


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

لمزيد من المعلومات حول الاعتماديات، يُرجى الاطّلاع على إضافة اعتماديات البناء.

الملاحظات

تساعدنا ملاحظاتك في تحسين Jetpack. يُرجى إعلامنا إذا اكتشفت مشاكل جديدة أو كانت لديك أفكار لتحسين هذه المكتبة. يُرجى الاطّلاع على المشاكل الحالية في هذه المكتبة قبل إنشاء مكتبة جديدة. يمكنك إضافة صوتك إلى مشكلة حالية من خلال النقر على زر النجمة.

إنشاء مشكلة جديدة

يُرجى الاطّلاع على مستندات Issue Tracker للحصول على مزيد من المعلومات.

لا تتوفّر ملاحظات إصدار لهذا العنصر.

الإصدار 1.0

الإصدار 1.0.0-beta02

‫19 نوفمبر 2025

تم طرح androidx.ink:ink-*:1.0.0-beta02. يتضمّن الإصدار 1.0.0-beta02 هذه التعديلات.

تغييرات واجهة برمجة التطبيقات

• واجهات برمجة تطبيقات تجريبية مخصّصة للأشكال ذات زمن الاستجابة المنخفض، وإصلاحات متنوعة للأخطاء (Ib8d2f)

إصلاح الأخطاء

• تحسين دقة النقطة العائمة في StrokeInputBatch التسلسل، وإصلاح الانحراف في القيم الناتج عن التشفير وفك التشفير المتكرّرين
• تنقيح أكثر فعالية لمدخلات النظام
• إصلاح مشكلة عدم توفّر زخرفة الفرشاة في العنصر القابل للإنشاء InProgressStrokes

الإصدار 1.0.0-beta01

‫22 أكتوبر 2025

تم طرح androidx.ink:ink-*:1.0.0-beta01. يتضمّن الإصدار 1.0.0-beta01 هذه التعديلات.

إصلاح الأخطاء

• إصلاح الأخطاء استعدادًا لإصدار beta01 (I9900e)
• تقليل التشويش في العينات بسبب كثرة المدخلات التي تم تصميمها بالقرب من بعضها البعض
• تم إصلاح عُطل نادر في نمذجة الإدخال.

الإصدار 1.0.0-alpha07

‫8 أكتوبر 2025

تم طرح androidx.ink:ink-*:1.0.0-alpha07. يتضمّن الإصدار 1.0.0-alpha07 هذه التعديلات.

الميزات الجديدة

• المَعلمة SelfOverlap لكل من StockBrushes وhighlighter وemojiHighlighter، والتي تحلّ محلّ InProgressStrokesView rendererFactory
• تحسين تنفيذ ميزة "تنعيم إدخال ضربات الفرشاة"، ما يؤدي إلى إزالة التشويش الناتج عن قياس الجهاز، ولكنّه يعكس بيانات المستخدم بشكل أكثر دقة من عملية التنفيذ السابقة لميزة "تنعيم إدخال ضربات الفرشاة"
• تحسين التوافق مع واجهات برمجة تطبيقات Android/Jetpack الأخرى لوحدات الزوايا (الدرجات مقابل الراديان) وعمليات التحويل (الانحراف مقابل القص) وغير ذلك

تغييرات واجهة برمجة التطبيقات

• تغيير واجهة برمجة التطبيقات ذات الصلة بالزوايا لاستخدام الدرجات وتضمين الوحدة في الأسماء، وتوضيح الوحدات في أدوات تحويل الزوايا وإتاحة استخدام الدرجات والراديان، وتغيير واجهة برمجة التطبيقات StockBrushes لتأخذ إصدار الفرشاة الجاهزة كمعلَمة دالة المصنع وعرض عنصر التحكّم في سلوك التداخل الذاتي لفرشاة التمييز، وإعادة تسمية MutableAffineTransform.populateFromTranslate إلى populateFromTranslation، وإزالة InProgressStrokesView.setRenderFactory/getRenderFactory (Id9eab، b/436656418)
• إعادة تسمية القص إلى الانحراف، وتوضيح بعض المستندات، وإزالة CanvasStrokeRenderer.strokeModifiedRegionOutsetPx، وإضافة InProgressStroke.changesWithTime (Ia5e70، b/436656418)

إصلاح الأخطاء

• تحسين عملية وضع نماذج للإدخال لجعل ضربات المفاتيح تعكس الإدخال بدقة أكبر (I93097)

الإصدار 1.0.0-alpha06

‫13 أغسطس 2025

تم طرح androidx.ink:ink-*:1.0.0-alpha06. يتضمّن الإصدار 1.0.0-alpha06 هذه التعديلات.

الميزات الجديدة

• فرشاة تمييز الإيموجي الجاهزة: يمكنك تمييز أجزاء من المستند باستخدام أي إيموجي تختاره، لإضافة لمسة مرحة والمساعدة في الحفاظ على التنظيم.
• المزيد من واجهات برمجة التطبيقات المساعدة للأشكال الأساسية في وحدة الأشكال الهندسية
• تحسين توافق الجهاز وأدائه

تغييرات واجهة برمجة التطبيقات

• واجهة برمجة تطبيقات مبسطة لـ InProgressStrokesView، وواجهات برمجة تطبيقات هندسية نهائية، وأداة تمييز الرموز التعبيرية، وإزالة دوال المصنع من MutableParallelogram لصالح طرق التعبئة، وإتاحة استخدام قيمة أولية لسلوكيات الفرشاة العشوائية (I38280)

إصلاح الأخطاء

• تم إصلاح مشكلة في الأداء ومشكلة في اتساق الألوان في الظروف الرطبة والجافة. (Ifcd1d)

الإصدار 1.0.0-alpha05

‫18 يونيو 2025

تم طرح androidx.ink:ink-*:1.0.0-alpha05. يتضمّن الإصدار 1.0.0-alpha05 هذه التعديلات.

الميزات الجديدة

• إنشاء وحدات إمكانية التشغيل التفاعلي لوحدات التأليف والفرشاة والأشكال الهندسية

تغييرات واجهة برمجة التطبيقات

• وحدات وواجهات برمجة تطبيقات جديدة للتوافق التشغيلي في Compose، وتنظيف واجهة برمجة التطبيقات (I0e464)
• تمت إزالة طرق InProgressStroke.enqueueInputs/updateShape التي عرضت kotlin.Result، ويجب أن تستخدم البرامج طرقًا أخرى، مثل enqueueInputsOrThrow أو enqueueInputsOrIgnore. تمت إعادة تسمية InProgressStroke.getNeedsUpdate إلى isUpdateNeeded. تعرض الدالة InProgressStroke.populateOutlinePosition الآن مَعلمة الإخراج الخاصة بها للسماح بتسلسل استدعاء الدوال، بما يتوافق مع الطرق الأخرى في Ink. تم نقل واجهة TextureBitmapStore من وحدة العرض إلى وحدة الفرشاة. تم إنشاء BoxAccumulator.populateFrom لتلقّي Box غير قابل للتعديل وقابل للقيم الخالية بدلاً من BoxAccumulator قابل للتعديل، ولتوضيح ما يتم تعديله، على المتصلين تغيير boxAccumulator.add(other) إلى boxAccumulator.add(other.box). تمت إزالة BrushUtil.toBuilderWithAndroidColor/createBuilderWithAndroidColor، لذا يُرجى استخدام setAndroidColor من Brush.Builder بعد الإنشاء بدلاً من ذلك. (Ia7155)
• أصبحت السمة التجريبية InProgressStrokesView.textureBitmapStore خاصة الآن. لا تزال هناك أدوات وصول عامة لهذه السمة. (I1d706)

إصلاح الأخطاء

• تحسين الأداء للفرش المخصّصة التي تحتوي على العديد من الجسيمات

الإصدار 1.0.0-alpha04

‫9 أبريل 2025

تم طرح androidx.ink:ink-*:1.0.0-alpha04. يتضمّن الإصدار 1.0.0-alpha04 هذه التعديلات.

الميزات الجديدة

• تتضمّن واجهات برمجة تطبيقات تجريبية جديدة لعناصر BrushFamily مخصّصة، ما يتيح استخدام فُرش جديدة، مثل "قلم الرصاص" و"مؤشر الليزر". تتيح واجهة برمجة التطبيقات تحميل الفرش المحدّدة بواسطة هذا البروتوكول. (I8809a)

الإصدار 1.0.0-alpha03

‫12 فبراير 2025

تم طرح androidx.ink:ink-*:1.0.0-alpha03. يتضمّن الإصدار 1.0.0-alpha03 هذه التعديلات.

الميزات الجديدة

• توفير مساحة على القرص والشبكة: تسلسل StrokeInputBatch، ما يؤدي إلى توفير العديد من أسطر الرمز البرمجي، مع كون الكائنات الناتجة جزءًا صغيرًا من حجم الضربات المخزّنة عادةً. (Ie898d)
• تحديد باستخدام أداة التحديد الحر: فرشاة خط متقطّع لرسم خط التحديد، ودالة لتحويل خط التحديد إلى PartitionedMesh من أجل طلبات البحث عن الأشكال الهندسية (Ia38a0)

الإصدار 1.0.0-alpha02

‫11 ديسمبر 2024

تم طرح androidx.ink:ink-*:1.0.0-alpha02. يتضمّن الإصدار 1.0.0-alpha02 هذه التعديلات.

تغييرات واجهة برمجة التطبيقات

• إصلاحات أخطاء متنوّعة (I05dd8)

المساهمة الخارجية

• إيقاف BuildCompat.isAtLeastV بدلاً من ذلك، يجب أن يتحقّق المتصلون من SDK_INT مقابل 35 مباشرةً. (I294d1)

الإصدار 1.0.0-alpha01

‫2 أكتوبر 2024

تم طرح androidx.ink:ink-*:1.0.0-alpha01. يتضمّن الإصدار 1.0.0-alpha01 هذه التعديلات.

الميزات الجديدة

• مكتبة معيارية وقابلة للضبط لتسهيل إنشاء ضربات حبر جميلة وعرضها ومعالجتها في تطبيقك

تغييرات واجهة برمجة التطبيقات

وحدات جديدة لمساعدة المطوّرين في إنشاء تجارب كتابة غنية:

• إنشاء المحتوى: استخدِم InProgressStrokesView لعرض ضربات الفرشاة في الوقت الفعلي بأداء عالٍ ووقت استجابة منخفض عند تلقّي المدخلات.
• العرض: استخدِم CanvasStrokeRenderer وViewStrokeRenderer لرسم ضربات الحبر المكتملة كجزء من واجهة مستخدم التطبيق.
• الضربات: أنواع البيانات الأساسية المستخدَمة في ميزات الكتابة بالحبر
• الفرشاة: مواصفات قابلة للضبط حول شكل ضربات الفرشاة وطريقة عملها استجابةً لبيانات المستخدم.
• الأشكال الهندسية: عمليات هندسية مثل التقاطع والتغطية لتشغيل أدوات مثل التحديد والمحو