حبر

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

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

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

dependencies {
  
    implementation "androidx.ink:ink-authoring:1.1.0-alpha09"
    implementation "androidx.ink:ink-authoring-compose:1.1.0-alpha09"
    implementation "androidx.ink:ink-brush:1.1.0-alpha09"
    implementation "androidx.ink:ink-brush-compose:1.1.0-alpha09"
    implementation "androidx.ink:ink-geometry:1.1.0-alpha09"
    implementation "androidx.ink:ink-geometry-compose:1.1.0-alpha09"
    implementation "androidx.ink:ink-nativeloader:1.1.0-alpha09"
    implementation "androidx.ink:ink-rendering:1.1.0-alpha09"
    implementation "androidx.ink:ink-storage:1.1.0-alpha09"
    implementation "androidx.ink:ink-strokes:1.1.0-alpha09"
    
}

dependencies {


    implementation("androidx.ink:ink-authoring:1.1.0-alpha09")
    implementation("androidx.ink:ink-authoring-compose:1.1.0-alpha09")
    implementation("androidx.ink:ink-brush:1.1.0-alpha09")
    implementation("androidx.ink:ink-brush-compose:1.1.0-alpha09")
    implementation("androidx.ink:ink-geometry:1.1.0-alpha09")
    implementation("androidx.ink:ink-geometry-compose:1.1.0-alpha09")
    implementation("androidx.ink:ink-nativeloader:1.1.0-alpha09")
    implementation("androidx.ink:ink-rendering:1.1.0-alpha09")
    implementation("androidx.ink:ink-storage:1.1.0-alpha09")
    implementation("androidx.ink:ink-strokes:1.1.0-alpha09")
}

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

الملاحظات

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

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

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

Ink Version 1.1

الإصدار ‎1.1.0-alpha09

‫23 سبتمبر 2026

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

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

• تغيير "تغيير لون الفرشاة" ليعمل في مساحة ألوان Oklab، ما يحافظ بشكل أفضل على درجة السطوع المدرَكة في تغييرات الألوان تمت إعادة تسمية واجهات برمجة التطبيقات SATURATION وLUMINOSITY الخاصة بميزة "التحريك بالفرشاة" لتصبح CHROMA وLIGHTNESS على التوالي. (I0ed42)

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

• تم تعديل الاعتمادية androidx.lifecycle:lifecycle-runtime إلى الإصدار 2.10.0. هذا الإصدار مطلوب لتشغيل عمليات التحقّق من أخطاء lint المجمَّعة في وقت التشغيل لدورة الحياة مع الإصدار 9.5.0-alpha04 أو إصدار أحدث من "مكوّن Android الإضافي لبرنامج Gradle". (I99bfd، b/556807521)

الإصدار ‎1.1.0-alpha08

‫9 سبتمبر 2026

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

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

• إضافة إمكانية عرض KMP iOS من خلال MetalRenderer، ضمن التعليق التوضيحي ExperimentalInkCrossPlatformRenderingApi الذي يتطلّب الموافقة، استنادًا إلى واجهات KMP الشائعة للوظيفة الأساسية
• تمّت إعادة تسمية Target.TEXTURE_ANIMATION_PROGRESS_OFFSET إلى Target.PAINT_ANIMATION_PROGRESS_OFFSET. (I8809f)
• إضافة أحمال زائدة ImmutableAffineTransform.translate(float x, float, y) و MutableAffineTransform populateFromTranslation(float x, float y) (I8809f)
• إعادة تسمية الموقع DampingNode من dampingSource إلى dampOver (Id3178)
• إعادة تسمية الموقع DampingNode من dampingGap إلى strength (I69432)
• استخدِم النوع Vec عند تحديد EasingFunction.CubicBezier بدلاً من Float (I69432)
• إضافة تعليق توضيحي WorkerThread إلى وظائف الممحاة لتعديل الشبكة Stroke.subtract وStroke.split (I69432)

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

• جعل عيّنات Brush متوافقة مع KMP (I77125)

الإصدار ‎1.1.0-alpha07

‫12 أغسطس 2026

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

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

• إصلاح مشكلة تراجع الأداء التي تؤثر في فُرش الجزيئات الكثيفة، وتعديل ثوابت Brush.Version استنادًا إلى ملاحظات واجهة برمجة التطبيقات (I87f0f)

الإصدار ‎1.1.0-alpha06

‫29 يوليو 2026

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

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

• تمت إضافة طرق calculateMinimumRequiredVersion إلى واجهة برمجة التطبيقات للأنواع الفرعية BrushFamily. (I338c9)
• عرض حقول مكوّن AffineTransform (Ic2ec3)
• إصلاح تسرب الذاكرة في InProgressStrokesView، وتحسين العيوب المرئية التجريبية لممحاة الأجزاء، وتحسين تمثيل protobuf لطبقات نسيج الفرشاة المخصّصة (I6ff86)
• إضافة أداة إنشاء تهيئة للنوع MutableAffineTransform (لتتوافق مع ImmutableAffineTransform) (I96ec7)
• إضافة InProgressStroke.clear (Ie0032)
• إضافة طرق toImmutable إلى بنى البيانات مع فئات فرعية قابلة للتغيير وغير قابلة للتغيير (I53835)
• نقل بيانات KMP (Icbf38، b/521850119، b/534309122)

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

• إضافة المزيد من الميزات المتعلّقة بإصدارات الفرشاة والرسومات المتحرّكة الخاصة بالنسيج (Iea9ba)

الإصدار ‎1.1.0-alpha05

‫15 يوليو 2026

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

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

• إصدار تجريبي من نوع ممحاة جديد يُعرف باسم "الممحاة الجزئية" أو "تعديل الشبكة" أو "ممحاة البكسل"، وهو يعدّل هندسة الضربة ويقسمها بدلاً من حذف الضربات بأكملها أو إخفائها بلون الخلفية. تشمل المشاكل المعروفة عدم توفّر ميزة "التنعيم" على الحواف المقطوعة، وعدم توفّر واجهات برمجة تطبيقات نشر على نحو متسلسِل لحفظ نتائج PartitionedMesh التي تم محوها، وسيتم توفير كلتا الميزتين في الإصدارات المستقبلية.
• أضِف تعليق Throws التوضيحي الناقص إلى StrokeInputBatchSerialization.decode، ما يتطلّب تحديثًا من مستخدمي Java لهذا الإجراء. (I83473، b/522256938)

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

• إصلاح عُطل أصلي ناتج عن مشكلة في الدقة العددية (I2e1f0 و6618e69 وb/523190724)
• تجاهل الأشكال الهندسية المتدهورة في BrushTipExtruder (469b629)
• حلّ المشاكل في RejectedExecutionException في InProgressStrokesView (b/526696762)

الإصدار 1.1.0-alpha04

‫17 يونيو 2026

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

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

• إصلاح مشاكل دقة الفاصلة العائمة التي تؤدي إلى تشوّهات مرئية في اللمسات النهائية، ما يؤثر في أجهزة معيّنة بعد ترقية نظام التشغيل

• إضافة واجهة برمجة تطبيقات KMP-common لوحدة التخزين (التحويل من/إلى ByteArray بدلاً من Java InputStream/OutputStream)

• أضِف خاصية BrushBehavior.developerComment لتخزين البيانات الوصفية التي تشرح تصميم مجموعة فرش مخصّصة. وهي مخصّصة لدعم واجهة مستخدم "مصمّم الفرشاة".

• تم إصلاح خطأ في عمليات التحقّق من اتساق سلاسل المحادثات في CanvasInProgressStrokesRenderHelperV33.

• تم إصلاح بعض الأخطاء في معالجة الحقول الاختيارية MotionEvent (مثل الميل والضغط).

• تحسين مستندات واجهة برمجة التطبيقات الخاصة بالفرشاة المخصّصة

• أضِف أنواع BrushPaint.ColorFunction جديدة.

الإصدار ‎1.1.0-alpha03

‫19 مايو 2026

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

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

• إتاحة واجهة برمجة التطبيقات لتخصيص فرشاة الحبر آليًا للجميع (I8e2e1)
• تقسيم BrushPaint.TextureLayer إلى فئات فرعية أكثر تحديدًا (I8848a)

الإصدار ‎1.1.0-alpha02

‫22 أبريل 2026

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

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

• عرض حمل زائد من BrushFamily.decode يحدّد الحد الأقصى للتوافق مع الإصدار (I1c7bc)
• إخراج واجهة برمجة التطبيقات الخاصة بالتسلسل BrushFamily من المرحلة التجريبية (Idd16e)

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

• تم إصلاح مشكلة الوميض عند استخدام InProgressStrokesView.maskPath على أجهزة معيّنة (I1c7bc، b/496920044)

الإصدار ‎1.1.0-alpha01

‫11 مارس 2026

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

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

• إصلاحات متنوّعة لأخطاء بسيطة

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

• إضافة InProgressShape.isCanceled، وإصلاح مشاكل التزامن في وحدة التأليف (Ibfd32، b/474385518، b/470695777)
• إتاحة إصدار بدون وسيطة من CanvasStrokeRenderer.create وInProgressStroke.updateShape للغة Java (Id80a1، b/457715938)

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

• إصلاح خطأ يؤدي إلى حدوث أعطال في InProgressStrokesView بعد فصل/إعادة ربط النافذة في الإصدارات من 29 إلى 32 من واجهة برمجة التطبيقات، والسماح لعمليات Vec باستخدام MutableVec نفسه كمدخل ومخرج، ودمج إعدادات Proguard في ملف واحد (Ia4da0)
• زيادة الاعتماد على graphics-core إلى الإصدار 1.0.4 (Ibfa18)

الإصدار 1.0

الإصدار 1.0.0

‫17 ديسمبر 2025

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

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

• زيادة الاعتماد على graphics-core إلى الإصدار 1.0.4 (Ibfa18)

الإصدار ‎1.0.0-rc01

‫3 ديسمبر 2025

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

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

• تعديل إصدار الحزمة التابعة (Iecd04)

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