ציור

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

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

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

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

dependencies {


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

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

משוב

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

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

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

אין הערות לגבי הגרסה של הארטיפקט הזה.

גרסה 1.1

גרסה ‎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, אפשרנו לפעולות של 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 מכילה את השמירות האלה.

תיקוני באגים

• תיקוני באגים לקראת גרסת בטא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 לגימור גיאומטריה, הדגשת אמוג'י, הסרת פונקציות factory מ-MutableParallelogram לטובת שיטות populate, תמיכה ב-seed להתנהגויות אקראיות של מברשות. (I38280)

תיקוני באגים

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

גרסה ‎1.0.0-alpha05

‫18 ביוני 2025

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

תכונות חדשות

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

שינויים ב-API

• מודולים חדשים של יכולת פעולה הדדית של Compose וממשקי API, ניקוי של ממשקי API (I0e464)
• הוסרו methods של InProgressStroke.enqueueInputs/updateShape שהחזירו kotlin.Result. במקום זאת, לקוחות צריכים להשתמש ב-methods כמו 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 כדי לצייר את קווי הדיו המוגמרים כחלק מממשק המשתמש של האפליקציה.
• משיכות מכחול: סוגי נתונים מרכזיים שמשמשים לתכונות של דיו דיגיטלי.
• מכחול: הגדרה של המראה וההתנהגות של הקווים בתגובה לקלט של המשתמש.
• גיאומטריה: פעולות גיאומטריות כמו חיתוך וכיסוי, שמשמשות כלים כמו בחירה ומחיקה.