Dodaj komponenty do projektu

Narzędzie do śledzenia problemów

Zgłaszaj problemy, abyśmy mogli naprawić błędy.

Zanim zaczniesz, przeczytaj Przewodnik po architekturze aplikacji, w którym znajdziesz przydatne zasady dotyczące wszystkich aplikacji na Androida oraz wskazówki dotyczące używania komponentów architektury razem.

Komponenty architektury są dostępne w repozytorium Google Maven. Aby ich używać, dodaj repozytorium do projektu.

Otwórz plik settings.gradle i dodaj repozytorium google():

Odlotowy

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

Kotlin

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

Ostrzeżenie: od 31 marca 2021 r. repozytorium JCenter jest dostępne tylko do odczytu. Więcej informacji znajdziesz w artykule na temat aktualizacji usługi JCenter.

Deklarowanie zależności

Otwórz plik build.gradle swojej aplikacji lub modułu i dodaj artefakty, których potrzebujesz jako zależności. Możesz dodać zależności dla wszystkich komponentów architektury lub wybrać podzbiór.

Instrukcje deklarowania zależności dla każdego komponentu architektury znajdziesz w informacjach o wersji:

• Transakcje terminowe (dostępne w aplikacji androidx.concurrent)
• Cykl życia (w tym ViewModel)
• Nawigacja (w tym SafeArgs)
• Paging
• Sala
• Menedżer roboczy

Najbardziej aktualne numery wersji poszczególnych komponentów znajdziesz w sekcji Wersje AndroidaX.

Więcej informacji o refaktoryzacji AndroidX i jej wpływie na te pakiety klas i identyfikatory modułów znajdziesz w artykule Migracja na AndroidaX.

Kotlin

Moduły rozszerzenia Kotlin są obsługiwane przez kilka zależności AndroidX. Do nazw tych modułów jest dołączony sufiks -ktx. Na przykład:

Odlotowy

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

Kotlin

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

zmienia się w

Odlotowy

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

Kotlin

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

Więcej informacji, w tym dokumentację dotyczącą rozszerzeń Kotlin, znajdziesz w dokumentacji KTX.

Uwaga: w przypadku aplikacji opartych na Kotlin użyj kapt zamiast annotationProcessor. Dodaj też wtyczkę kotlin-kapt.