הערה

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

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

פריט מידע שנוצר בתהליך פיתוח (Artifact) גרסה יציבה גרסה מועמדת להפצה גרסת בטא גרסת אלפא
הערה 1.9.1 - - -
annotation-experimental 1.4.1 - 1.5.0-beta01 -
הספרייה עודכנה לאחרונה ב-9 באפריל 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.4.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.4.1")
}

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

משוב

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

דיווח על בעיה חדשה

מידע נוסף זמין במסמכי התיעוד של Issue Tracker.

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

תרומה חיצונית

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

גרסה 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 כוללת את ההצהרות האלה.

תיקוני באגים

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

גרסה 1.7.0-alpha02

24 במרץ 2023

androidx.annotation:annotation-*:1.7.0-alpha02 משוחרר.

תיקוני באגים

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

גרסה 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)
  • ספריית הערות שהוסבה ל-build באמצעות ערכת הכלים 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 כוללת את ההצהרות האלה.

  • Annotation הפעילה את Kotlin לפלטפורמות מרובות בתצוגה המקדימה למפתחים 1.6.0-dev01.

תכונות חדשות

  • הוספת הערה @RequiresExtension כדי לציין ש-API מחייב גרסה מסוימת של SDK של תוסף מסוים. (I5e4fe)
  • ספריית הערות שהוסבה ל-build באמצעות ערכת הכלים 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 מכילה את ההצהרות האלה על ביצוע שינויים (commits).

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

  • @RestrictTo הועבר למקורות Kotlin ועכשיו תומך באתר השימוש @file. כתוצאה מכך, ספריית התווית תלויה עכשיו בספרייה הרגילה של Kotlin.
  • @ReturnThis (b/140249763): מוודא ששיטות שמשנות את ברירת המחדל של השיטה הזו חייבות להחזיר את אותו מופע (מיועד לבוני גרסת build וכו')
  • @OpenForTesting (b/141539024): אפשר להוסיף את ההערה הזו לשיעורים ולשיטות ב-Kotlin שמסומנים בתווית 'פתוח', והכלי לזיהוי שגיאות בקוד ידאג שהשיעור הזה יתקבל רק כסוג משנה (והשיטות יתקבלו רק כשינוי מברירת המחדל) מבדיקות יחידה
  • @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): מוודא ששיטות שמשנות את ברירת המחדל של השיטה הזו חייבות להחזיר את אותה מופע (מיועד לבוני גרסאות build וכו')

  • @OpenForTesting (b/141539024): אפשר להוסיף את ההערה הזו לשיטות ולכיתות ב-Kotlin שמסומנות בתווית 'פתוח', והכלי לזיהוי שגיאות בקוד ינחה אתכם ליצור תת-כיתות של הכיתה הזו (ולשנות את ברירת המחדל של השיטות) רק מבדיקות יחידה

  • @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

  • נדרש הסבר בשדה 'message' עבור @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)

Annotation-Experimental Version 1.5

גרסה 1.5.0-beta01

9 באפריל 2025

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

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

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

גרסה 1.5.0-alpha01

21 באוגוסט 2024

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

שינויים ב-API

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

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

גרסה 1.4.1

3 באפריל 2024

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

תיקוני באגים

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

גרסה 1.4.0

24 בינואר 2024

androidx.annotation:annotation-experimental:1.4.0 משוחרר. גרסה 1.4.0 מכילה את ההצהרות האלה על ביצוע שינויים (commits).

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

  • הוספת תמיכה ב-Kotlin לפלטפורמות מרובות
  • תיקון התאימות ל-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 מכילה את ההצהרות האלה על ביצוע שינויים (commits).

  • Annotation-experimental הפעילה את Kotlin לפלטפורמות מרובות בתצוגה המקדימה למפתחים 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 מכילה את השמירות האלה.

תיקוני באגים

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

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

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

תכונות חדשות

  • הספרייה מטרגטת עכשיו את רמת השפה 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)

Annotation-Experimental Version 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 של ההערה הניסיונית הוצאו משימוש כדי לספק תאימות ל-Kotlin. הוא הוחלף בגרסה של androidx של ההערה RequiresOptIn, והכלי לזיהוי שגיאות בקוד ב-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
  • הערות ב-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 stable, אזהרות ממכשיר זיהוי השגיאות בקוד (lint) של שימוש ב-@Experimental לא מוצגות בסביבת הפיתוח המשולבת (IDE) לגבי שימושים לא חוקיים ב-Java של הערה @Experimental ב-Kotlin. 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 מספקת הטמעה תואמת ל-Java של סמני ה-API הניסיוניים של Kotlin. הארטיפקט -lint מספק הטמעה מבוססת-Lint של הגבלות שימוש ניסיוניות, ומאכס את ההגבלות על שימושים ב-Java של סמלי ה-API הניסיוניים של Kotlin.

  • כשמשתמשים באובייקט ה-artifact annotation-experimental כיחסי תלות, כללי Lint שסופקו על ידי אובייקט ה-artifact 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. כאן אפשר למצוא את ההתחייבויות (commits) שכלולות בגרסה הזו.

גרסה 1.1.0-beta01

3 באפריל 2019

androidx.annotation:annotation:1.1.0-beta01 משוחרר. כאן אפשר למצוא את ההתחייבויות (commits) שכלולות בגרסה הזו.

תכונות חדשות

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

שינויים ב-API

  • שינוי שפוגע בתאימות לאחור: @ContentView השתנה להערה של קונסטרוקטור והערך @LayoutRes הוסר. כדי לתמוך בהערות @ContentView, צריך להוסיף את ההערה הזו למבנה (constructor) שמקבל פרמטר @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)