כשהתלות היא בספרייה מקומית או בעץ קבצים אחר, Gradle מחפש את הקבצים במאגרים אונליין שצוינו בבלוק dependencyResolutionManagement { repositories {...} }
בקובץ settings.gradle
. הסדר שבו מציינים כל מאגר קובע את הסדר שבו Gradle מחפש במאגרים את כל יחסי התלות של הפרויקט.
לדוגמה, אם יש תלות זמינה גם ממאגר A וגם ממאגר B, ורושמים את התלות ב-Gradle, הוא מוריד את התלות ממאגר A.
כברירת מחדל, בפרויקטים חדשים ב-Android Studio מציינים את מאגר Maven של Google ואת המאגר המרכזי של Maven כמיקומי המאגרים בקובץ settings.gradle
של הפרויקט, כמו בדוגמה הבאה:
Kotlin
dependencyResolutionManagement { repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS) repositories { google() mavenCentral() } }
Groovy
dependencyResolutionManagement { repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS) repositories { google() mavenCentral() } }
אם רוצים ליצור משהו ממאגר מקומי, צריך להשתמש ב-mavenLocal()
:
Kotlin
dependencyResolutionManagement { repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS) repositories { google() mavenCentral() mavenLocal() } }
Groovy
dependencyResolutionManagement { repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS) repositories { google() mavenCentral() mavenLocal() } }
לחלופין, אפשר להצהיר על מאגרי Maven או Ivy ספציפיים באופן הבא:
Kotlin
dependencyResolutionManagement { repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS) repositories { maven(url = "https://repo.example.com/maven2") maven(url = "file://local/repo/") ivy(url = "https://repo.example.com/ivy") } }
Groovy
dependencyResolutionManagement { repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS) repositories { maven { url 'https://repo.example.com/maven2' } maven { url 'file://local/repo/' } ivy { url 'https://repo.example.com/ivy' } } }
מידע נוסף מופיע במדריך של Gradle Repositories.
מאגר Maven של Google
הגרסאות העדכניות ביותר של ספריות Android הבאות זמינות במאגר Maven של Google:
- ספריות AndroidX
- ספריית רכיבי הארכיטקטורה
- ספריית Constraint Layout
- AndroidX Test
- ספריית Databinding
- ספריית אפליקציות ללא התקנה ל-Android
- Wear OS
- Google Play Services
- ספריית החיוב של Google Play
- Firebase
אפשר לראות את כל הארטיפקטים הזמינים באינדקס של מאגר Maven של Google (מידע נוסף על גישה פרוגרמטית מופיע בהמשך).
כדי להוסיף אחת מהספריות האלה ל-build, צריך לכלול את מאגר Maven של Google בקובץ build.gradle.kts
ברמה העליונה:
Kotlin
dependencyResolutionManagement { repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS) repositories { google() // If you're using a version of Gradle lower than 4.1, you must instead use: // maven { // url = "https://maven.google.com" // } // An alternative URL is "https://dl.google.com/dl/android/maven2/". } }
Groovy
dependencyResolutionManagement { repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS) repositories { google() // If you're using a version of Gradle lower than 4.1, you must instead use: // maven { // url 'https://maven.google.com' // } // An alternative URL is 'https://dl.google.com/dl/android/maven2/'. } }
אחר כך מוסיפים את הספרייה הרצויה לבלוק dependencies
של המודול.
לדוגמה, ספריית appcompat נראית כך:
Kotlin
dependencies { implementation("com.android.support:appcompat-v7:28.0.0") }
Groovy
dependencies { implementation 'androidx.appcompat:appcompat:1.7.0' }
אבל, אם אתם מנסים להשתמש בגרסה ישנה יותר של הספריות שלמעלה והתלות נכשלת, אז היא לא זמינה במאגר של Maven ובמקום זאת תצטרכו לקבל את הספרייה מהמאגר אופליין.
גישה פרוגרמטית
כדי לקבל גישה פרוגרמטית לארטיפקטים של Maven ב-Google, אפשר לקבל רשימת XML של קבוצות ארטיפקטים בכתובת maven.google.com/master-index.xml. לאחר מכן, בכל קבוצה, תוכלו לראות את השמות והגרסאות של הספריות שלה בכתובת:
maven.google.com/group_path/group-index.xml
לדוגמה, הספריות בקבוצה android.arch.lifecycle מפורטות בכתובת maven.google.com/android/arch/lifecycle/group-index.xml.
אפשר גם להוריד את קובצי ה-POM ו-JAR בכתובות הבאות:
maven.google.com/group_path/library/version /library-version.ext
לדוגמה: maven.google.com/android/arch/lifecycle/compiler/1.0.0/compiler-1. 0.0.pom
מאגר אופליין מ-SDK Manager
לספריות שלא זמינות במאגר Maven של Google (בדרך כלל גרסאות ספרייה ישנות יותר), צריך להוריד את החבילה Google Repository אופליין מ-SDK Manager.
לאחר מכן תוכלו להוסיף את הספריות האלה לבלוק dependencies
כרגיל.
הספריות אופליין נשמרות ב-android_sdk/extras/
.