ציור

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

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

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

dependencies {
  
    implementation "androidx.ink:ink-authoring:1.0.0-beta02"
    implementation "androidx.ink:ink-brush:1.0.0-beta02"
    implementation "androidx.ink:ink-geometry:1.0.0-beta02"
    implementation "androidx.ink:ink-nativeloader:1.0.0-beta02"
    implementation "androidx.ink:ink-rendering:1.0.0-beta02"
    implementation "androidx.ink:ink-strokes:1.0.0-beta02"
    
}

dependencies {


    implementation("androidx.ink:ink-authoring:1.0.0-beta02")
    implementation("androidx.ink:ink-brush:1.0.0-beta02")
    implementation("androidx.ink:ink-geometry:1.0.0-beta02")
    implementation("androidx.ink:ink-nativeloader:1.0.0-beta02")
    implementation("androidx.ink:ink-rendering:1.0.0-beta02")
    implementation("androidx.ink:ink-strokes:1.0.0-beta02")
}

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

משוב

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

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

מידע נוסף זמין במאמרי העזרה בנושא הכלי למעקב אחר בעיות.

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

גירסה 1.0

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