Inizia a utilizzare NDK

Il Native Development Kit (NDK) è un insieme di strumenti che consente di utilizzare e C++ con Android e fornisce librerie di piattaforma che puoi usare per gestire le attività native e l'accesso a componenti fisici dei dispositivi, come sensori e input tocco. L'NDK potrebbe non essere appropriato per la maggior parte dei neofiti di Android programmatori che devono usare solo API di framework e di codice Java per sviluppare le loro app. Tuttavia, l'NDK può essere utile nei casi in cui sia necessario farlo uno o più dei seguenti elementi:

  • Riduci le prestazioni di un dispositivo per ottenere una bassa latenza o eseguire applicazioni ad alta intensità di calcolo, come giochi o simulazioni di fisica.
  • Riutilizza i tuoi strumenti o quelli di altri sviluppatori C o C++.

Con Android Studio 2.2 e versioni successive puoi: usa NDK per compilare il codice C e C++ in una libreria nativa e pacchettizzarla nell'APK usando Gradle, il sistema di build integrato dell'IDE. Il tuo codice Java può quindi chiamare le funzioni nella tua libreria nativa tramite il framework Java Native Interface (JNI). Per ulteriori informazioni per saperne di più su Gradle e sul sistema di build Android, leggi l'articolo Configura la tua build.

Lo strumento di creazione predefinito di Android Studio per compilare le librerie native è CMake. Anche Android Studio supporta ndk-build a causa delle grandi di progetti esistenti che usano il toolkit di creazione. Tuttavia, se creando una nuova libreria nativa, dovresti usare CMake.

Questa guida ti fornisce le informazioni necessarie per iniziare a utilizzare il NDK su Android Studio. Se non hai l'ultima versione di Android Studio, scaricalo e installalo ora.

Attenzione agli utenti Gradle sperimentali: prendi in considerazione migrazione al plug-in versione 2.2.0 o successiva e all'utilizzo di CMake o ndk-build per creare le tue librerie native se una delle seguenti condizioni si applica al tuo caso: il progetto nativo utilizza già CMake o ndk-build; preferiresti utilizzare una versione stabile del sistema di compilazione Gradle; o se hai bisogno di assistenza per strumenti aggiuntivi, ad esempio CCache. Altrimenti, puoi continuare a utilizzare la versione sperimentale di Gradle e il plug-in Android.

Scarica l'NDK e gli strumenti

Per compilare ed eseguire il debug di codice nativo per la tua app, devi avere quanto segue componenti:

  • Android Native Development Kit (NDK), una serie di strumenti che ti consente per utilizzare il codice C e C++ con Android.
  • CMake: uno strumento di creazione esterno che funziona insieme a Gradle per creare libreria nativa. Non ti serve questo componente se prevedi di utilizzarlo ndk-build.
  • LLDB: il debugger utilizzato da Android Studio per eseguire il debug del codice nativo.

Per informazioni sull'installazione di questi componenti, consulta l'articolo Installare e configurare NDK e CMake.

Creare o importare un progetto nativo

Dopo aver configurato Android Studio, puoi semplicemente creare un nuovo progetto con C/C++. Tuttavia, se vuoi aggiungere o importare codice nativo in una progetto Android Studio esistente, devi seguire questa procedura di base:

  1. Crea nuovo nativi di origine e aggiungili al tuo progetto Android Studio.
    • Puoi saltare questo passaggio se hai già del codice nativo o se vuoi importare una libreria nativa predefinita.
  2. Crea uno script di build CMake per indicare a CMake come creare le tue origini native in una biblioteca. Questo script di compilazione è necessario anche se importi e il collegamento a librerie predefinite o della piattaforma.
    • Puoi saltare questo passaggio se la tua libreria nativa esistente ha già un CMakeLists.txt oppure utilizza ndk-build e include Android.mk script di compilazione.
  3. Collega Gradle a tua libreria nativa fornendo un percorso per CMake o ndk-build del file di script. Gradle utilizza lo script di build per importare il codice sorgente progetto Android Studio e pacchettizza la tua libreria nativa (il file SO) in l'APK.

    Nota:se il progetto esistente utilizza il modello deprecato ndkCompile, dovresti aprire build.properties e rimuovi la seguente riga di codice prima di configurare Gradle per l'utilizzo di CMake o ndk-build: 

    // Remove this line
android.useDeprecatedNdk = true
  4. Crea ed esegui la tua app facendo clic su Esegui Esegui ed esegui l'app dal menu principale. Aggiunte da Gradle il tuo processo CMake o ndk-build come dipendenza per compilare, pacchettizzare la tua libreria nativa con il tuo APK.

Quando l'app è in esecuzione su un dispositivo fisico o sull'emulatore, puoi usare Android Studio per eseguire il debug dell'app. In caso contrario, per saperne di più sull'NDK e sui suoi componenti, leggi la pagina Concetti.