تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
الريشة
إلهام أفضل تطبيقات القلم تسهيل دخول المطوّرين إلى عالم تجارب الكتابة اليدوية الجميلة وعالية الأداء
آخر الأخبار |
الإصدار الثابت |
إصدار محتمل |
الإصدار التجريبي |
الإصدار الأوّلي |
13 أغسطس 2025 |
- |
- |
- |
1.0.0-alpha06 |
تعريف التبعيات
لإضافة تبعية على Ink، يجب إضافة مستودع Google Maven إلى مشروعك. اطّلِع على مستودع Maven من Google
لمزيد من المعلومات.
أضِف التبعيات الخاصة بالعناصر التي تحتاج إليها في ملف build.gradle
لتطبيقك أو وحدتك:
رائع
dependencies {
implementation "androidx.ink:ink-authoring:1.0.0-alpha06"
implementation "androidx.ink:ink-brush:1.0.0-alpha06"
implementation "androidx.ink:ink-geometry:1.0.0-alpha06"
implementation "androidx.ink:ink-nativeloader:1.0.0-alpha06"
implementation "androidx.ink:ink-rendering:1.0.0-alpha06"
implementation "androidx.ink:ink-strokes:1.0.0-alpha06"
}
Kotlin
dependencies {
implementation("androidx.ink:ink-authoring:1.0.0-alpha06")
implementation("androidx.ink:ink-brush:1.0.0-alpha06")
implementation("androidx.ink:ink-geometry:1.0.0-alpha06")
implementation("androidx.ink:ink-nativeloader:1.0.0-alpha06")
implementation("androidx.ink:ink-rendering:1.0.0-alpha06")
implementation("androidx.ink:ink-strokes:1.0.0-alpha06")
}
لمزيد من المعلومات حول العناصر التابعة، يُرجى الاطّلاع على إضافة عناصر تابعة للإنشاء.
الملاحظات
تساعدنا ملاحظاتك في تحسين Jetpack. يُرجى إعلامنا إذا اكتشفت مشاكل جديدة أو كانت لديك أفكار لتحسين هذه المكتبة. يُرجى الاطّلاع على
المشاكل الحالية
في هذه المكتبة قبل إنشاء مشكلة جديدة. يمكنك إضافة صوتك إلى مشكلة حالية من خلال النقر على زر النجمة.
إنشاء مشكلة جديدة
يُرجى الاطّلاع على مستندات Issue Tracker
للحصول على مزيد من المعلومات.
لا تتوفّر ملاحظات إصدار لهذا العنصر.
الإصدار 1.0
الإصدار 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
لرسم ضربات الحبر المكتملة كجزء من واجهة مستخدم التطبيق.
- الضربات: أنواع البيانات الأساسية المستخدَمة في ميزات الكتابة بالحبر
- الفرشاة: مواصفات قابلة للضبط حول شكل ضربات الفرشاة وطريقة عملها استجابةً لبيانات المستخدم.
- الأشكال الهندسية: عمليات هندسية مثل التقاطع والتغطية لتشغيل أدوات مثل التحديد والمحو
يخضع كل من المحتوى وعيّنات التعليمات البرمجية في هذه الصفحة للتراخيص الموضحّة في ترخيص استخدام المحتوى. إنّ Java وOpenJDK هما علامتان تجاريتان مسجَّلتان لشركة Oracle و/أو الشركات التابعة لها.
تاريخ التعديل الأخير: 2025-08-13 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-08-13 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# ink\n===\n\nAPI Reference \n[androidx.ink.authoring](/reference/kotlin/androidx/ink/authoring/package-summary) \n[androidx.ink.authoring.compose](/reference/kotlin/androidx/ink/authoring/compose/package-summary) \n[androidx.ink.brush](/reference/kotlin/androidx/ink/brush/package-summary) \n[androidx.ink.brush.compose](/reference/kotlin/androidx/ink/brush/compose/package-summary) \n[androidx.ink.geometry](/reference/kotlin/androidx/ink/geometry/package-summary) \n[androidx.ink.geometry.compose](/reference/kotlin/androidx/ink/geometry/compose/package-summary) \n[androidx.ink.android.canvas](/reference/kotlin/androidx/ink/rendering/android/canvas/package-summary) \n[androidx.ink.android.view](/reference/kotlin/androidx/ink/rendering/android/view/package-summary) \n[androidx.ink.strokes](/reference/kotlin/androidx/ink/strokes/package-summary) \nInspire best-in-class pen apps. Lower the developer barrier to entry for high performance, beautiful inking experiences. \n\n| Latest Update | Stable Release | Release Candidate | Beta Release | Alpha Release |\n|-----------------|----------------|-------------------|--------------|---------------------------------------------------------------|\n| August 13, 2025 | - | - | - | [1.0.0-alpha06](/jetpack/androidx/releases/ink#1.0.0-alpha06) |\n\nDeclaring dependencies\n----------------------\n\nTo add a dependency on Ink, you must add the Google Maven repository to your\nproject. Read [Google's Maven repository](/studio/build/dependencies#google-maven)\nfor more information.\n\nAdd the dependencies for the artifacts you need in the `build.gradle` file for\nyour app or module: \n\n### Groovy\n\n```groovy\ndependencies {\n \n implementation \"androidx.ink:ink-authoring:1.0.0-alpha06\"\n implementation \"androidx.ink:ink-brush:1.0.0-alpha06\"\n implementation \"androidx.ink:ink-geometry:1.0.0-alpha06\"\n implementation \"androidx.ink:ink-nativeloader:1.0.0-alpha06\"\n implementation \"androidx.ink:ink-rendering:1.0.0-alpha06\"\n implementation \"androidx.ink:ink-strokes:1.0.0-alpha06\"\n \n}\n```\n\n### Kotlin\n\n```kotlin\ndependencies {\n\n\n implementation(\"androidx.ink:ink-authoring:1.0.0-alpha06\")\n implementation(\"androidx.ink:ink-brush:1.0.0-alpha06\")\n implementation(\"androidx.ink:ink-geometry:1.0.0-alpha06\")\n implementation(\"androidx.ink:ink-nativeloader:1.0.0-alpha06\")\n implementation(\"androidx.ink:ink-rendering:1.0.0-alpha06\")\n implementation(\"androidx.ink:ink-strokes:1.0.0-alpha06\")\n}\n```\n\nFor more information about dependencies, see [Add build dependencies](/studio/build/dependencies).\n\nFeedback\n--------\n\nYour feedback helps make Jetpack better. Let us know if you discover new issues or have\nideas for improving this library. Please take a look at the\n[existing issues](https://issuetracker.google.com/issues?q=componentid:1662443%20status:open)\nin this library before you create a new one. You can add your vote to an existing issue by\nclicking the star button.\n\n[Create a new issue](https://issuetracker.google.com/issues/new?component=1662443&template=2055047)\n\nSee the [Issue Tracker documentation](https://developers.google.com/issue-tracker)\nfor more information.\n\nThere are no release notes for this artifact.\n\nVersion 1.0\n-----------\n\n### Version 1.0.0-alpha06\n\nAugust 13, 2025\n\n`androidx.ink:ink-*:1.0.0-alpha06` is released. Version 1.0.0-alpha06 contains [these commits](https://android.googlesource.com/platform/frameworks/support/+log/e8af6ab7417811bf386c52a59ab5d0b94d194eeb..c359e97fece91f3767a7d017e9def23c7caf1f53/ink).\n\n**New Features**\n\n- Emoji highlighter stock brush: Highlight parts of a document with any emoji you choose, to add a fun flair and help stay organized.\n- More helper APIs for geometry module primitive shapes\n- Improve device compatibility and performance\n\n**API Changes**\n\n- Simplified API for `InProgressStrokesView`, finish geometry APIs, emoji highlighter, remove factory functions from `MutableParallelogram` in favor of populate methods, support seed for randomized brush behaviors. ([I38280](https://android-review.googlesource.com/#/q/I38280146fca9a55b06d87a835670efdd012990e7))\n\n**Bug Fixes**\n\n- Fix a performance issue and a wet/dry color consistency issue. ([Ifcd1d](https://android-review.googlesource.com/#/q/Ifcd1da4081a01ba8165b4e8624219b1bd26bd248))\n\n### Version 1.0.0-alpha05\n\nJune 18, 2025\n\n`androidx.ink:ink-*:1.0.0-alpha05` is released. Version 1.0.0-alpha05 contains [these commits](https://android.googlesource.com/platform/frameworks/support/+log/4c37298a97c16270c139eb812ddadaba03e23a52..e8af6ab7417811bf386c52a59ab5d0b94d194eeb/ink).\n\n**New Features**\n\n- Compose interoperability modules for authoring, brush, and geometry modules\n\n**API Changes**\n\n- New Compose interoperability modules and APIs, API cleanup ([I0e464](https://android-review.googlesource.com/#/q/I0e4641822d568573fc8c7b3955a007a8ac9cd1c5))\n- `InProgressStroke.enqueueInputs/updateShape` methods which returned `kotlin.Result` are removed, clients should use e.g. `enqueueInputsOrThrow` or `enqueueInputsOrIgnore` instead. `InProgressStroke.getNeedsUpdate` is renamed to `isUpdateNeeded`. `InProgressStroke.populateOutlinePosition` now returns its output parameter to allow call chaining, consistent with other methods in Ink. The `TextureBitmapStore` interface is moved from the rendering module to the brush module. `BoxAccumulator.populateFrom` is made to take a nullable immutable Box instead of a mutable `BoxAccumulator`, to make it clearer what is mutated, callers should change `boxAccumulator.add(other)` to `boxAccumulator.add(other.box)`. `BrushUtil.toBuilderWithAndroidColor/createBuilderWithAndroidColor` are removed, use the `setAndroidColor` of `Brush.Builder` after constructing instead. ([Ia7155](https://android-review.googlesource.com/#/q/Ia7155560602b8319183aa12671d7f1d925873448))\n- Previously experimental property `InProgressStrokesView.textureBitmapStore` is now private. There are still public accessors for this property. ([I1d706](https://android-review.googlesource.com/#/q/I1d7064ff25c953066a4b43a6c30a4b3aa0b145d5))\n\n**Bug Fixes**\n\n- Improved performance for custom brushes containing many particles.\n\n### Version 1.0.0-alpha04\n\nApril 9, 2025\n\n`androidx.ink:ink-*:1.0.0-alpha04` is released. Version 1.0.0-alpha04 contains [these commits](https://android.googlesource.com/platform/frameworks/support/+log/24c00eb294d9cda579d8d6e48a29497fe0f8d3f7..4c37298a97c16270c139eb812ddadaba03e23a52/ink).\n\n**New Features**\n\n- Introduces new experimental APIs for custom `BrushFamily` objects, enabling new brushes like Pencil and Laser Pointer. The API allows for loading brushes defined by this proto. ([I8809a](https://android-review.googlesource.com/#/q/I8809a675a5527c1a7bc2f519e041a8af1ed693b3))\n\n### Version 1.0.0-alpha03\n\nFebruary 12, 2025\n\n`androidx.ink:ink-*:1.0.0-alpha03` is released. Version 1.0.0-alpha03 contains [these commits](https://android.googlesource.com/platform/frameworks/support/+log/46295bc0b75a16f452e8e0090e8de41073d4dbb6..24c00eb294d9cda579d8d6e48a29497fe0f8d3f7/ink).\n\n**New Features**\n\n- Disk and network size savings: Serialization of `StrokeInputBatch`, saving many lines of code, with the resulting objects a tiny fraction of the size of traditionally stored strokes. ([Ie898d](https://android-review.googlesource.com/#/q/Ie898d91e3c77eccbf26e9ee6d7f384a3a57b974f))\n- Lasso selection: dashed line brush to draw a selection stroke, and a function to turn the selection stroke into a `PartitionedMesh` for geometry queries. ([Ia38a0](https://android-review.googlesource.com/#/q/Ia38a0e3e7a2da344d978bdfd5b8db8210a753e74))\n\n### Version 1.0.0-alpha02\n\nDecember 11, 2024\n\n`androidx.ink:ink-*:1.0.0-alpha02` is released. Version 1.0.0-alpha02 contains [these commits](https://android.googlesource.com/platform/frameworks/support/+log/b6ae8d0a0e8cd803f7b84f30101eda1af4f1d6b6..46295bc0b75a16f452e8e0090e8de41073d4dbb6/ink).\n\n**API Changes**\n\n- Assorted bug fixes. ([I05dd8](https://android-review.googlesource.com/#/q/I05dd84cb83c29b6f8af876164c426fee57f6f932))\n\n**External Contribution**\n\n- Deprecate `BuildCompat.isAtLeastV`. Callers should check SDK_INT against 35 directly instead. ([I294d1](https://android-review.googlesource.com/#/q/I294d117a8fea924e7f1b739d52268a9a54be6db7))\n\n### Version 1.0.0-alpha01\n\nOctober 2, 2024\n\n`androidx.ink:ink-*:1.0.0-alpha01` is released. Version 1.0.0-alpha01 contains [these commits](https://android.googlesource.com/platform/frameworks/support/+log/b6ae8d0a0e8cd803f7b84f30101eda1af4f1d6b6/ink).\n\n**New Features**\n\n- A modular and configurable library to make it easy to create, render, and manipulate beautiful ink strokes authored in your application.\n\n**API Changes**\n\nNew modules to help developers build rich inking experiences:\n\n- Authoring: Use `InProgressStrokesView` for high-performance, low latency rendering of strokes in real time as inputs are received.\n- Rendering: Use `CanvasStrokeRenderer` and `ViewStrokeRenderer` to draw the finished ink strokes as part of an app's user interface.\n- Strokes: Core data types used for inking features.\n- Brush: Configurable specification of how strokes will look and act in response to user input.\n- Geometry: Geometric operations like intersection and coverage to power tools like selection and erasing."]]