דיו

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

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

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

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

dependencies {


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

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

משוב

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

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

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

גרסת הדיו 1.1

גרסה ‎1.1.0-alpha04

‫17 ביוני 2026

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

שינויים ב-API

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

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

• מוסיפים מאפיין 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)
• הוצאת BrushFamily serialization API מסטטוס ניסיוני (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, פותרים בעיות בו-זמניות במודול העריכה. ‫(Ibfd32, ‏ b/474385518, ‏ b/470695777)
• הצגת גרסה ללא ארגומנטים של CanvasStrokeRenderer.create ו-InProgressStroke.updateShape ל-Java ‏ (Id80a1, ‏ b/457715938)

תיקוני באגים

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

תיקוני באגים

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

תכונות חדשות

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

שינויים ב-API

• מודולים חדשים של יכולת פעולה הדדית של כתיבה וממשקי API, ניקוי של ממשקי 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)

External Contribution

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