الريشة

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

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

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

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

dependencies {


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

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

الملاحظات

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

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

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

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

الإصدار 1.0

الإصدار 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 لرسم ضربات الحبر المكتملة كجزء من واجهة مستخدم التطبيق.
• الضربات: أنواع البيانات الأساسية المستخدَمة في ميزات الكتابة بالحبر
• الفرشاة: مواصفات قابلة للضبط حول شكل ضربات الفرشاة وطريقة تفاعلها مع البيانات التي يدخلها المستخدم.
• الأشكال الهندسية: عمليات هندسية مثل التقاطع والتغطية لتشغيل أدوات مثل التحديد والمحو