Diese Seite wurde von der Cloud Translation API übersetzt.

NDK und CMake installieren und konfigurieren

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 C- und C++-Code mit Android verwenden können.
CMake: Ein externes Build-Tool, das zusammen mit Gradle zum Erstellen Ihrer nativen Bibliothek verwendet wird. Sie benötigen diese Komponente nicht, wenn Sie nur ndk-build verwenden möchten.
LLDB: Der Debugger, den Android Studio zum Debuggen von nativem Code verwendet. LLDB wird standardmäßig zusammen mit Android Studio installiert.

Auf dieser Seite wird beschrieben, wie Sie diese Komponenten automatisch installieren oder mit Android Studio oder dem sdkmanager-Tool manuell herunterladen und installieren.

NDK und CMake automatisch installieren

Mit dem Android Gradle-Plug-in 4.2.0 und höher können das erforderliche NDK und CMake automatisch installiert werden, wenn Sie Ihr Projekt zum ersten Mal erstellen und die Lizenzen vorab akzeptiert wurden. Wenn Sie die Lizenzbedingungen bereits gelesen und akzeptiert haben, können Sie die Lizenzen in Scripts mit dem folgenden Befehl vorab akzeptieren:

   yes | ${sdk}/cmdline-tools/latest/bin/sdkmanager --licenses

NDK und CMake installieren

Wenn Sie das NDK installieren, wählt Android Studio das neueste verfügbare NDK aus. Für die meisten Projekte reicht es aus, diese Standardversion des NDK zu installieren. Wenn für Ihr Projekt eine oder mehrere bestimmte Versionen des NDK erforderlich sind, können Sie bestimmte Versionen herunterladen und konfigurieren. So können Sie reproduzierbare Builds für Projekte sicherstellen, die jeweils von einer bestimmten Version des NDK abhängen. Android Studio installiert alle Versionen des NDK im Verzeichnis android-sdk/ndk/.

So installieren Sie CMake und das Standard-NDK in Android Studio:

Klicken Sie bei geöffnetem Projekt auf Tools > SDK-Manager.
Klicke auf den Tab SDK-Tools.
Klicken Sie die Kästchen NDK (Parallel) und CMake an.

Abbildung 1 Das Fenster SDK-Tools mit der Option NDK (Parallel)

Hinweis: Wenn Sie im Ordner ndk-bundle ein NDK installiert haben, wird es in der Liste mit dem Label NDK angezeigt. Wenn Sie das Android Gradle-Plug-in 3.5.0 oder höher verwenden, können Sie dieses Kästchen an- oder auswählen. Wenn Sie das Kästchen deaktivieren, wird das NDK deinstalliert, wodurch Speicherplatz freigegeben wird. Das Kästchen wird dann aus der Liste entfernt. Wenn Sie das alte NDK deinstallieren, entfernen Sie den jetzt veralteten Wert ndk.dir aus den local.properties-Dateien Ihrer Projekte.
Klicken Sie auf OK.

In einem Dialogfeld wird angezeigt, wie viel Speicherplatz das NDK-Paket auf der Festplatte belegt.
Klicken Sie auf OK.
Klicken Sie nach Abschluss der Installation auf Fertigstellen.
Die Build-Datei wird automatisch synchronisiert und ein Build wird ausgeführt. Beheben Sie alle auftretenden Fehler.

Bestimmte Version von CMake konfigurieren

Der SDK-Manager enthält die Fork-Version 3.6.0 von CMake und Version 3.10.2. Projekte, für die keine bestimmte CMake-Version festgelegt ist, werden mit CMake 3.10.2 erstellt. Wenn Sie die CMake-Version festlegen möchten, fügen Sie der Datei build.gradle Ihres Moduls Folgendes hinzu:

Groovy

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 enthalten ist, gehen Sie so vor:

Laden Sie CMake von der offiziellen CMake-Website herunter und installieren Sie es.
Geben Sie in der build.gradle-Datei Ihres Moduls die CMake-Version an, die Gradle verwenden soll.
Fügen Sie den Pfad zur CMake-Installation entweder der Umgebungsvariablen PATH hinzu oder fügen Sie ihn der Datei local.properties Ihres Projekts hinzu, wie gezeigt. Wenn Gradle die in der Datei build.gradle angegebene CMake-Version nicht finden kann, wird ein Buildfehler ausgegeben.
```
# If you set this property, Gradle no longer uses PATH to find CMake.
cmake.dir = "path-to-cmake"</pre>
```
Wenn das Ninja-Buildsystem noch nicht auf Ihrer Workstation installiert ist, rufen Sie die offizielle Ninja-Website auf und laden Sie die neueste Version von Ninja für Ihr Betriebssystem herunter und installieren Sie sie. Fügen Sie der Umgebungsvariablen PATH auch den Pfad zur Ninja-Installation hinzu.

Bestimmte Version des NDK installieren

So installieren Sie eine bestimmte Version des NDK:

Klicken Sie bei geöffnetem Projekt auf Tools > SDK-Manager.
Klicke auf den Tab SDK-Tools.
Aktivieren Sie das Kästchen Paketdetails anzeigen.
Klicken Sie das Kästchen NDK (Parallel) und die Kästchen darunter an, die den NDK-Versionen entsprechen, die Sie installieren möchten. Android Studio installiert alle Versionen des NDK im Verzeichnis android-sdk/ndk/.

Hinweis :Vorabversionen (z. B. Canary- und Betaversionen) des NDK werden in dieser Liste nur angezeigt, wenn Sie den Update-Kanal für Android Studio ändern. Sie können die Android Studio-Vorabversion parallel zur stabilen Version installieren.

Abbildung 2. Das Fenster SDK-Tools mit den Optionen NDK (Parallel)

Hinweis: Wenn Sie im Ordner ndk-bundle ein NDK installiert haben, wird es in der Liste mit dem Label NDK angezeigt. Wenn Sie Gradle-Version 3.5 oder höher verwenden, können Sie dieses Kästchen an- oder auswählen. Wenn Sie das Häkchen entfernen, wird das installierte NDK deinstalliert, wodurch Speicherplatz freigegeben wird und das Kästchen aus der Liste verschwindet. Wenn Sie das alte NDK deinstallieren, entfernen Sie den jetzt veralteten Wert ndk.dir aus den local.properties-Dateien Ihrer Projekte.
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.
Die Build-Datei wird automatisch synchronisiert und ein Build wird ausgeführt. Beheben Sie alle auftretenden Fehler.
Konfigurieren Sie jedes Modul mit der Version des NDK, die es verwenden soll. Wenn Sie Android Studio 3.6 oder höher verwenden und die Version nicht angeben, wählt das Android Gradle-Plug-in eine Version aus, die nachweislich kompatibel ist.

Bestimmte Versionen des NDK in Ihrem Projekt konfigurieren

Möglicherweise müssen Sie die Version des NDK in Ihrem Projekt konfigurieren, wenn eine der folgenden Bedingungen zutrifft:

Ihr Projekt ist übernommen und Sie müssen bestimmte Versionen des NDK und des Android Gradle-Plug-ins (AGP) verwenden. Weitere Informationen finden Sie unter NDK für das Android Gradle-Plug-in konfigurieren.
Sie haben mehrere Versionen des NDK installiert und möchten eine bestimmte Version verwenden. Geben Sie in diesem Fall die Version mit der Eigenschaft android.ndkVersion in der Datei build.gradle des Moduls an, wie im folgenden Codebeispiel gezeigt.
Groovy
android { ndkVersion "major.minor.build" // e.g., ndkVersion "21.3.6528147" }
Kotlin
android { ndkVersion = "major.minor.build" // e.g., ndkVersion "21.3.6528147" }

Standard-NDK-Version pro AGP-Version

Vor der Veröffentlichung wird jede AGP-Version gründlich mit dem jeweils aktuellen stabilen NDK-Release getestet. Diese NDK-Version wird zum Erstellen Ihrer Projekte verwendet, wenn Sie in der Datei build.gradle keine NDK-Version angeben. Die Standard-NDK-Version für verschiedene AGP-Versionen ist in den AGP-Release-Notes und den bisherigen AGP-Release-Notes dokumentiert.