מעבר ל-Kotlin 2.0

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

תאימות ל-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 מציעים שני דגלים כדי להגביל את שינויי התוכנה:

גרסת שפה X.Y

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

android {
   kotlinOptions {
       languageVersion = '1.7'
   }
}

גרסה X.Y של ממשק api

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

android {
   kotlinOptions {
       apiVersion = '1.7'
   }
}

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

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