Współzależności między narzędziami i bibliotekami

Zależność kompilacji to zewnętrzne komponenty wymagane do skompilowania projektu. Kompilacja może zależeć od bibliotek, wtyczek i podprojektów, pakietu SDK Androida, narzędzi takich jak kompilatory Kotlin i Java, środowisk programistycznych takich jak Android Studio oraz samego Gradle.

Każda zależność może wymagać innych zależności. Nazywamy je zależnościami pośrednimi i mogą one szybko zwiększać liczbę wszystkich zależności używanych przez aplikację. Gdy chcesz uaktualnić zależność, np. bibliotekę, narzędzie lub pakiet SDK Androida, ta aktualizacja może być przeprowadzona kaskadowo, co spowoduje zaktualizowanie wielu innych zależności.

Często nie będzie to problemem, ponieważ wiele bibliotek stosuje schemat semantycznego wersjonowania. Te biblioteki ograniczają typy wprowadzanych zmian, aby zapewnić zgodność z ich starszymi wersjami.

Wersja semantyczna ma format major.minor.patch. Na przykład w numerze wersji 4.8.3 4 oznacza wersję major, 8 to wersja minor, a 3 to numer patch. Gdy zmieni się część major, biblioteka może zawierać zmiany w interfejsie API lub w zachowaniu, które mogą być niekompatybilne z poprzednimi wersjami. Może to wpłynąć na zachowanie kompilacji lub aplikacji.

Gdy zmienią się części minor (nowe funkcje) lub patch (poprawki błędów), deweloperzy biblioteki informują, że biblioteka jest nadal zgodna i nie powinna mieć wpływu na Twoją aplikację.

Relacje w kompilacji

Kompilacje Androida zawierają relacje między:

• Kod źródłowy – kod i zasoby, nad którymi masz kontrolę
• Biblioteki zewnętrzne – biblioteki lub moduły zewnętrzne, które są uwzględniane w ramach kompilacji projektu i podprojektów.
• Narzędzia – kompilatory, wtyczki i pakiety SDK, które przekształcają kod źródłowy w aplikację lub bibliotekę.

Kod źródłowy

Kod źródłowy to kod Kotlin lub Java napisany w aplikacji lub bibliotece. (informacje o używaniu C++ znajdziesz w Android NDK).

Kod źródłowy zależy od bibliotek (w tym bibliotek środowisk wykonawczych Kotlin i Java) oraz pakietu Android SDK i wymaga odpowiedniego kompilatora Kotlin lub Java.

Niektóre źródła kodu zawierają adnotacje, które wymagają dodatkowego przetwarzania. Jeśli na przykład piszesz kod Jetpack Compose, dodajesz adnotacje, takie jak @Composable, które muszą być przetworzone przez komponent Kotlin skompilowany przez Compose. Inne adnotacje mogą być przetwarzane przez Kotlin Symbol Processor (KSP) lub oddzielne narzędzia do przetwarzania adnotacji.

Zależności bibliotek

Biblioteki zawierają bajtkod pobierany w ramach aplikacji. Może to być plik JAR w języku Java, biblioteka Androida (AAR) lub podprojekt w kompilacji. Wiele bibliotek stosuje wersje semantyczne, co ułatwia zrozumienie, czy po uaktualnieniu pozostaną one zgodne (czy też nie).

Biblioteki mogą być zależne od innych bibliotek, które są używane ponownie. Takie zależności nazywamy pośrednimi. Dzięki temu zmniejsza się liczba zależności, którymi musisz się zajmować. Określasz zależności, których używasz bezpośrednio, a Gradle pobiera je wraz z zależnościami cząstkowymi. Pamiętaj, że gdy aktualizujesz bezpośrednie zależności, mogą one zaktualizować te zależności transitive.

Czasami biblioteka może wymagać minimalnej wersji pakietu Android SDK w czasie działania (minSdk) lub kompilacji (compileSdk). Jest to konieczne, gdy biblioteka używa funkcji zawartych w pakiecie Android SDK lub w dołączonych interfejsach JDK. Skuteczna minSdk aplikacji to najwyższa minSdk wymagana przez aplikację i wszystkie jej bezpośrednie i pośrednie zależności od bibliotek.

Korzystanie z niektórych bibliotek może wymagać użycia określonego wtyczka Gradle. Te wtyczki pomocnicze często instalują procesory symboli Kotlina lub inne procesory adnotacji, które generują kod lub modyfikują kompilację Twoich źródeł, aby umożliwić korzystanie z funkcji biblioteki. Na przykład Jetpack Room zawiera adnotacje i moduł KSP, który przekształca je w wygenerowany kod służący do pobierania i modyfikowania danych w bazie danych. Jetpack Compose wymaga wtyczki kompilatora Compose, aby modyfikować funkcje z adnotacją, aby zarządzać sposobem i czasem ich ponownego uruchamiania.

Narzędzia

Zakresy Gradle

Gradle grupowanie zależności bibliotek w różne zakresy (nazywane w interfejsie Gradle API konfiguracjami), co pozwala określić różne zestawy zależności bibliotek do użycia w różnych częściach procesu kompilacji. Na przykład prawdopodobnie nie chcesz uwzględniać w opublikowanej aplikacji lub bibliotece bibliotek testów takich jak JUnit, ale chcesz je stosować podczas kompilowania i wykonywania testów jednostkowych. Zakresy służą też do dodawania procesorów symboli lub adnotacji, które analizują kod.

Na przykład AGP definiuje zakresy implementation i api, które umożliwiają określenie, czy zależność ma być widoczna dla użytkowników podprojektu. Opis tych i innych zakresów używanych w kompilacji Androida znajdziesz w artykule Konfigurowanie zależności.

Dodaj zależności biblioteki w bloku dependencies plików kompilacji jako ciągi znaków group:artifact:version:

// In a module-level build script
// explicit dependency strings ("group:artifact:version")
dependencies {
    implementation("com.example:library1:1.2.3")
    api("com.example:library2:1.1.1")
}

// In a module-level build script
// explicit dependency strings ("group:artifact:version")
dependencies {
    implementation 'com.example:library1:1.2.3'
    api 'com.example:library2:1.1.1'
}

lub w katalogu wersji:

# Version catalog - gradle/libs.versions.toml
[versions]
exampleLib = "1.2.3"
examplePlugin = "2.3.4"

[libraries]
example-library = { group = "com.example", name = "library", version.ref = "exampleLib" }

[plugins]
example-plugin = { id = "com.example.plugin", version.ref = "examplePlugin" }

i określ wygenerowane zmienne w plikach kompilacji:

// In a module-level build script
// Using a version catalog
plugins {
    alias(libs.plugins.example.plugin)
}

dependencies {
    implementation(libs.example.library)
}

// In a module-level build script
// Using a version catalog
plugins {
    alias(libs.plugins.example.plugin)
}

dependencies {
    implementation libs.example.library
}