Build-Abhängigkeiten sind externe Komponenten, die für den erfolgreichen Build Ihres Projekts erforderlich sind. Ein Build kann von Bibliotheken, Plug-ins, Unterprojekten, dem Android SDK, Tools wie Kotlin- und Java-Compilern, Entwicklungsumgebungen wie Android Studio und Gradle selbst abhängen.
Jede Abhängigkeit kann wiederum andere Abhängigkeiten erfordern. Diese werden als transitive Abhängigkeiten bezeichnet und können die Gesamtzahl der von Ihrer Anwendung verwendeten Abhängigkeiten schnell erhöhen. Wenn Sie eine Abhängigkeit aktualisieren möchten, z. B. eine Bibliothek, ein Tool oder das Android SDK, kann dieses Upgrade kaskadieren und viele andere Abhängigkeiten aktualisieren.
In der Regel ist das kein Problem, da viele Bibliotheken einem Schema namens Semantische Versionierung folgen. Diese Bibliotheken beschränken die Arten von Änderungen, die sie vornehmen, um die Kompatibilität mit ihren niedrigeren Versionen zu gewährleisten.
Die semantische Versionsverwaltung folgt dem Format major.minor.patch. In der Versionsnummer 4.8.3 ist beispielsweise 4 die major-Version, 8 die minor-Version und 3 die patch-Nummer. Wenn sich der Teil major ändert, kann es sein, dass die Bibliothek funktionsgefährdende Änderungen an der API oder am Verhalten enthält. Dies kann sich auf das Build- oder Anwendungsverhalten auswirken.
Wenn sich die Teile minor (neue Funktionen) oder patch (Fehlerkorrekturen) ändern, teilen die Entwickler der Bibliothek mit, dass die Bibliothek weiterhin kompatibel ist und sich nicht auf Ihre Anwendung auswirken sollte.
Beziehungen in Ihrem Build
Android-Builds enthalten Beziehungen zwischen:
- Quellcode – der Code und die Ressourcen, die Sie kontrollieren können
- Bibliotheksabhängigkeiten – externe Bibliotheken oder Module, die Ihr Projekt und Ihre Unterprojekte beim Erstellen enthalten
- Tools: Compiler, Plug-ins und SDKs, die Ihre Quelle in eine Anwendung oder Bibliothek übersetzen
Quellcode
Ihr Quellcode ist Kotlin- oder Java-Code, den Sie in Ihrer Anwendung oder Bibliothek schreiben. Weitere Informationen zur Verwendung von C++ finden Sie unter Android NDK.
Der Quellcode ist von Bibliotheken (einschließlich Kotlin- und Java-Laufzeitbibliotheken) und dem Android SDK abhängig und erfordert den entsprechenden Kotlin- oder Java-Compiler.
Einige Quellcodes enthalten Annotationen, die zusätzliche Verarbeitung erfordern. Wenn Sie beispielsweise Jetpack Compose-Code schreiben, fügen Sie Annotationen wie @Composable hinzu, die vom Compose Kotlin-Compiler-Plug-in verarbeitet werden müssen. Andere Annotationen können von einem Kotlin Symbol Processor (KSP) oder separaten Annotation-Processing-Tools verarbeitet werden.
Bibliotheksabhängigkeiten
Bibliotheken enthalten Bytecode, der als Teil Ihrer Anwendung abgerufen wird. Das kann eine Java-JAR-Datei, eine Android-Bibliothek (AAR) oder ein Unterprojekt in Ihrem Build sein. Viele Bibliotheken folgen der semantischen Versionsverwaltung. So können Sie nachvollziehen, ob sie nach einem Upgrade kompatibel bleiben oder nicht.
Bibliotheken haben oft transitive Abhängigkeiten von anderen Bibliotheken. Dadurch müssen Sie weniger explizit verwalten. Sie geben direkte Abhängigkeiten an und Gradle ruft sie zusammen mit transitiven Abhängigkeiten ab. Durch das Upgrade direkter Abhängigkeiten können auch deren transitive Abhängigkeiten aktualisiert werden.
Manchmal erfordert eine Bibliothek zur Laufzeit (minSdk) oder zur Kompilierzeit (compileSdk) Mindestversionen des Android SDK. Das ist erforderlich, wenn eine Bibliothek Funktionen verwendet, die im Android SDK oder in den bereitgestellten JDK APIs enthalten sind. Die effektive minSdk Ihrer Anwendung ist die höchste minSdk, die von Ihrer Anwendung und allen ihren direkten und transitiven Bibliotheksabhängigkeiten angefordert wird.
Für die Verwendung einiger Bibliotheken ist möglicherweise ein bestimmtes Gradle-Plug-in erforderlich. Diese Hilfs-Plug-ins installieren häufig Kotlin-Symbolprozessoren oder andere Annotationsprozessoren, die Code generieren oder die Kompilierung Ihrer Quelle ändern, um die Verwendung von Bibliotheksfunktionen zu unterstützen. Jetpack Room enthält beispielsweise Annotationen und einen KSP, der sie in generierten Code umwandelt, um Daten in einer Datenbank abzurufen und zu ändern. Jetpack Compose erfordert das Compose-Compiler-Plug-in, um annotierte Funktionen zu ändern und zu verwalten, wie und wann diese Funktion noch einmal ausgeführt wird.
Tools
Gradle |
Gradle ist das Build-Tool, das Ihre Build-Dateien liest und Ihre Anwendung oder Bibliothek generiert. Außerdem stellt es eine API für Plug-ins bereit, um die Funktionen zu erweitern. Gradle führt mehrere Prozesse auf einer oder mehreren Java Virtual Machines aus und seine Java-Plug-ins rufen die Java-Tools im JDK auf. |
Gradle-Plug-ins |
Gradle-Plug-ins erweitern Gradle, indem sie neue Aufgaben und Konfigurationen definieren. Wenn Sie ein Plug-in auf Ihren Build anwenden, werden bestimmte Build-Funktionen aktiviert, die als Daten in Ihren Build-Skripts konfiguriert sind. Für Android-Builds ist das wichtigste Gradle-Plug-in das Android-Gradle-Plug-in (AGP). |
Compiler |
Der Kotlin- oder Java-Compiler wandelt Ihren Quellcode in ausführbaren Bytecode um. Der Kotlin-Compiler stellt eine Plug-in-API bereit, mit der externe Analysen und Codegenerierungen direkt im Compiler ausgeführt werden können, wobei auf die geparste Codestruktur zugegriffen wird. |
Compiler-Plug-ins |
Compiler-Plug-ins führen Analysen und Codegenerierung innerhalb des Kotlin-Compilers durch, während der Kotlin-Compiler Ihren Code analysiert. Sie werden installiert, wenn Sie die Gradle-Plug-ins auf den Build anwenden. |
Android SDK |
Das Android SDK enthält die Android-Plattform und Java APIs für eine bestimmte Android-Version sowie die entsprechenden Tools. Mit diesen Tools können Sie das SDK verwalten, Ihre Anwendungen erstellen und mit Android-Geräten kommunizieren und diese emulieren. Jede Version des Android SDK bietet bestimmte Java APIs, auf die Ihr Quellcode zugreifen kann, sowie Entzuckerungsunterstützung, um diese APIs in früheren Android-Versionen zu verwenden. |
JDK |
Das Java Development Kit, das Java-Bibliotheken und ausführbare Dateien zum Kompilieren von Java-Quellen und zum Ausführen von Java-Anwendungen enthält. Bei einem Android-Build sind mehrere JDKs im Spiel. Weitere Informationen finden Sie unter Java-Versionen in Android-Builds. |
Gradle-Bereiche
Gradle gruppiert Bibliotheksabhängigkeiten in verschiedene Bereiche (in der Gradle API als Konfigurationen bezeichnet). So können Sie verschiedene Sätze von Bibliotheksabhängigkeiten angeben, die in verschiedenen Teilen Ihres Builds verwendet werden sollen. Beispielsweise möchten Sie wahrscheinlich keine Testbibliotheken wie JUnit in Ihre veröffentlichte Anwendung oder Bibliothek aufnehmen, aber Sie benötigen sie beim Erstellen und Ausführen Ihrer Unittests. Sie verwenden Bereiche auch, um Symbol- oder Annotationsprozessoren hinzuzufügen, mit denen Ihr Code analysiert wird.
Das AGP definiert beispielsweise die Bereiche implementation und api, mit denen Sie festlegen können, ob eine Abhängigkeit für Nutzer Ihres Unterprojekts sichtbar sein soll.
Eine Beschreibung dieser und anderer Bereiche, die in einem Android-Build verwendet werden, finden Sie unter Abhängigkeiten konfigurieren.
Fügen Sie Bibliotheksabhängigkeiten im dependencies-Block Ihrer Build-Dateien hinzu, entweder als group:artifact:version-Strings:
Kotlin
// 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") }
Groovy
// 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' }
oder in einem Versionskatalog:
# 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" }
und geben Sie die generierten Variablen in Ihren Build-Dateien an:
Kotlin
// In a module-level build script // Using a version catalog plugins { alias(libs.plugins.example.plugin) } dependencies { implementation(libs.example.library) }
Groovy
// In a module-level build script // Using a version catalog plugins { alias(libs.plugins.example.plugin) } dependencies { implementation libs.example.library }