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

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

דרישות הגרסה של Navigation SDK Kotlin

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

גרסת Navigation SDK	גרסת Kotlin (נדרשת)	גרסאות של פלאגין של Android Gradle‏ (AGP) ו-Gradle (מומלץ)
‫7.7 ומעלה	2.3.0	AGP 8.13.2 ‫Gradle 8.13
‫7.3 עד 7.6	2.2.10	‫AGP 8.10.0 ‫Gradle 8.11.1
‫6.3 - 7.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.

הערה: גרסאות AGP המומלצות שמפורטות למעלה מתאימות לשימוש ב-R8/D8, שכלול ב-AGP. אם אתם לא משתמשים ב-R8/D8, כדאי לעיין בדרישות של Kotlin לגבי הגרסאות המינימליות והמקסימליות של Gradle ו-AGP.

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

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

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

‫Kotlin מספקת שני דגלים שיעזרו לכם להגביל שינויים שעלולים לשבור את התאימות: https://kotlinlang.org/docs/compatibility-modes.html

גרסת השפה X.Y

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

android {
   kotlinOptions {
       languageVersion = '2.2'
   }
}

‫api-version X.Y

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

android {
   kotlinOptions {
       apiVersion = '2.2'
   }
}

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

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

• מדריך התאימות לגרסה 2.0
• מדריך לתאימות 2.1
• מדריך לתאימות עם גרסה 2.2
• 2.3 מדריך התאימות

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

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