מעבר ל-Kotlin 2.0

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

הערה: מידע על השדרוג ל-Kotlin 1.9, שנדרש ל-Navigation SDK מגרסה 5.1 ואילך, זמין במדריך לשדרוג ל-Kotlin 1.9.

תאימות ל-Gradle ול-AGP

ל-Kotlin 2.0 יש דרישות לגרסאות המינימליות והמקסימליות של Gradle ושל Android Gradle Plugin‏ (AGP). חשוב לוודא שהפרויקט עומד בדרישות האלה ל-Kotlin 2.0.

גרסת AGP מינימלית ל-Navigation SDK מגרסה 6.0 ואילך

מומלץ להשתמש ב-AGP מגרסה 7.3 ואילך עם Navigation SDK מגרסה 6.0. וידאנו את ה-SDK עם AGP 8.3 ו-Gradle 8.4, וה-SDK תואם למצב המלא של R8.

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

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

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

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

language-version X.Y

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

android {
   kotlinOptions {
       languageVersion = '1.7'
   }
}

api-version X.Y

הדגל הזה מונע שימוש ב-API חדשים לפני שקוד התורן התלוי מוכן לשילוב של Kotlin 2.0.

android {
   kotlinOptions {
       apiVersion = '1.7'
   }
}

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

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

• מדריך התאימות לגרסה 1.8
• מדריך התאימות לגרסה 1.9
• מדריך תאימות לגרסה 2.0