דיו

  
לעודד פיתוח של אפליקציות מעולות לשימוש בעט. הורדת חסמי הכניסה למפתחים כדי ליצור חוויות כתיבה יפות ואיכותיות. תומך ב-Android, ב-iOS (גרסה 15.0 ומעלה) וב-JVM (ב-Linux x86-64 וב-ARM64 וב-Mac ARM64).
העדכון האחרון גרסה יציבה גרסה מועמדת להפצה גרסת בטא גרסת אלפא
‫18 בנובמבר 2026 1.0.0 - - ‎1.1.0-alpha12

הצהרה על יחסי תלות

כדי להוסיף תלות ב-Ink, צריך להוסיף לפרויקט את מאגר Google Maven. מידע נוסף זמין במאמר מאגר ה-Maven של Google.

אתם יכולים להוסיף את יחסי התלות של הארטיפקטים שאתם צריכים בקובץ build.gradle של האפליקציה או המודול:

Groovy

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

Kotlin

dependencies {


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

מידע נוסף זמין במאמר הוספת יחסי תלות ב-build.

משוב

המשוב שלכם עוזר לנו לשפר את Jetpack. נשמח לדעת אם גיליתם בעיות חדשות או אם יש לכם רעיונות איך לשפר את הספרייה הזו. כדאי לעיין בבעיות הידועות בספרייה הזו לפני שמדווחים על בעיה. כדי להוסיף הצבעה בדיווח על בעיה קיימת, לוחצים על כפתור הכוכב.

יצירת דיווח על בעיה חדשה

מידע נוסף זמין במאמרי העזרה בנושא Issue Tracker.

גרסה 1.1 של Ink

גרסה ‎1.1.0-alpha12

‫18 בנובמבר 2026

‫androidx.ink:ink-*:1.1.0-alpha12 מופץ. גרסה ‎1.1.0-alpha12 מכילה את השמירות האלה.

שינויים ב-API

  • הוספת עומסי יתר של שיטות Ink InProgressShapesView לקווים לא גמורים ממכשיר ספציפי (I9c945)
  • תמיכה בכמה מכשירים לקליטת נתונים בו-זמנית במודול ליצירת דיו (I41ee5)
  • הוספת תמיכה ב-JVM של linux-aarch64‏ (I752e5,‏ I1216b)

תיקוני באגים

  • הגבלת משך הזמן של צורת הקו כך שיהיה לא שלילי ומונוטוני (I752e5,‏ b/552666754)
  • משנים את קצב הפריימים המבוקש של CanvasInProgressStrokesRenderHelperV33 ל-720F. (I752e5)
  • עדכון של התלות של ink-authoring ו-ink-authoring-compose ב-input-motionprediction (Ib84ef)

גרסה ‎1.1.0-alpha11

‫4 בנובמבר 2026

‫androidx.ink:ink-*:1.1.0-alpha11 מופץ. גרסה ‎1.1.0-alpha11 מכילה את השמירות האלה.

שינויים ב-API

  • הוספת ממשקי API ניסיוניים של Ink לחישוב או לאחסון של היסטים של פאזות לקווים עם טקסטורות מונפשות (I620e6)
  • הוספת ממשקי API ניסיוניים של מברשת דיו כדי לציין טקסטורת צבע מונפשת (If0f10)
  • סריאליזציה של צורת קו (PartitionedMesh), כדי לשמור קווים שנמחקו חלקית או כדי לטעון מסמכים מהר יותר על ידי שמירת נתוני רשת (I1604f)

תיקוני באגים

  • תוקן הטיפול בקלט בו-זמני, ושופרה התאימות לסיבוב העט. (I0fc23)

‫גרסה 1.1.0-alpha10

‫21 באוקטובר 2026

‫androidx.ink:ink-*:1.1.0-alpha10 מופץ. גרסה ‎1.1.0-alpha10 מכילה את השמירות האלה.

תיקוני באגים

  • הוספת החלקת קצוות (anti-aliasing) לקצוות חתוכים של קווים שנערכו באמצעות מחק הקווים החלקי (Stroke.subtract, ואחריו Stroke.split, אם רוצים)

גרסה 1.1.0-alpha09

‫23 בספטמבר 2026

‫androidx.ink:ink-*:1.1.0-alpha09 מופץ. גרסה ‎1.1.0-alpha09 מכילה את השמירות האלה.

שינויים ב-API

  • שינוי הצבע של המברשת פועל במרחב הצבעים Oklab, ששומר טוב יותר על הבהירות הנתפסת בשינויי הגוון. שינינו את השם של ממשקי ה-API של SATURATION ו-LUMINOSITY ל-CHROMA ו-LIGHTNESS בהתאמה. (I0ed42)

תיקוני באגים

  • התלות androidx.lifecycle:lifecycle-runtime עודכנה לגרסה 2.10.0. הגרסה הזו נדרשת כדי להריץ בדיקות lint של זמן ריצה של מחזור חיים בחבילה עם AGP בגרסה 9.5.0-alpha04 ואילך. (I99bfd,‏ b/556807521)

גרסה 1.1.0-alpha08

‫9 בספטמבר 2026

‫androidx.ink:ink-*:1.1.0-alpha08 מופץ. גרסה ‎1.1.0-alpha08 מכילה את השמירות האלה.

שינויים ב-API

  • הוספת תמיכה ברינדור ל-KMP iOS דרך MetalRenderer, במסגרת ההערה להבעת הסכמה ExperimentalInkCrossPlatformRenderingApi, על סמך ממשקי API נפוצים של 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)

תיקוני באגים

  • הוספת תאימות ל-KMP לדוגמאות של Brush (I77125)

גרסה ‎1.1.0-alpha07

‫12 באוגוסט 2026

‫androidx.ink:ink-*:1.1.0-alpha07 מופץ. גרסה ‎1.1.0-alpha07 מכילה את השמירות האלה.

שינויים ב-API

  • תוקנה רגרסיה בביצועים שמשפיעה על מברשות חלקיקים צפופות, עודכנו קבועי Brush.Version על סמך משוב על ה-API (I87f0f)

גרסה 1.1.0-alpha06

‫29 ביולי 2026

‫androidx.ink:ink-*:1.1.0-alpha06 מופץ. גרסה ‎1.1.0-alpha06 מכילה את השמירות האלה.

שינויים ב-API

  • נוספו שיטות calculateMinimumRequiredVersion ל-API עבור סוגי משנה של BrushFamily. (I338c9)
  • חשיפת שדות של רכיב AffineTransform‏ (Ic2ec3)
  • תיקון דליפת זיכרון ב-InProgressStrokesView, שיפור פריטי מידע שגויים (artifacts) חזותיים ניסיוניים של מחק חלקי, שיפור ייצוג 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 מכילה את השמירות האלה.

שינויים ב-API

  • גרסה ניסיונית של סוג מחק חדש, שנקרא "מחיקת קו חלקית", "עריכת רשת" או "מחיקת פיקסלים". המחק הזה עורך את הגיאומטריה של הקו ומפצל קווים במקום למחוק קווים שלמים או להסתיר אותם באמצעות צבע הרקע. הבעיות הידועות כוללות היעדר של החלקת קצוות (anti-aliasing) בקצוות החתוכים, והיעדר של ממשקי API לסריאליזציה כדי לשמור את התוצאות של 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 מכילה את השמירות האלה.

שינויים ב-API

  • תוקנו בעיות שקשורות לדיוק של נקודה צפה (floating point) שגרמו לפגמים חזותיים במשיכות מכחול שהושלמו, והשפיעו על מכשירים מסוימים אחרי שדרוגים של מערכת ההפעלה

  • הוספת API מסוג KMP-common למודול האחסון (מעבר אל/מ-ByteArray במקום InputStream/OutputStream של Java).

  • מוסיפים מאפיין BrushBehavior.developerComment שיכיל מטא-נתונים שמסבירים את העיצוב של משפחת המברשות בהתאמה אישית. הוא נועד לתמוך בממשק המשתמש של Brush Designer.

  • תיקון באג בבדיקות העקביות של השרשורים ב-CanvasInProgressStrokesRenderHelperV33.

  • תיקון כמה באגים בטיפול בשדות אופציונליים של MotionEvent (למשל, הטיה, לחץ).

  • שיפור התיעוד של API למברשות בהתאמה אישית.

  • הוספת סוגים חדשים של BrushPaint.ColorFunction.

גרסה 1.1.0-alpha03

‫19 במאי 2026

‫androidx.ink:ink-*:1.1.0-alpha03 מופץ. גרסה ‎1.1.0-alpha03 מכילה את השמירות האלה.

שינויים ב-API

  • הפיכת ה-API הפרוגרמטי להתאמה אישית של מברשת הדיו לציבורי (I8e2e1)
  • פיצול BrushPaint.TextureLayer למחלקות משנה ספציפיות יותר (I8848a)

גרסה ‎1.1.0-alpha02

‫22 באפריל 2026

‫androidx.ink:ink-*:1.1.0-alpha02 מופץ. גרסה ‎1.1.0-alpha02 מכילה את השמירות האלה.

שינויים ב-API

  • חשיפת עומס יתר של BrushFamily.decode שמציין תאימות לגרסה מקסימלית (I1c7bc)
  • ‫API של סריאליזציה של BrushFamily עבר משלב הניסוי (Idd16e)

תיקוני באגים

  • תיקון הבהוב כשמשתמשים ב-InProgressStrokesView.maskPath במכשירים מסוימים (I1c7bc,‏ b/496920044)

גרסה 1.1.0-alpha01

‫11 במרץ 2026

‫androidx.ink:ink-*:1.1.0-alpha01 מופץ. גרסה 1.1.0-alpha01 מכילה את השמירות האלה.

תכונות חדשות

  • תיקוני באגים קטנים שונים

שינויים ב-API

  • הוספת InProgressShape.isCanceled, פתרון בעיות בו-זמניות (concurrency) במודול העריכה. (Ibfd32,‏ b/474385518,‏ b/470695777)
  • חשיפת גרסה ללא ארגומנטים של CanvasStrokeRenderer.create ו-InProgressStroke.updateShape ל-Java‏ (Id80a1,‏ b/457715938)

תיקוני באגים

  • תיקון באג שגורם לקריסות ב-InProgressStrokesView אחרי ניתוק/חיבור מחדש מהחלון ל-API 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 מכילה את השמירות האלה.

שינויים ב-API

  • ממשקי API ניסיוניים של צורות בהתאמה אישית עם זמן אחזור קצר, תיקוני באגים שונים (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
  • הטמעה משופרת של החלקת קלט של משיכות, שמבטלת את רעשי המדידה של המכשיר אבל משקפת בצורה מדויקת יותר את קלט המשתמש בהשוואה להטמעה הקודמת של החלקת קלט של משיכות
  • עקביות משופרת עם ממשקי API אחרים של Android או Jetpack ליחידות זווית (מעלות לעומת רדיאנים), טרנספורמציות (הטיה לעומת גזירה) ועוד

שינויים ב-API

  • שינוי של API שקשור לזווית כדי להשתמש במעלות ולכלול יחידה בשמות, הבהרה לגבי יחידות בכלי עזר להמרת זווית ותמיכה גם במעלות וגם ברדיאנים, שינוי של API של StockBrushes כדי לקבל גרסת מברשת סטנדרטית כפרמטר של פונקציית מפעל וחשיפת בקרת התנהגות של חפיפה עצמית למברשות הדגשה, שינוי השם של MutableAffineTransform.populateFromTranslate ל-populateFromTranslation, הסרה של InProgressStrokesView.setRenderFactory/getRenderFactory. (Id9eab,‏ b/436656418)
  • שינוי השם של shear ל-skew, הבהרה של חלק מהמסמכים, הסרת 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 מכילה את השמירות האלה.

תכונות חדשות

  • מברשת מרקר אמוג'י: מדגישים חלקים במסמך באמצעות כל אמוג'י שבוחרים, כדי להוסיף קצת כיף ולשמור על הסדר.
  • עוד ממשקי API של כלי עזר לצורות פרימיטיביות של מודול גיאומטריה
  • שיפור התאימות והביצועים של המכשיר

שינויים ב-API

  • ‫API פשוט יותר ל-InProgressStrokesView, ממשקי API של גיאומטריית גימור, מדגיש אימוג'י, הסרת פונקציות של מפעל מ-MutableParallelogram לטובת שיטות אכלוס, תמיכה ב-seed להתנהגויות אקראיות של מברשות. (I38280)

תיקוני באגים

  • תוקנה בעיה בביצועים ובעיה בעקביות של הצבעים במצב רטוב/יבש. (Ifcd1d)

גרסה ‎1.0.0-alpha05

‫18 ביוני 2025

‫androidx.ink:ink-*:1.0.0-alpha05 מופץ. גרסה ‎1.0.0-alpha05 מכילה את השמירות האלה.

תכונות חדשות

  • מודולים של יכולת פעולה הדדית של Compose ליצירה, למברשת ולגאומטריה

שינויים ב-API

  • מודולים וממשקי API חדשים של יכולת פעולה הדדית ב-Compose, ניקוי API‏ (I0e464)
  • השיטות של InProgressStroke.enqueueInputs/updateShape שהחזירו את kotlin.Result הוסרו, והלקוחות צריכים להשתמש במקומן ב-enqueueInputsOrThrow או ב-enqueueInputsOrIgnore, למשל. השם של InProgressStroke.getNeedsUpdate השתנה לשם isUpdateNeeded. הפונקציה InProgressStroke.populateOutlinePosition מחזירה עכשיו את פרמטר הפלט שלה כדי לאפשר שרשור קריאות, באופן עקבי עם שיטות אחרות ב-Ink. הממשק TextureBitmapStore מועבר מהמודול של העיבוד למודול של המברשת. ‫BoxAccumulator.populateFrom נועד לקבל Box שניתן להקצות לו ערך null ואינו ניתן לשינוי, במקום 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 מכילה את השמירות האלה.

תכונות חדשות

  • ממשקי API ניסיוניים חדשים לאובייקטים מותאמים אישית של BrushFamily, שמאפשרים להשתמש במברשות חדשות כמו עיפרון ומצביע לייזר. ה-API מאפשר לטעון מברשות שמוגדרות על ידי הפרוטוקול הזה. (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 מכילה את השמירות האלה.

שינויים ב-API

  • תיקוני באגים שונים. (I05dd8)

תרומה חיצונית

  • הוצאה משימוש של BuildCompat.isAtLeastV. במקום זאת, צריך לבדוק את SDK_INT ישירות מול 35. (I294d1)

גרסה 1.0.0-alpha01

‫2 באוקטובר 2024

‫androidx.ink:ink-*:1.0.0-alpha01 מופץ. גרסה 1.0.0-alpha01 מכילה את השמירות האלה.

תכונות חדשות

  • ספרייה מודולרית וניתנת להגדרה שמאפשרת ליצור, לעבד ולשנות בקלות משיכות דיו יפות שנוצרו באפליקציה.

שינויים ב-API

מודולים חדשים שעוזרים למפתחים ליצור חוויות עשירות של כתיבה בדיו:

  • יצירה: אפשר להשתמש ב-InProgressStrokesView כדי לרנדר קווים בזמן אמת עם ביצועים גבוהים וזמן אחזור קצר, כשהקלט מתקבל.
  • רינדור: משתמשים ב-CanvasStrokeRenderer וב-ViewStrokeRenderer כדי לצייר את קווי הדיו המוגמרים כחלק מממשק המשתמש של האפליקציה.
  • משיכות: סוגי נתונים בסיסיים שמשמשים לתכונות של כתיבה בדיו.
  • מברשת: מפרט שניתן להגדיר, שקובע איך הקווים ייראו ויפעלו בתגובה לקלט של המשתמש.
  • גיאומטריה: פעולות גיאומטריות כמו חיתוך וכיסוי, כדי להפעיל כלים כמו בחירה ומחיקה.