הערה
בטבלה הזו מפורטים כל פריטי המידע שנוצרו בתהליך הפיתוח (Artifact) בקבוצה androidx.annotation
.
פריט מידע שנוצר בתהליך פיתוח (Artifact) | גרסה יציבה | מועמד לפרסום | גרסת בטא | גרסת אלפא |
---|---|---|---|---|
הערה | 1.8.2 | - | - | 1.9.0-alpha01 |
אנוט-ניסיוני | 1.4.1 | - | - | - |
הצהרה על יחסי תלות
כדי להוסיף תלות בהערות, צריך להוסיף את מאגר Google Maven פרויקט. למאגר Maven של Google אפשר לקבל מידע נוסף.
מוסיפים את יחסי התלות של פריטי המידע הנדרשים בקובץ build.gradle
בשביל
האפליקציה או המודול שלך:
מגניב
dependencies { implementation "androidx.annotation:annotation:1.8.2" // 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.8.2") // 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.2
7 באוגוסט 2024
androidx.annotation:annotation-*:1.8.2
משוחרר. גרסה 1.8.2 כוללת את ההתחייבויות האלה.
תיקוני באגים
- הוספת תמיכה לפלטפורמה של
mingwX64
(I461ca, b/349894318)
גרסה 1.8.1
24 ביולי 2024
androidx.annotation:annotation-*:1.8.1
משוחרר. גרסה 1.8.1 כוללת את ההתחייבויות האלה.
תיקוני באגים
- כולל יעדים נוספים של Kotlin במספר פלטפורמות:
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-בטא02 לא כוללת שינויים מאז הגרסה הקודמת.
גרסה 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
- כולל פריטי מידע שנוצרו בתהליך פיתוח (Artifact) של Kotlin מרובה פלטפורמות לפלטפורמות 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 מכילה את התחייבויות אלה.
תכונות חדשות
- כולל פריטי מידע שנוצרו בתהליך פיתוח (Artifact) של Kotlin מרובה פלטפורמות לפלטפורמות 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, ולא באמצעות הידור בלבד. פירוש הדבר הוא שכל הלקוחות של הספרייה הניסיונית הערות יכללו את ספריית הסטנדרטית של 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
של תוכן ניסיוני, ואלה ההתחייבויות שכלולות ב-API של אנוטציה-ניסיונית 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)