הערה

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

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

פריט מידע שנוצר בתהליך פיתוח (Artifact) גרסה יציבה גרסה מועמדת להפצה גרסת בטא גרסת אלפא
הערה 1.9.1 - - -
annotation-experimental 1.5.1 - - -
הספרייה הזו עודכנה לאחרונה ב-16 ביולי 2025

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

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

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

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

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

תכונות חדשות

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

פריטי תוכן חיצוניים שהוספת

  • תודה לאיוון מטקוב על העברת ההערה @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 כדי לעקוף בעיה בבנייה ב-Kotlin Native Targets ‏ (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 multi-platform בגרסת developer preview‏ 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 surface לגרסת בטא.

גרסה 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.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 multi-platform
  • תיקון בעיות תאימות ל-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 multi-platform בגרסת הטרום-השקה למפתחים 1.4.0-dev01.

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

גרסה 1.3.1

‫21 ביוני 2023

androidx.annotation:annotation-experimental:1.3.1 משוחרר. גרסה 1.3.1 מכילה את הקומיטים האלה.

תיקוני באגים

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

Annotation-Experimental Version 1.3.0

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

Annotation-Experimental Version 1.2.0

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

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

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

Annotation-Experimental Version 1.0.0

Annotation-Experimental Version 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

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

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

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