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 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:

  1. Klicken Sie in einem geöffneten Projekt auf Tools > SDK-Manager.

  2. Klicken Sie auf den Tab SDK-Tools.

  3. Klicken Sie die Kästchen NDK (Side by side) und CMake an.

    Bild von SDK Manager Abbildung 1: Das Fenster SDK Tools mit dem NDK (Side by side) Option

  4. Klicken Sie auf OK.

    In einem Dialogfeld wird angezeigt, wie viel Speicherplatz das NDK-Paket auf dem Laufwerk belegt.

  5. Klicken Sie auf OK.

  6. Klicken Sie nach Abschluss der Installation auf Fertigstellen.

  7. 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:

  1. Laden Sie CMake herunter und installieren Sie es. von der offiziellen CMake-Website.
  2. Geben Sie die CMake-Version an, die Gradle in der build.gradle-Datei.
  3. Fügen Sie entweder den Pfad zur CMake-Installation in der PATH-Umgebung hinzu ändern oder in die Datei local.properties Ihres Projekts aufnehmen, angezeigt. Wenn Gradle die von Ihnen angegebene Version von CMake nicht finden kann, Ihre build.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>
    
  4. 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:

  1. Klicken Sie in einem geöffneten Projekt auf Tools > SDK-Manager.

  2. Klicken Sie auf den Tab SDK-Tools.

  3. Klicken Sie das Kästchen Paketdetails anzeigen an.

  4. 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.

    Bild des Fensters „SDK Tools“ Abbildung 2: Das Fenster SDK Tools mit dem NDK (Side by side) Optionen

  5. Klicken Sie auf OK.

    In einem Dialogfeld wird angezeigt, wie viel Speicherplatz die NDK-Pakete belegen.

  6. Klicken Sie auf OK.

  7. Klicken Sie nach Abschluss der Installation auf Fertigstellen.

  8. Ihr Projekt synchronisiert automatisch die Build-Datei und führt einen Build aus. Beheben Sie alle auftretenden Fehler.

  9. 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 Datei build.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.