הוספת רכיבים לפרויקט

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

רכיבי הארכיטקטורה זמינים ממאגר Maven של Google. כדי להשתמש ב- ולהוסיף את המאגר לפרויקט.

פותחים את הקובץ settings.gradle ומוסיפים את המאגר google():

dependencyResolutionManagement {
   ...
    repositories {
        google()
        jcenter()
    }
}

dependencyResolutionManagement {
    ...
    repositories {
        google()
        jcenter()
    }
}

הצהרה על יחסי תלות

פותחים את הקובץ build.gradle של האפליקציה או של המודול ומוסיפים את פריטי המידע שנוצרו בתהליך הפיתוח (Artifact) שנדרשים לכם בתור יחסי תלות. אפשר להוסיף יחסי תלות לכל הארכיטקטורה או לבחור קבוצת משנה.

נתוני הגרסה כוללים את ההוראות להצהרת יחסי תלות לכל רכיב ארכיטקטורה:

• חוזים עתידיים (נמצאים ב-androidx.concurrent)
• מחזור חיים (כולל ViewModel)
• ניווט (כולל SafeArgs)
• חלוקה לדפים
• חדר
• מנהל העבודה

כדי לראות את הגרסה העדכנית ביותר, יש לעיין בגרסאות של AndroidX ואת מספרי הגרסאות של כל רכיב.

למידע נוסף על ארגון הקוד מחדש של AndroidX ועל ההשפעה שלו על המחלקות האלה חבילות ומזהי מודולים, ראו העברה אל AndroidX.

Kotlin

יש תמיכה במודולים של תוספים של Kotlin עבור כמה יחסי תלות של AndroidX. האלה הסיומת -ktx מצורפת לשמות של המודולים. לדוגמה:

implementation "androidx.lifecycle:lifecycle-viewmodel:$lifecycle_version"

implementation("androidx.lifecycle:lifecycle-viewmodel:$lifecycle_version")

הופך ל-

implementation "androidx.lifecycle:lifecycle-viewmodel-ktx:$lifecycle_version"

implementation("androidx.lifecycle:lifecycle-viewmodel-ktx:$lifecycle_version")

ניתן למצוא מידע נוסף, כולל מסמכים עבור תוספים של Kotlin, מסמכי תיעוד של KTX.

הערה: באפליקציות שמבוססות על Kotlin, חשוב להשתמש kapt במקום annotationProcessor. כדאי לך גם מוסיפים את הפלאגין kotlin-kapt.