Zum Kompilieren und Debuggen von nativem Code für Ihre App benötigen Sie die folgenden Komponenten:
- Das Android Native Development Kit (NDK): eine Reihe von Tools, mit denen Sie und C++ Code mit Android verwenden.
- CMake: ein externes Build-Tool, das zusammen mit Gradle native Bibliothek. Sie benötigen diese Komponente nicht, wenn Sie nur „ndk-build“ verwenden möchten.
- LLDB: Der Debugger, den Android Studio zur Fehlerbehebung von nativem Code verwendet. Standardmäßig zeigt der LLDB-Wert wird zusammen mit Android Studio installiert.
Auf dieser Seite wird beschrieben, wie Sie diese Komponenten automatisch oder mithilfe von
Android Studio oder das sdkmanager
-Tool, um sie manuell herunterzuladen und zu installieren
NDK und CMake automatisch installieren
Das Android-Gradle-Plug-in 4.2.0 oder höher kann das erforderliche NDK und CMake automatisch installieren Wenn Sie Ihr Projekt zum ersten Mal erstellen, wenn deren Lizenzen im Voraus akzeptiert wurden. Wenn du die Lizenzbedingungen bereits gelesen hast und ihnen zustimmst, kannst du sie vorab akzeptieren in Skripts mit dem folgenden Befehl:
yes | ${sdk}/cmdline-tools/latest/bin/sdkmanager --licenses
NDK und CMake installieren
Bei der Installation des NDK wird in Android Studio das neueste verfügbare NDK ausgewählt. Für
Für die meisten Projekte reicht die Installation dieser Standardversion des NDK aus.
Wenn Ihr Projekt jedoch eine oder mehrere spezifische Versionen des NDK benötigt, können Sie
Bestimmte Versionen herunterladen und konfigurieren. Das hilft,
können Sie projektübergreifend reproduzierbare Builds erstellen, die jeweils von einem bestimmten
Version des NDK. Android Studio installiert alle Versionen des NDK im
android-sdk/ndk/
-Verzeichnis.
So installieren Sie CMake und das Standard-NDK in Android Studio:
Klicken Sie in einem geöffneten Projekt auf Tools > SDK-Manager.
Klicken Sie auf den Tab SDK-Tools.
Klicken Sie die Kästchen NDK (Side by side) und CMake an.
Abbildung 1: Das Fenster SDK Tools mit dem NDK (Side by side) Option
Klicken Sie auf OK.
In einem Dialogfeld wird angezeigt, wie viel Speicherplatz das NDK-Paket auf dem Laufwerk belegt.
Klicken Sie auf OK.
Klicken Sie nach Abschluss der Installation auf Fertigstellen.
Ihr Projekt synchronisiert automatisch die Build-Datei und führt einen Build aus. Beheben Sie alle auftretenden Fehler.
Bestimmte Version von CMake konfigurieren
Der SDK Manager enthält die Fork-Version 3.6.0 der
CMake und Version 3.10.2. Projekte, die kein
CMake-Versionen werden mit CMake 3.10.2 erstellt. Bis
Legen Sie die CMake-Version fest und fügen Sie der Datei build.gradle
Ihres Moduls Folgendes hinzu:
Cool
android { ... externalNativeBuild { cmake { ... version "cmake-version" } } }
Kotlin
android { ... externalNativeBuild { cmake { ... version = "cmake-version" } } }
Wenn Sie eine CMake-Version verwenden möchten, die nicht im SDK-Manager führen Sie diese Schritte aus:
- Laden Sie CMake herunter und installieren Sie es. von der offiziellen CMake-Website.
- Geben Sie die CMake-Version an, die Gradle in der
build.gradle
-Datei. Fügen Sie entweder den Pfad zur CMake-Installation in der
PATH
-Umgebung hinzu ändern oder in die Dateilocal.properties
Ihres Projekts aufnehmen, angezeigt. Wenn Gradle die von Ihnen angegebene Version von CMake nicht finden kann, Ihrebuild.gradle
-Datei enthält, erhalten Sie einen Build-Fehler.# If you set this property, Gradle no longer uses PATH to find CMake. cmake.dir = "path-to-cmake"</pre>
Haben Sie das Ninja-Build-System noch nicht auf Ihrem rufen Sie die offizielle Ninja-Website auf. die neueste für Ihr Betriebssystem verfügbare Ninja-Version herunter und installieren Sie diese. Vergessen Sie nicht, auch den Pfad zur Ninja-Installation zu Ihrem
PATH
.
Eine bestimmte Version des NDK installieren
So installieren Sie eine bestimmte Version des NDK:
Klicken Sie in einem geöffneten Projekt auf Tools > SDK-Manager.
Klicken Sie auf den Tab SDK-Tools.
Klicken Sie das Kästchen Paketdetails anzeigen an.
Aktivieren Sie das Kontrollkästchen NDK (Side by side) und die Kästchen darunter. den NDK-Versionen entsprechen, die Sie installieren möchten. Android Studio-Installationen alle Versionen des NDK im
android-sdk/ndk/
-Verzeichnis.Abbildung 2: Das Fenster SDK Tools mit dem NDK (Side by side) Optionen
Klicken Sie auf OK.
In einem Dialogfeld wird angezeigt, wie viel Speicherplatz die NDK-Pakete belegen.
Klicken Sie auf OK.
Klicken Sie nach Abschluss der Installation auf Fertigstellen.
Ihr Projekt synchronisiert automatisch die Build-Datei und führt einen Build aus. Beheben Sie alle auftretenden Fehler.
Konfigurieren Sie jedes Modul mit der Version des NDK. die Sie verwenden möchten. Wenn Sie Android Studio 3.6 oder höher verwenden, die Version angeben, wählt das Android-Gradle-Plug-in eine Version aus, mit denen bekanntermaßen kompatibel ist.
Bestimmte Versionen des NDK in Ihrem Projekt konfigurieren
Möglicherweise müssen Sie die Version des NDK in Ihrem Projekt konfigurieren, wenn eines der trifft Folgendes zu:
- Ihr Projekt wurde übernommen und Sie müssen bestimmte Versionen des NDK verwenden und das Android-Gradle-Plug-in (AGP). Weitere Informationen finden Sie unter Konfigurieren Sie das NDK für das Android-Gradle-Plug-in.
Sie haben mehrere Versionen des NDK installiert und möchten eine bestimmte eins. Geben Sie in diesem Fall die Version mithilfe von
android.ndkVersion
an. in der Dateibuild.gradle
des Moduls ein, wie im folgenden Code dargestellt: Stichprobe.Cool
android { ndkVersion "major.minor.build" // e.g., ndkVersion "21.3.6528147" }
Kotlin
android { ndkVersion = "major.minor.build" // e.g., ndkVersion "21.3.6528147" }
NDK-Standardversion pro AGP-Version
Vor der Veröffentlichung wird jede AGP-Version gründlich mit dem neuesten stabilen NDK getestet.
veröffentlicht wurden. Diese NDK-Version wird zum Erstellen Ihrer Projekte verwendet, wenn Sie
keine NDK-Version in der Datei build.gradle
angeben. Die NDK-Standardversion
für die verschiedenen AGP-Versionen sind in der
AGP-Versionshinweise und
Frühere Versionshinweise zu AGP.