Erste Schritte mit dem NDK

Das Native Development Kit (NDK) besteht aus einer Reihe von Tools, mit denen Sie C und C++ Code mit Android erstellen und bietet Plattformbibliotheken zur Verwaltung von und auf physische Gerätekomponenten wie Sensoren und Eingabe per Berührung. Das NDK ist für die meisten Android-Neulinge nicht geeignet. Programmierer, die nur Java-Code und Framework-APIs für die Entwicklung für ihre Apps. Das NDK kann jedoch nützlich sein, wenn Sie mindestens eines der folgenden Elemente:

  • Nutzen Sie die zusätzliche Leistung eines Geräts, um eine niedrige Latenz zu erreichen oder rechenintensive Anwendungen wie Spiele oder physikalische Simulationen
  • Eigene oder die anderer Entwickler wiederverwenden C- oder C++-Bibliotheken.

Mit Android Studio 2.2 und höher können Sie NDK verwenden, um C- und C++-Code in eine native Bibliothek zu kompilieren und zu verpacken mithilfe von Gradle, dem integrierten Build-System der IDE, in dein APK einfügen. Ihr Java-Code kann dann Funktionen in Ihrer nativen Bibliothek über das Java Native Interface (JNI)-Framework aufrufen. Weitere Informationen Weitere Informationen zu Gradle und dem Android-Build-System finden Sie unter Build konfigurieren.

Das standardmäßige Build-Tool von Android Studio zum Kompilieren nativer Bibliotheken ist CMake. Android Studio unterstützt ndk-build aufgrund der großen Anzahl vorhandener Projekte, die das Build-Toolkit nutzen. Wenn Sie jedoch eine neue native Bibliothek erstellen, sollten Sie CMake verwenden.

Dieser Leitfaden enthält alle Informationen, die Sie für den Einstieg in NDK in Android Studio. Wenn Sie nicht die neueste Android-Version haben Laden Sie Studio jetzt herunter und installieren Sie es.

Hinweis für experimentelle Gradle-Nutzer: Ziehen Sie Migration auf Plug-in-Version 2.2.0 oder höher und mit CMake oder ndk-build um native Bibliotheken zu erstellen, wenn einer der folgenden Punkte auf Sie zutrifft: natives Projekt bereits CMake oder ndk-build verwendet. verwenden Sie lieber eine stabile Version des Gradle-Build-Systems; oder Support für Add-on-Tools benötigen, wie z. B. CCache. Andernfalls können Sie weiterhin die experimentelle Version von Gradle und das Android-Plug-in

NDK und Tools herunterladen

Zum Kompilieren und Debuggen von nativem Code für Ihre App benötigen Sie Folgendes: Komponenten:

  • Das Android Native Development Kit (NDK): eine Reihe von Tools, mit denen Sie um C- und C++-Code mit Android zu verwenden.
  • CMake, ein externes Build-Tool, das zusammen mit Gradle Ihre eigenen native Bibliothek. Sie benötigen diese Komponente nicht, wenn Sie „ndk-build“.
  • LLDB: Der Debugger, der in Android Studio zum Debuggen von nativem Code verwendet wird.

Informationen zur Installation dieser Komponenten finden Sie unter NDK und CMake installieren und konfigurieren.

Natives Projekt erstellen oder importieren

Nach der Einrichtung von Android Studio können Sie einfach ein neues Projekt erstellen mit C/C++-Unterstützung. Wenn Sie jedoch nativen Code zu einer bestehenden Android Studio-Projekt zu nutzen, müssen Sie die folgenden grundlegenden Schritte ausführen:

  1. Neu erstellen native Quelldateien und fügen Sie sie Ihrem Android Studio-Projekt hinzu.
    • Sie können diesen Schritt überspringen, wenn Sie bereits nativen Code haben oder eine vordefinierte native Bibliothek zu importieren.
  2. Erstellen ein CMake-Build-Skript, das CMake weiß, wie native Quellen erstellt werden sollen in eine Bibliothek verschieben. Sie benötigen dieses Build-Skript auch, wenn Sie Daten importieren und Verknüpfungen mit vordefinierten oder Plattformbibliotheken.
    • Sie können diesen Schritt überspringen, wenn Ihre vorhandene native Bibliothek bereits eine CMakeLists.txt-Build-Script verwendet oder „ndk-build“ verwendet und ein Android.mk Build-Script.
  3. Gradle verknüpfen mit Ihrer nativen Bibliothek, indem Sie einen Pfad zu Ihrem CMake- oder ndk-build angeben Skriptdatei. Gradle verwendet das Build-Skript, um Quellcode in Ihren Android Studio-Projekt erstellen und Ihre native Bibliothek (die SO-Datei) in das APK.

    Hinweis:Wenn in Ihrem vorhandenen Projekt das verworfene ndkCompile-Tool müssen Sie Ihr build.properties-Datei und entfernen Sie die folgende Codezeile bevor Sie Gradle für die Verwendung von CMake oder ndk-build konfigurieren: 

    // Remove this line
android.useDeprecatedNdk = true
  4. Erstellen Sie Ihre Anwendung und führen Sie sie aus, indem Sie auf Führen Sie führen Sie die App aus und führen Sie sie dann über das Hauptmenü aus aus. Gradle fügt CMake- oder ndk-build-Prozess als Abhängigkeit zum Kompilieren, Erstellen und Ihre native Bibliothek mit Ihrem APK verpacken.

Sobald Ihre App auf einem physischen Gerät oder im Emulator ausgeführt wird, können Sie Android Studio, um Fehler in Ihrer App zu beheben. Weitere Informationen zum NDK und seinen Komponenten finden Sie auf der Seite Konzepte.