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