הערה

בטבלה הזו מפורטים כל פריטי המידע שנוצרו בתהליך הפיתוח (Artifact) בקבוצה androidx.annotation.

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

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

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

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

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

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

משוב

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

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

מקורות מידע בנושא מעקב אחר בעיות אפשר לקבל מידע נוסף.

גרסה 1.9

גרסה 1.9.0-alpha01

26 ביוני 2024

androidx.annotation:annotation-*:1.9.0-alpha01 משוחרר. גרסה 1.9.0-alpha01 מכילה את התחייבויות אלה.

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

• נוספה תמיכה ביעד linuxArm64 בפלטפורמות מרובות (תודה לג'ייק וורטון!)

גרסה 1.8

גרסה 1.8.1

24 ביולי 2024

androidx.annotation:annotation-*:1.8.1 משוחרר. גרסה 1.8.1 כוללת את ההתחייבויות האלה.

תיקוני באגים

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

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

תיקוני באגים

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

גרסה 1.7.0-alpha02

24 במרץ 2023

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

תיקוני באגים

• הוסרו מגבלות התלות מפריטי מידע שנוצרו בתהליך הפיתוח (Artifact) של 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)
• ספריית הערות שהומרו לבנייה באמצעות מערכת הכלים של 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)
• ספריית הערות שהומרו לבנייה באמצעות כלי הכלים של 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): מוודא ששיטות העקיפה של השיטה הזו חייבות להחזיר את אותה מכונה (מיועדת ל-builders וכו')
• @OpenForTesting (b/141539024): כיתות ושיטות ב-Kotlin שמסומנות כ'פתוחות' עם ההערה הזו, ואיתור השגיאות יוודא שהמחלקה מסווגת לפי המחלקה המשנית בלבד (והשיטות יבוטלו רק) מבדיקות היחידה.
• @DeprecatedSinceApi (b/37116481): מציין שה-method עם ההערה (או המחלקה או השדה) היא חלק מספריית 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): מוודא ששיטות העקיפה של השיטה הזו חייבות להחזיר את אותה מכונה (מיועדת ל-builders וכו')

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

• @DeprecatedSinceApi (b/37116481): מציין שה-method עם ההערה (או המחלקה או השדה) היא חלק מספריית 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)
• הוספת הערה 'לא מומלץ' לסימון רכיבים לא מומלצים. (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.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 כוללת את ההתחייבויות האלה.

שינויים חשובים מאז 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 מכילה את ההתחייבויות האלה.

• הערות-ניסיוניות הופעלו בפלטפורמות מרובות של Kotlin לתצוגה מקדימה למפתחים 1.4.0-dev01.

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

גרסה 1.3.1

21 ביוני 2023

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

תיקוני באגים

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

גרסה ניסיונית להערות 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, ולא לצורך הידור בלבד. פירוש הדבר הוא שכל הלקוחות של הספרייה Annotation- experiments (ניסויים בהערות) יכללו את ספריית התקן של 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

גרסה 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 אושרו לגרסת הבטא.

גרסה ניסיונית להערות 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 ולעמוד בדרישות של בדיקת השגיאות בקוד 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 של ההערה הניסיונית הוצאנו משימוש כדי להתאים ל-Kotlin. הוא הוחלף בווריאנט androidx של נדרשת הערת OptIn, וה-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) של סמנטיקה של @Experimental Kotlin בקוד המקור של Java
• הערות 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 בהערה @Experimental של Kotlin. פרטים נוספים זמינים בכתובת 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 שוחררו. אלה ההתחייבויות שכלולות ב-1.0.0-alpha01 של תוכן ניסיוני, ואלה ההתחייבויות שכלולות ב-lint [lint] 1.0.0-alpha01

תכונות חדשות

• ספריית ההערות הניסיונית של Jetpack מספקת הטמעה תואמת Java של סמני ה-API הניסיוניים של Kotlin. פריט המידע שנוצר בתהליך הפיתוח (Artifact) של -lint מספק הטמעה מבוססת-lint של הגבלות שימוש ניסיוניות, ואוכף הגבלות על השימוש ב-Java בסמני ה-API הניסיוניים המקוריים של Kotlin.

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

גרסה 1.1.0-beta01

3 באפריל 2019

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

תכונות חדשות

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

שינויים ב-API

• שינוי תוכנה שעלול לגרום לכשל: @ContentView השתנה להערה של constructor והערך @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 שמוטמעים בצנצנת. מונחי החיפוש האלה התייחסו באופן שגוי לסוגים הישנים של android.support.annotation במקום אל androidx.annotation. הערה: הפעולות האלה היו יכולות להשפיע על גרסאות ה-build שלך רק אם לא השתמשת ב-getDefaultProguardFile, כי כללי ברירת המחדל האלה כללו גם כללים נכונים לשתי החבילות. (aosp/891685)
• להוסיף כלל R8/ProGuard ששומר באופן מפורש את ההערה @Keep עצמה. כך ניתן להבטיח ש-ProGuard לא יסיר את ההערה מסוגים לפני שהיא תכבד את הסמנטיקה שלה בפועל. הערה: הפעולות האלה היו יכולות להשפיע על גרסאות ה-build שלך רק אם לא השתמשת ב-getDefaultProguardFile, כי כללי ברירת המחדל האלה כללו גם כללים נכונים לשתי החבילות. (aosp/903818)