הערה

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

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

פריט מידע שנוצר בתהליך פיתוח (Artifact) גרסה יציבה גרסה מועמדת להפצה גרסת בטא גרסת אלפא
אנוטציה 1.10.0 - - -
annotation-experimental 1.6.0 - - -
הספרייה הזו עודכנה לאחרונה בתאריך: 8 באפריל 2026

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

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

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

Groovy

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

Kotlin

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

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

משוב

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

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

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

הערה

גרסה 1.10

גרסה 1.10.0

‫8 באפריל 2026

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

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

  • הוספנו את ההערה @RequiresFlag כדי לסמן שימושים בממשקי API של פלטפורמת Android שעדיין לא יציבים
  • הוסרה התמיכה ביעדי KMP x86 Apple

גרסה ‎1.10.0-rc01

‫25 במרץ 2026

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

גרסה ‎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

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

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

תכונות חדשות

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

תיקוני באגים

גרסה 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)

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

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

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

גרסה 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

גרסה 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

גרסה 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

גרסה 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.1

גרסה 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 מופץ. כאן אפשר לראות את הרשימה המלאה של פעולות ה-commit שכלולות בגרסה הזו.

תכונות חדשות

  • היקף חדש של הגבלת 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

גרסה 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)

הערה-ניסיוני

גרסה 1.6

גרסה 1.6.0

‫8 באפריל 2026

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

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

  • תיקונים לתמיכה בגרסה האחרונה של Android Lint בבדיקות ה-Lint שכלולות בחבילה

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

  • הערה: annotation-experimental הפעיל את Kotlin Multiplatform לגרסת טרום-השקה למפתחים 1.4.0-dev01.

גרסה 1.3

גרסה 1.3.1

‫21 ביוני 2023

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

תיקוני באגים

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

גרסה 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

גרסה 1.2.0

15 בדצמבר 2021

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

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

הספרייה הזו מטargetת עכשיו את רמת השפה 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 מכילה את השמירות האלה.

תכונות חדשות

  • הספרייה מכוונת עכשיו לרמת שפה 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

גרסה 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

גרסה 1.0.0

‫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 @Experimental בקוד מקור של Java
  • הערות (annotations) של Java שמספקות התנהגות שוות ערך להערות @Experimental ו-@UseExperimental של Kotlin, בלי צורך בתלות ב-Kotlin

גרסה ‎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.

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

גרסה ‎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 נאכפים באופן אוטומטי.