תאימות לגרסאות של Kotlin והעברה

בדף הזה מפורט מידע על תאימות הגרסאות של Kotlin ל-Navigation SDK, וגם הנחיות להעברה לגרסה חדשה יותר.

בטבלה הבאה מפורטות דרישות הגרסה של Kotlin והגרסאות המומלצות של AGP ו-Gradle לגרסאות האחרונות של Navigation SDK.

גרסת Navigation SDK גרסת Kotlin (חובה) גרסאות של Android Gradle Plugin‏ (AGP) ו-Gradle (מומלץ)
6.2 ומעלה 2.1
  • AGP 8.7.3
  • Gradle 8.10.2
6.0 עד 6.2 2.0
  • AGP 8.3.0
  • Gradle 8.4
5.1 עד 5.99.1 1.9 מומלץ להשתמש ב-AGP מגרסה 7.3 ואילך, שיש לה פתרון עקיף לבעיה JDK-8272564.

תאימות לגרסאות של Kotlin

ב-Kotlin 2.1 יש תמיכה בתאימות לאחור ל-Kotlin 2.0. כלומר, אם אתם כבר משתמשים ב-Kotlin 2.0 עם Navigation SDK, תוכלו לשדרג ל-Kotlin 2.1 בלי שתצטרכו לפתור את כל השינויים הבלתי ניתנים לביטול. עם זאת, האפשרות הזו רלוונטית רק לתכונות שפה יציבות. אם אתם משתמשים בתכונות אלפא, בטא או ניסיוניות בשפת Kotlin, יכול להיות שתצטרכו לבצע שינויים נוספים במהלך השדרוג.

מעבר קל יותר: דגלים של תאימות ל-Kotlin

ב-Kotlin יש שני דגלים שיעזרו להגביל שינויים שגורמים לשיבושים: https://kotlinlang.org/docs/compatibility-modes.html

language-version X.Y

הדגל הזה מחזיר שינויים משמעותיים להתנהגות של גרסה קודמת של Kotlin. לדוגמה, אם אתם משתמשים ב-Kotlin 2.0, תוכלו לציין את הערך [ - language-version 2.0] והשינויים החדשים הבלתי הפיכים לא ייכנסו לתוקף:

android {
   kotlinOptions {
       languageVersion = '2.0'
   }
}

api-version X.Y

הדגל הזה גורם לשגיאה ב-build של Gradle כשמשתמשים ב-API מגרסה של Kotlin חדשה יותר מ-apiVersion.

android {
   kotlinOptions {
       apiVersion = '2.0'
   }
}

גישה ממוקדת יותר

בנוסף לשימוש בדגלים של תאימות ל-Kotlin, מומלץ לקרוא את הערות המוצר של Kotlin ולבחור את ההתנהגויות שרוצים לשמור מהגרסה שממנה מבצעים את השדרוג. במדריכי התאימות של Kotlin לכל גרסה מפורטת רשימה של שינויים שמשנים את ההתנהגות המקורית, וכן הדגלים שאפשר להגדיר כדי לשמור על ההתנהגות המקורית:

שדרוגים עתידיים של Kotlin

גרסה חדשה של Kotlin (כלומר, מהדורת שפה) יוצאת כל 6 חודשים, ובדרך כלל Google משלבת את הגרסה האחרונה כברירת מחדל במוצרים שלנו חודש או חודשיים לאחר מכן. גרסאות קודמות של Kotlin כללו שינויים משמעותיים שדרשו מלקוחות Navigation SDK לשדרג לגרסה חדשה יותר. לכן, מומלץ לתכנן שדרוג של Kotlin כל 6 חודשים כשעוברים לגרסת Navigation SDK העדכנית ביותר.