הערה

חשיפת מטא נתונים שעוזרים לכלים ולמפתחים אחרים להבין את הקוד של האפליקציה.

בטבלה הזו מפורטים כל פריטי המידע בקבוצה androidx.annotation.

פריט מידע שנוצר בתהליך פיתוח (Artifact)	גרסה יציבה	גרסה מועמדת להפצה	גרסת בטא	גרסת אלפא
הערה	1.9.1	-	-	‎1.10.0-alpha01
annotation-experimental	1.5.1	‎1.6.0-rc01	-	-

הספרייה הזו עודכנה לאחרונה בתאריך: 11 במרץ 2026

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

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

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

Groovy

dependencies {
    implementation "androidx.annotation:annotation:1.9.1"
    // To use the Java-compatible @androidx.annotation.OptIn API annotation
    implementation "androidx.annotation:annotation-experimental:1.5.1"
}

Kotlin

dependencies {
    implementation("androidx.annotation:annotation:1.9.1")
    // To use the Java-compatible @androidx.annotation.OptIn API annotation
    implementation("androidx.annotation:annotation-experimental:1.5.1")
}

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

משוב

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

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

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

גרסה 1.10

גרסה ‎1.10.0-alpha01

‫11 במרץ 2026

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

תכונות חדשות

הפסקנו את התמיכה ביעדי KMP של iOS ו-Mac שמבוססים על x86

שינויים ב-API

נוספה הערה RequiresFlag לקוד שצריך להיות מוגבל לבדיקות של דגלים לפני פרסום (I77bba, ‏ b/479114442)
הוספת יעד ANNOTATION_TYPE אל RequiresApi ו-RequiresExtension (I0cb0d)
כדי להשתמש בפרויקטים שפורסמו עם Kotlin 2.0, צריך KGP 2.0.0 או גרסה חדשה יותר (Idb6b5,‏ b/344563182)
מדיניות שמירת הנתונים של @Discouraged עודכנה. (Id2f85, b/375937557)

גרסה 1.9

גרסה 1.9.1

‫30 באוקטובר 2024

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

תיקוני באגים

נוספה פלטפורמת יעד של JS. (I2310b)
עדכון גרסת Kotlin ל-1.9 (I1a14c)

גרסה 1.9.0

‫16 באוקטובר 2024

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

שינויים חשובים מאז גרסה 1.8.0

הוספנו תמיכה ביעדי Kotlin Multiplatform הבאים: watchosDeviceArm64, ‏ mingwX64, ‏ linuxArm64.

גרסה ‎1.9.0-rc01

‫2 באוקטובר 2024

‫androidx.annotation:annotation-*:1.9.0-rc01 מופץ. גרסה 1.9.0-rc01 לא כוללת שינויים מאז גרסת הבטא הקודמת.

גרסה ‎1.9.0-beta01

‫18 בספטמבר 2024

‫androidx.annotation:annotation-*:1.9.0-beta01 מופץ. גרסה ‎1.9.0-beta01 מכילה את השמירות האלה.

שינויים ב-API

הוספנו תמיכה ביעד פלטפורמה watchosDeviceArm64 (I1cc04, ‏ b/364652024)

גרסה ‎1.9.0-alpha03

‫4 בספטמבר 2024

‫androidx.annotation:annotation-*:1.9.0-alpha03 מופץ. גרסה ‎1.9.0-alpha03 לא כוללת שינויים מאז גרסת האלפא הקודמת.

גרסה ‎1.9.0-alpha02

‫21 באוגוסט 2024

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

תכונות חדשות

הוספת תמיכה בפלטפורמה mingwX64 (I461ca, ‏ b/349894318)
הוספת תמיכה בlinuxArm64 יעד של Kotlin Multiplatform. (I139d3, ‏ b/338268719)

גרסה ‎1.9.0-alpha01

‫26 ביוני 2024

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

External Contribution

נוספה תמיכה בlinuxArm64 יעד מולטי-פלטפורמה (תודה ל-Jake Wharton!)

גרסה 1.8

גרסה 1.8.2

‫7 באוגוסט 2024

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

תיקוני באגים

הוספת תמיכה בפלטפורמה mingwX64 (I461ca, b/349894318)

גרסה 1.8.1

‫24 ביולי 2024

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

תיקוני באגים

כולל יעדים נוספים של Kotlin Multiplatform: ‏ watchos, ‏ tvos.

גרסה 1.8.0

‫14 במאי 2024

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

שינויים חשובים מאז גרסה 1.7.0

הוספנו הערה @ReplaceWith כדי לציין תחליפים לממשקי API שהוצאו משימוש
ההערה @MainThread הועברה לקבוצת המקורות המשותפת.

גרסה ‎1.8.0-rc01

‫1 במאי 2024

‫androidx.annotation:annotation-*:1.8.0-rc01 מופץ. גרסה 1.8.0-rc01 לא כוללת שינויים מאז גרסת הבטא הקודמת.

גרסה ‎1.8.0-beta02

‫17 באפריל 2024

‫androidx.annotation:annotation-*:1.8.0-beta02 מופץ. גרסה ‎1.8.0-beta02 לא מכילה שינויים מאז הגרסה הקודמת.

גרסה ‎1.8.0-beta01

‫3 באפריל 2024

‫androidx.annotation:annotation-*:1.8.0-beta01 מופץ. גרסה ‎1.8.0-beta01 מכילה את השמירות האלה.

תכונות חדשות

ההערה ReplaceWith יציבה עכשיו ב-API, אבל בדיקת ה-lint המשויכת עם תיקון אוטומטי עדיין לא הושקה

גרסה ‎1.8.0-alpha02

‫20 במרץ 2024

הגרסה androidx.annotation:annotation-*:1.8.0-alpha02 הושקה ללא שינויים משמעותיים. גרסה ‎1.8.0-alpha02 מכילה את השמירות האלה.

גרסה ‎1.8.0-alpha01

‫21 בפברואר 2024

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

שינויים ב-API

הוספנו @ReplaceWith הערה כדי לציין תחליפים לממשקי API שהוצאו משימוש. (I38db3, ‏ b/322373864)

פריטי תוכן שהוספת

תודה לאיוון מטקוב על העברת ההערה @MainThread אל קבוצת מקורות משותפת. (6f228c)

גרסה 1.7

גרסה 1.7.1

‫13 בדצמבר 2023

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

תיקוני באגים

שימוש בהיקף compile כשמוסיפים תלות בפלטפורמה שמוגדרת כברירת מחדל. (I4958f)

גרסה 1.7.0

‫6 בספטמבר 2023

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

שינויים חשובים מאז גרסה 1.6.0

כולל ארטיפקטים של Kotlin Multiplatform שמטרגטים פלטפורמות של iOS,‏ Linux ו-MacOS.
מעכשיו אפשר להשתמש בהערות בפרויקטים של KMM. הערה: יעדים שאינם Android של Annotations עדיין נמצאים בשלב הניסוי, אבל החלטנו למזג גרסאות כדי להקל על מפתחים לנסות אותם. באופן ספציפי, יכול להיות שחלק מההערות יעברו בין קוד משותף לקוד ספציפי לפלטפורמה במהלך פיתוח האלפא, כשאנחנו נסיים להגדיר את הגבולות.

גרסה ‎1.7.0-rc01

‫23 באוגוסט 2023

‫androidx.annotation:annotation-*:1.7.0-rc01 מופץ. גרסה ‎1.7.0-rc01 מכילה את השמירות האלה.

בגרסה הזו לא בוצעו שינויים בהשוואה לגרסת הבטא הקודמת.

גרסה ‎1.7.0-beta01

‫9 באוגוסט 2023

‫androidx.annotation:annotation-*:1.7.0-beta01 מופץ. גרסה ‎1.7.0-beta01 מכילה את השמירות האלה.

תכונות חדשות

ממשקי API שעברו ייצוב לקראת הפצה

גרסה ‎1.7.0-alpha03

‫26 ביולי 2023

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

תיקוני באגים

פרסום Maven POM כולל עכשיו ארטיפקט מרובה פלטפורמות שמותאם ל-JVM כברירת מחדל כתלות

גרסה ‎1.7.0-alpha02

‫24 במרץ 2023

‫androidx.annotation:annotation-*:1.7.0-alpha02 מופץ.

תיקוני באגים

הוסרו אילוצי תלות מפריטי Maven כדי לעקוף בעיה ב-build ביעדי Kotlin Native ‏ (b/274786186, ‏ KT-57531).

גרסה ‎1.7.0-alpha01

‫22 במרץ 2023

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

תכונות חדשות

כולל ארטיפקטים של Kotlin Multiplatform שמטרגטים פלטפורמות של iOS,‏ Linux ו-MacOS.
מעכשיו אפשר להשתמש בהערות בפרויקטים של KMM. הערה: יעדים שאינם Android של Annotations עדיין נמצאים בשלב הניסוי, אבל החלטנו למזג גרסאות כדי להקל על מפתחים לנסות אותם. באופן ספציפי, יכול להיות שחלק מההערות יעברו בין קוד משותף לקוד ספציפי לפלטפורמה במהלך פיתוח האלפא, כשאנחנו נסיים להגדיר את הגבולות.

גרסה 1.6

גרסה 1.6.0

‫22 בפברואר 2023

‫androidx.annotation:annotation:1.6.0 וגם androidx.annotation:annotation-jvm:1.6.0 מופצים. גרסה 1.6.0 מכילה את השמירות האלה.

שינויים חשובים מאז גרסה 1.5.0

הוספת הערה @RequiresExtension כדי לציין שממשק API דורש גרסה מסוימת של SDK מסוים לתוסף (I5e4fe)
המרת ספריית ההערות לבנייה באמצעות ערכת הכלים של Kotlin Multiplatform‏ (I3be8d)

גרסה ‎1.6.0-rc01

‫8 בפברואר 2023

‫androidx.annotation:annotation:1.6.0-rc01 וגם androidx.annotation:annotation-jvm:1.6.0-rc01 מופצים. גרסה ‎1.6.0-rc01 מכילה את השמירות האלה.

ההערה עברה ייצוב לקראת גרסה מועמדת להפצה 1.6.0-rc01.

גרסה ‎1.6.0-beta01

‫25 בינואר 2023

הגרסאות androidx.annotation:annotation:1.6.0-beta01 ו-androidx.annotation:annotation-jvm:1.6.0-beta01 יצאו ללא שינויים מ-1.6.0-alpha01.

גרסה ‎1.6.0-alpha01

‫11 בינואר 2023

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

גרסה ‎1.6.0-dev01

‫8 בפברואר 2023

‫androidx.annotation:annotation-*:1.6.0-dev01 מופץ. גרסה ‎1.6.0-dev01 מכילה את השמירות האלה.

ההערה הפעילה את Kotlin Multiplatform לגרסת טרום-השקה למפתחים 1.6.0-dev01.

תכונות חדשות

הוספת הערה @RequiresExtension כדי לציין שממשק API דורש גרסה מסוימת של SDK מסוים של תוסף. (I5e4fe)
המרת ספריית ההערות לבנייה באמצעות ערכת הכלים של Kotlin Multiplatform‏ (I3be8d)

גרסה 1.5.0

‫21 בספטמבר 2022

‫androidx.annotation:annotation:1.5.0 מופץ. גרסה 1.5.0 מכילה את השמירות האלה.

שינויים חשובים מאז גרסה 1.4.0

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

גרסה ‎1.5.0-rc01

‫7 בספטמבר 2022

‫androidx.annotation:annotation:1.5.0-rc01 מופץ. גרסה ‎1.5.0-rc01 מכילה את השמירות האלה.

אין שינויים בהשוואה לגרסת הבטא הקודמת 1.5.0.

גרסה ‎1.5.0-beta01

‫24 באוגוסט 2022

‫androidx.annotation:annotation:1.5.0-beta01 מופץ. גרסה ‎1.5.0-beta01 מכילה את השמירות האלה.

לא בוצעו שינויים מהגרסה הקודמת. ממשק ה-API קפוא בגרסת הבטא.

גרסה ‎1.5.0-alpha02

‫10 באוגוסט 2022

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

לא בוצעו שינויים מאז גרסת האלפא הקודמת.

גרסה ‎1.5.0-alpha01

‫27 ביולי 2022

‫androidx.annotation:annotation:1.5.0-alpha01 מופץ. גרסה ‎1.5.0-alpha01 מכילה את השמירות האלה.

תכונות חדשות

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

גרסה 1.4.0

‫15 ביוני 2022

‫androidx.annotation:annotation:1.4.0 מופץ. גרסה 1.4.0 מכילה את השמירות האלה.

שינויים חשובים מאז גרסה 1.3.0

@RestrictTo הועבר למקורות Kotlin ועכשיו הוא תומך באתר השימוש ב-@file. כתוצאה מכך, ספריית ההערות תלויה עכשיו בספרייה הסטנדרטית של Kotlin.
‫@ReturnThis (b/140249763): מוודא ששיטות שדורסות את השיטה הזו חייבות להחזיר את אותו מופע (מיועד לבוני תבניות וכו')
‫@OpenForTesting (b/141539024): אפשר להוסיף את ההערה הזו לשיטות ולמחלקות של Kotlin שמסומנות כ-open, וכלי ה-lint יוודא שהמחלקות האלה הן רק מחלקות משנה (ושהשיטות הן רק שיטות שמוגדרות מחדש) מבדיקות יחידה
‫@DeprecatedSinceApi (b/37116481): מציין שהשיטה (או המחלקה או השדה) שנוספה לה ההערה היא חלק מספריית backport ל-API של פלטפורמה, שכבר לא נדרשת החל מרמת ה-API הנתונה.
‫@EmptySuper: מציין שהשיטה הזו מוגדרת כריקה, ולכן כשמבטלים את ההגדרה שלה לא צריך לקרוא לה (ואסור לעשות זאת; לדוגמה, היא יכולה להכיל בדיקת תאימות לאחור).

גרסה ‎1.4.0-rc01

‫1 ביוני 2022

‫androidx.annotation:annotation:1.4.0-rc01 מופץ. גרסה ‎1.4.0-rc01 מכילה את השמירות האלה.

ממשק ה-API והפונקציונליות שלו סופיים ומוכנים להשקה.

גרסה ‎1.4.0-beta01

‫18 במאי 2022

‫androidx.annotation:annotation:1.4.0-beta01 מופץ. גרסה ‎1.4.0-beta01 מכילה את השמירות האלה.

לא בוצעו שינויים מאז גרסת האלפא האחרונה. ממשק ה-API ננעל לגרסת בטא.

גרסה ‎1.4.0-alpha02

‫9 בפברואר 2022

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

תכונות חדשות

הוספנו את ההערות @ReturnThis, ‏ @OpenForTesting, ‏ @EmptySuper ו-@DeprecatedSinceApi. (21946a2)
‫@ReturnThis (b/140249763): מוודא ששיטות ביטול של השיטה הזו מחזירות את אותו מופע (מיועד לבוני תבניות וכו')
‫@OpenForTesting (b/141539024): אפשר להוסיף את ההערה הזו למחלקות ולשיטות של Kotlin שמסומנות כ-open, וכלי ה-lint יוודא שהמחלקות האלה הן רק מחלקות משנה (ושהשיטות הן רק שיטות שמוגדרות מחדש) מבדיקות יחידה.
‫@DeprecatedSinceApi (b/37116481): מציין שהשיטה (או המחלקה או השדה) שנוספה לה ההערה היא חלק מספריית backport עבור API של פלטפורמה, שכבר לא נדרשת החל מרמת ה-API הנתונה.
‫@EmptySuper: מציין שהשיטה הזו מוגדרת כריקה, ולכן כשמבטלים את ההגדרה שלה לא צריך לקרוא לה (ואסור לעשות זאת; לדוגמה, היא יכולה להכיל בדיקות של תאימות לאחור).

גרסה ‎1.4.0-alpha01

15 בדצמבר 2021

‫androidx.annotation:annotation:1.4.0-alpha01 מופץ. גרסה ‎1.4.0-alpha01 מכילה את השמירות האלה.

שינויים ב-API

הערה RestrictTo הועברה למקורות Kotlin‏ (Ia6336)

גרסה 1.3.0

‫3 בנובמבר 2021

‫androidx.annotation:annotation:1.3.0 מופץ. גרסה 1.3.0 מכילה את השמירות האלה.

שינויים חשובים מאז גרסה 1.2.0

הערת @Discouraged לסימון ממשקי API שלא ניתן להוציא משימוש באופן סביר, אבל יש להם השפעה שלילית משמעותית על הביצועים ולא מומלץ להפעיל אותם בקוד ייצור רגיל
הוספנו את ההערה @Context כדי לסמן הקשרים כלליים, וכך לאפשר למפתחים לעבור לממשקי API חדשים בקלות רבה יותר
הערה @GravityInt לסימון רכיבים שמכילים ערכי כוח משיכה שדחוסים למספרים שלמים
המאפיין @InspectableProperty הוצא משימוש לטובת @Attribute ב-androidx.resourceinspection

גרסה ‎1.3.0-rc01

‫27 באוקטובר 2021

‫androidx.annotation:annotation:1.3.0-rc01 מופץ. גרסה ‎1.3.0-rc01 מכילה את השמירות האלה.

גרסה ‎1.3.0-beta01

‫29 בספטמבר 2021

‫androidx.annotation:annotation:1.3.0-beta01 מופץ. גרסה ‎1.3.0-beta01 מכילה את השמירות האלה.

שינויים ב-API

נדרש הסבר ב 'הודעה' בשביל @Discouraged. (I3390f)
הוספת ההערה ‎ @Discouraged לסימון אלמנטים שלא מומלץ להשתמש בהם. (Ib2549)
הוספת האפשרות להצגת ההערה RestrictTo בחלון הקופץ של מסמכי Studio (Ie8e1a, ‏ b/183134648)

תיקוני באגים

הוספת הערת הקשר כדי לסמן הקשרים כלליים, כדי שמפתחים יוכלו לעבור ל-API חדש בקלות רבה יותר. (Ie581a)

גרסה ‎1.3.0-alpha01

‫24 במרץ 2021

‫androidx.annotation:annotation:1.3.0-alpha01 מופץ. גרסה ‎1.3.0-alpha01 מכילה את השמירות האלה.

שינויים ב-API

המאפיין @InspectableProperty הוצא משימוש לטובת @Attribute בandroidx.resourceinspection. (Ic0eff)
נוספה הערה @GravityInt לסימון רכיבים שמכילים ערכי כוח משיכה שדחוסים למספרים שלמים. (Ifcaa4, ‏ b/180620048)

הערה – גרסה ניסיונית 1.6

גרסה ‎1.6.0-rc01

‫11 בפברואר 2026

‫androidx.annotation:annotation-experimental:1.6.0-rc01 מופץ. גרסה 1.6.0-rc01 לא כוללת שינויים מאז גרסת הבטא הקודמת.

גרסה ‎1.6.0-alpha01

‫22 באוקטובר 2025

‫androidx.annotation:annotation-experimental:1.6.0-alpha01 מופץ. גרסה ‎1.6.0-alpha01 מכילה את השמירות האלה.

שינויים ב-API

הערת ה-OptIn תומכת עכשיו ביעד ElementType.PARAMETER.

הערה – גרסה ניסיונית 1.5

גירסה 1.5.1

‫16 ביולי 2025

‫androidx.annotation:annotation-experimental:1.5.1 מופץ. גרסה 1.5.1 מכילה את השמירות האלה.

גרסה 1.5.0

‫7 במאי 2025

‫androidx.annotation:annotation-experimental:1.5.0 מופץ. גרסה 1.5.0 מכילה את השמירות האלה.

שינויים חשובים מאז גרסה 1.4.0

הוספנו את message אל RequiresOptIn כדי להתאים להערה של Kotlin stdlib עם ערך ברירת מחדל של מחרוזת ריקה. (I1f50e)
הספרייה הזו מטרגטת עכשיו את רמת השפה Kotlin 2.0 ונדרשת KGP 2.0.0 או גרסה חדשה יותר. (Idb6b5)

גרסה ‎1.5.0-rc01

‫23 באפריל 2025

‫androidx.annotation:annotation-experimental:1.5.0-rc01 מופץ. גרסה 1.5.0-rc01 לא כוללת שינויים מאז גרסת הבטא הקודמת. אפשר לעיין בשמירות.

גרסה ‎1.5.0-beta01

‫9 באפריל 2025

‫androidx.annotation:annotation-experimental:1.5.0-beta01 מופץ. גרסה ‎1.5.0-beta01 מכילה את השמירות האלה.

שינויים חשובים

הספרייה הזו מטרגטת עכשיו את רמת השפה Kotlin 2.0 ונדרשת KGP 2.0.0 או גרסה חדשה יותר (Idb6b5)

גרסה ‎1.5.0-alpha01

‫21 באוגוסט 2024

‫androidx.annotation:annotation-experimental:1.5.0-alpha01 מופץ. גרסה ‎1.5.0-alpha01 מכילה את השמירות האלה.

שינויים ב-API

מוסיפים message ל-RequiresOptIn כדי להתאים להערה של Kotlin stdlib עם ערך ברירת מחדל של מחרוזת ריקה. (I1f50e)

הערה – גרסה ניסיונית 1.4

גרסה 1.4.1

‫3 באפריל 2024

‫androidx.annotation:annotation-experimental:1.4.1 מופץ. גרסה 1.4.1 מכילה את השמירות האלה.

תיקוני באגים

כדי למנוע הפעלה לא מכוונת של בדיקת RequiresOptIn בקובצי Kotlin, צריך לתקן את השימוש ב-isKotlin. (I2d8c1f)

גרסה 1.4.0

‫24 בינואר 2024

‫androidx.annotation:annotation-experimental:1.4.0 מופץ. גרסה 1.4.0 מכילה את השמירות האלה.

שינויים חשובים מאז גרסה 1.3.0

הוספת תמיכה ב-Kotlin Multiplatform
תיקון תאימות ל-Kotlin 2.0
הצגת אזהרות לגבי שימושים ב-Java במאפייני Kotlin עם הערות ניסיוניות (I8bd43)
תיקון המיקום של הערת תיקון אוטומטי בשיטות Kotlin‏ (Id7a41)

גרסה ‎1.4.0-rc01

‫10 בינואר 2024

‫androidx.annotation:annotation-experimental:1.4.0-rc01 מופץ. גרסה 1.4.0-rc01 לא מכילה שינויים מאז הגרסה הקודמת.

גרסה ‎1.4.0-beta01

‫13 בדצמבר 2023

‫androidx.annotation:annotation-experimental:1.4.0-beta01 מופץ. לא חלו שינויים מאז הגרסה הקודמת.

גרסה ‎1.4.0-alpha01

‫29 בנובמבר 2023

‫androidx.annotation:annotation-experimental:1.4.0-alpha01 מופץ. גרסה ‎1.4.0-alpha01 מכילה את השמירות האלה.

תיקוני באגים

הסרה זמנית של הצעות לתיקון אוטומטי ברמת הכיתה כדי לעקוף את הבעיה b/301598518. (Id98b2)
הצגת אזהרות לגבי שימושים ב-Java במאפייני Kotlin עם הערות ניסיוניות (I8bd43)
תיקון המיקום של הערת תיקון אוטומטי בשיטות Kotlin‏ (Id7a41)

גרסה ‎1.4.0-dev01

‫8 בפברואר 2023

‫androidx.annotation:annotation-experimental:1.4.0-dev01 מופץ. גרסה ‎1.4.0-dev01 מכילה את השמירות האלה.

הערה-ניסיונית הפעילה את Kotlin multi-platform לגרסת טרום-ההשקה למפתחים 1.4.0-dev01.

‫Annotation-Experimental Version 1.3.1

גרסה 1.3.1

‫21 ביוני 2023

‫androidx.annotation:annotation-experimental:1.3.1 מופץ. גרסה 1.3.1 מכילה את השמירות האלה.

תיקוני באגים

כשמחילים תיקון אוטומטי של lint, צריך להציב את ההערה בתחילת רשימת ה-modifiers. (b/251172715)
שימוש בבדיקת lint כדי למנוע שימוש ב-androidx.annotation.RequiresOptIn במקורות Kotlin (b/241097743)

גרסה 1.3.0 של Annotation-Experimental

גרסה 1.3.0

‫7 בספטמבר 2022

‫androidx.annotation:annotation-experimental:1.3.0 מופץ. גרסה 1.3.0 מכילה את השמירות האלה.

שינויים חשובים מאז גרסה 1.2.0

הוספנו תמיכה בשימוש ב-@androidx.annotation.OptIn ברמת החבילה (I24d58)
העברנו את התלות ב-Kotlin stdlib לסוג API, במקום לסוג compile-only. המשמעות היא שכל הלקוחות של ספריית Annotation-Experimental יכללו את ספריית התקנים של Kotlin בתלות המעבר שלהם.

גרסה ‎1.3.0-rc01

‫24 באוגוסט 2022

‫androidx.annotation:annotation-experimental:1.3.0-rc01 מופץ. גרסה ‎1.3.0-rc01 מכילה את השמירות האלה.

לא בוצעו שינויים מאז הגרסה הקודמת. ההטמעה הוקפאה עבור RC.

גרסה ‎1.3.0-beta01

‫10 באוגוסט 2022

‫androidx.annotation:annotation-experimental:1.3.0-beta01 מופץ. גרסה ‎1.3.0-beta01 מכילה את השמירות האלה.

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

גרסה ‎1.3.0-alpha01

‫27 ביולי 2022

‫androidx.annotation:annotation-experimental:1.3.0-alpha01 מופץ. גרסה ‎1.3.0-alpha01 מכילה את השמירות האלה.

שינויים ב-API

הוספנו תמיכה בשימוש ב-@androidx.annotation.OptIn ברמת החבילה (I24d58)

גרסה ניסיונית 1.2.0 של Annotation

גרסה 1.2.0

15 בדצמבר 2021

‫androidx.annotation:annotation-experimental:1.2.0 מופץ. גרסה 1.2.0 מכילה את השמירות האלה.

שינויים חשובים מאז גרסה 1.1.0

הספרייה הזו מטרגטת עכשיו את רמת השפה Java 8.

גרסה ‎1.2.0-rc01

1 בדצמבר 2021

‫androidx.annotation:annotation-experimental:1.2.0-rc01 מופץ. גרסה ‎1.2.0-rc01 מכילה את השמירות האלה.

אין שינויים מגרסת הבטא.

גרסה ‎1.2.0-beta01

‫17 בנובמבר 2021

‫androidx.annotation:annotation-experimental:1.2.0-beta01 מופץ. גרסה ‎1.2.0-beta01 מכילה את השמירות האלה.

שינויים ב-API

ה-API הושלם לגרסת הבטא.

Annotation-Experimental Version 1.2.0-alpha01

‫30 ביוני 2021

‫androidx.annotation:annotation-experimental:1.2.0-alpha01 מופץ. גרסה ‎1.2.0-alpha01 מכילה את השמירות האלה.

תכונות חדשות

הספרייה מטargetת עכשיו את רמת השפה Java 8

גרסה 1.2.0

‫24 במרץ 2021

‫androidx.annotation:annotation:1.2.0 מופץ. גרסה 1.2.0 מכילה את השמירות האלה.

שינויים משמעותיים מאז גרסה 1.1.0

נוספה ההערה @ChecksSdkIntAtLeast, שאפשר להשתמש בה כדי לזהות שיטות או שדות שמשמשים להגבלת הגישה ברמת ה-SDK, וכדי לעמוד בדרישות של בדיקת ה-lint‏ NewApi.
נוספה הערה @DoNotInline, שמשויכת לכלל Proguard כדי למנוע את ההטמעה של חברים במהלך האופטימיזציה.
מגוון הערות מתויגות עכשיו בסמל @Documented כדי להבטיח שהן יופיעו בתיעוד של חברים מתויגים.

גרסה ‎1.2.0-rc01

24 בפברואר 2021

‫androidx.annotation:annotation:1.2.0-rc01 מופץ. גרסה ‎1.2.0-rc01 מכילה את השמירות האלה.

גרסה ‎1.2.0-beta01

‫13 בינואר 2021

‫androidx.annotation:annotation:1.2.0-beta01 מופץ. גרסה ‎1.2.0-beta01 מכילה את השמירות האלה.

שינויים ב-API

הערת @DoNotInline חדשה שמורה לאופטימיזציה של קוד (למשל Proguard, ‏ R8) לא להטמיע את המתודה עם ההערה. (I3dfe8, ‏ b/141326133)

גרסה ‎1.2.0-alpha01

14 במאי 2020

‫androidx.annotation:annotation:1.2.0-alpha01 מופץ. גרסה ‎1.2.0-alpha01 מכילה את השמירות האלה.

תכונות חדשות

נוספה הערה אחת (@ChecksSdkIntAtLeast). האפשרות הזו מאפשרת ל-androidx ולמשתמשים להוסיף הערות לשיטות ולשדות שמייצגים בדיקת SDK_INT. (I89a54, ‏ b/120255046)

גרסה ניסיונית 1.1.0 של Annotation

גרסה 1.1.0

‫7 באפריל 2021

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

שינויים משמעותיים מאז גרסה 1.0.0

הערות הניסוי של Jetpack נכתבו מחדש ב-Kotlin כדי לספק תמיכה בכמה מחלקות של סמנים ולשפר את הטיפול בהוצאה משימוש.
ההערות RequiresOptIn ו-OptIn נוספו כדי ליצור שוויון עם Kotlin, וההערות Experimental ו-UsesExperimental הוצאו משימוש.

גרסה ‎1.1.0-rc02

‫24 במרץ 2021

‫androidx.annotation:annotation-experimental:1.1.0-rc02 מופץ. גרסה ‎1.1.0-rc02 מכילה את השמירות האלה.

תיקוני באגים

הוספנו כללי Proguard כדי לוודא שאופטימיזציית הקוד לא תציג אזהרה לגבי הערות מטא חסרות ב-Kotlin.

גרסה ‎1.1.0-rc01

‫10 במרץ 2021

‫androidx.annotation:annotation-experimental:1.1.0-rc01 מופץ. גרסה ‎1.1.0-rc01 מכילה את השמירות האלה.

לא בוצעו שינויים מאז גרסת הבטא הקודמת.

גרסה ‎1.1.0-beta01

‫27 בינואר 2021

‫androidx.annotation:annotation-experimental:1.1.0-beta01 מופץ. גרסה ‎1.1.0-beta01 מכילה את השמירות האלה.

שינויים ב-API

הווריאציה של androidx של ההערה Experimental הוצאה משימוש כדי לספק שוויון עם Kotlin. היא הוחלפה בגרסת androidx של ההערה RequiresOptIn, וכלי ה-linter של Java עודכן כדי לתמוך גם בהערת Kotlin החדשה וגם בגרסת androidx החדשה. ‫(I52495, ‏ b/151331381)

גרסה ‎1.1.0-alpha01

22 ביולי 2020

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

תכונות חדשות

ספריית ההערות הניסיונית כתובה עכשיו ב-Kotlin, אבל לא נדרש לכלול את ספריית התקנים של Kotlin כתלות. הוא כולל קובץ Proguard שמאפשר להסיר מטא-נתונים מיותרים של Kotlin מפרויקטים שמשתמשים רק בשפת התכנות Java.
‫@UseExperimental תומך עכשיו בכמה מחלקות של סמנים (aosp/1185577, ‏ b/145137892)

גרסה ניסיונית 1.0.0 של Annotation

גרסה 1.0.0 של Annotation-Experimental

‫7 בנובמבר 2019

‫androidx.annotation:annotation-experimental:1.0.0 ו-androidx.annotation:annotation-experimental-lint:1.0.0 יצאו ללא שינויים מאז 1.0.0-rc01. גרסה 1.0.0 מכילה את השמירות האלה.

התכונות העיקריות בגרסה 1.0.0

אכיפה מבוססת-Lint של הסמנטיקה של Kotlin בקוד מקור ב-Java@Experimental
הערות (annotations) של Java שמספקות התנהגות שוות ערך להערות @Experimental ו-@UseExperimental של Kotlin, בלי הצורך בתלות ב-Kotlin

Annotation-Experimental Version 1.0.0-rc01

‫23 באוקטובר 2019

‫androidx.annotation:annotation-experimental:1.0.0-rc01 וגם androidx.annotation:annotation-experimental-lint:1.0.0-rc01 מופצים. גרסה ‎1.0.0-rc01 מכילה את השמירות האלה.

בעיות מוכרות

כשמשתמשים בגרסה היציבה Studio 3.5, אזהרות מגלאי השימוש @Experimental לא מוצגות בסביבת הפיתוח המשולבת (IDE) לשימושים לא חוקיים ב-Java בהערת Kotlin @Experimental. מידע נוסף זמין בכתובת b/140640322.

Annotation-Experimental Version 1.0.0-beta01

‫9 באוקטובר 2019

הגרסאות androidx.annotation:annotation-experimental:1.0.0-beta01 ו-androidx.annotation:annotation-experimental-lint:1.0.0-beta01 יוצאות ללא שינויים מאז גרסה 1.0.0-alpha01. גרסה ‎1.0.0-beta01 מכילה את השמירות האלה.

Annotation-Experimental Version 1.0.0-alpha01

18 בספטמבר 2019

‫androidx.annotation:annotation-experimental:1.0.0-alpha01 וגם androidx.annotation:annotation-experimental-lint:1.0.0-alpha01 מופצים. אלה הקודים שנכללים ב-annotation-experimental 1.0.0-alpha01 ואלה הקודים שנכללים ב-annotation-experimental-lint 1.0.0-alpha01

תכונות חדשות

ספריית ההערות Jetpack Experimental מספקת הטמעה תואמת ל-Java של סמני ה-API הניסיוני של Kotlin. ארטיפקט -lint מספק הטמעה מבוססת-Lint של הגבלות שימוש ניסיוניות, ומחיל הגבלות על שימושים ב-Java בסמני API ניסיוניים מקוריים של Kotlin.
כשמשתמשים בפריט annotation-experimental כפריט תלוי, כללי Lint שסופקו על ידי פריט annotation-experimental-lint נאכפים באופן אוטומטי.

גרסה 1.1.0

‫5 ביוני 2019

‫androidx.annotation:annotation:1.1.0 יוצא ללא שינויים מגרסה 1.1.0-rc01.

גרסה ‎1.1.0-rc01

‫7 במאי 2019

‫androidx.annotation:annotation:1.1.0-rc01 יוצא ללא שינויים מ-1.1.0-beta01. כאן אפשר לראות את השמירות שכלולות בגרסה הזו.

גרסה ‎1.1.0-beta01

‫3 באפריל 2019

‫androidx.annotation:annotation:1.1.0-beta01 מופץ. כאן אפשר לראות את השמירות שכלולות בגרסה הזו.

תכונות חדשות

@InspectablePropertyהערה חדשה לתמיכה בממשקי ה-API החדשים לבדיקת תצוגה שנוספו ב-Android 10. אפשר להחיל את ההערה הזו על שיטות getter בתצוגות או ברכיבי ממשק משתמש אחרים. יכול להיות שכלי ליצירת קוד ישתמשו בו כדי ליצור אובייקטים נלווים שממפים שמות של מאפיינים ומזהים של מאפיינים לערכי מאפיינים, בלי התקורה של רפלקציה.

שינויים ב-API

שינוי שעלול לשבור את התאימות: הערך @ContentView השתנה לאנוטציה של בנאי, והערך @LayoutRes הוסר. כדי להוסיף תמיכה בהערות @ContentView לכיתות, צריך להוסיף את ההערה הזו לקונסטרוקטור שמקבל פרמטר @LayoutRes int. התיקון הזה פותר בעיה שמתרחשת כשמשתמשים בהערה הזו במודולים של ספריות. (b/128352521)

גרסה ‎1.1.0-alpha02

‫13 במרץ 2019

‫androidx.annotation:annotation:1.1.0-alpha02 מופץ. כאן אפשר לראות את הרשימה המלאה של הקומיטים שכלולים בגרסה הזו.

תכונות חדשות

היקף חדש של הגבלת API: RestrictTo.Scope.LIBRARY_GROUP_PREFIX. היא מגבילה את השימוש לקוד בחבילות שהקבוצות שלהן חולקות את אותו קידומת של קבוצת ספריות עד לנקודה האחרונה (.). לדוגמה, מכיוון שלספריות foo.bar:lib1 ו-foo.baz:lib2 יש את הקידומת foo, הן יכולות להשתמש בממשקי ה-API אחת של השנייה שמוגבלים להיקף הזה. באופן דומה, com.foo.bar:lib1 ו-com.foo.baz:lib2 חולקים את הקידומת com.foo. ויכולים לשתף ממשקי API שמוגבלים להיקף הזה. עם זאת, לספרייה com.bar.qux:lib3 לא תהיה אפשרות להשתמש ב-API המוגבל כי היא חולקת רק את הקידומת com. ולא את כל הדרך עד לנקודה האחרונה ..

גרסה ‎1.1.0-alpha01

‫30 בינואר 2019

‫androidx.annotation:annotation 1.1.0-alpha01 מופץ.

תכונות חדשות

נוספה הערה @ContentView שמאפשרת לציין איזה קובץ XML של פריסה צריך להרחיב. התמיכה הזו קיימת ב-ComponentActivity בגרסה 1.0.0-alpha04 וב-Fragment בגרסה 1.1.0-alpha04, כחלופה לשימוש ב-setContentView() או לביטול של onCreateView(), בהתאמה. (aosp/837619)

גרסה 1.0.2

25 בפברואר 2019

‫androidx.annotation:annotation 1.0.2 מופץ.

תיקוני באגים

מתקנים את כללי R8/ProGuard שמוטמעים בקובץ ה-JAR. ההפניות היו שגויות והתייחסו לסוגים הישנים של android.support.annotation במקום ל-androidx.annotation. הערה: השינוי הזה היה משפיע על הגרסאות שלכם רק אם לא השתמשתם ב-getDefaultProguardFile, כי כללי ברירת המחדל האלה כללו גם כללים נכונים לשני החבילות. (aosp/891685)
מוסיפים כלל R8/ProGuard ששומר באופן מפורש את ההערה ‎ @Keep עצמה. כך אפשר לוודא ש-ProGuard לא יסיר את ההערה מהסוגים לפני שהוא יכבד את הסמנטיקה שלה. הערה: השינוי הזה היה משפיע על הגרסאות שלכם רק אם לא השתמשתם ב-getDefaultProguardFile, כי כללי ברירת המחדל האלה כללו גם כללים נכונים לשני החבילות. (aosp/903818)