Installare e configurare NDK e CMake

Per compilare ed eseguire il debug del codice nativo per la tua app, devi disporre dei seguenti componenti:

• Android Native Development Kit (NDK): un insieme di strumenti che ti consente di utilizzare il codice C e C++ con Android.
• CMake: uno strumento di compilazione esterno che funziona insieme a Gradle per compilare la libreria nativa. Non hai bisogno di questo componente se prevedi di utilizzare solo ndk-build.
• LLDB: il debugger utilizzato da Android Studio per eseguire il debug del codice nativo. Per impostazione predefinita, LLDB viene installato insieme ad Android Studio.

Questa pagina descrive come installare questi componenti automaticamente o utilizzando Android Studio o lo strumento sdkmanager per scaricarli e installarli manualmente.

Installare automaticamente NDK e CMake

Il plug-in Android per Gradle 4.2.0 e versioni successive può installare automaticamente NDK e CMake richiesti la prima volta che compili il progetto se le relative licenze sono state accettate in anticipo. Se hai già letto e accettato i termini di licenza, puoi pre-accettare le licenze negli script con il seguente comando:

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

Installa l'NDK e CMake

Quando installi l'NDK, Android Studio seleziona l'NDK più recente disponibile. Per la maggior parte dei progetti, l'installazione di questa versione predefinita dell'NDK è sufficiente. Se il tuo progetto richiede una o più versioni specifiche dell'NDK, puoi scaricare e configurare versioni specifiche. In questo modo, puoi assicurarti build riproducibili in progetti che dipendono da una versione specifica dell'NDK. Android Studio installa tutte le versioni dell'NDK nella directory android-sdk/ndk/.

Per installare CMake e l'NDK predefinito in Android Studio:

1. Con un progetto aperto, fai clic su Strumenti > SDK Manager.

2. Fai clic sulla scheda SDK Tools (Strumenti SDK).

3. Seleziona le caselle di controllo NDK (Side by side) e CMake.

   Figura 1. La finestra SDK Tools che mostra l'opzione NDK (Side by side)

   Nota: se hai installato un NDK nella cartella ndk-bundle, questo viene visualizzato nell'elenco con l'etichetta NDK. Se utilizzi il plug-in Android per Gradle 3.5.0 o versioni successive, puoi selezionare o deselezionare questa casella di controllo. Se deselezioni la casella di controllo, l'NDK viene disinstallato, liberando spazio su disco, e la casella di controllo scompare dall'elenco. Se disinstalli l'NDK precedente, rimuovi il valore ndk.dir, ora ritirato, dai file local.properties dei tuoi progetti.

4. Fai clic su OK.

   Una finestra di dialogo indica la quantità di spazio su disco occupata dal pacchetto NDK.

5. Fai clic su OK.

6. Al termine dell'installazione, fai clic su Fine.

7. Il progetto sincronizza automaticamente il file di build ed esegue una build. Risolvi eventuali errori.

Configura una versione specifica di CMake

SDK Manager include la versione fork 3.6.0 di CMake e la versione 3.10.2. I progetti che non impostano una versione specifica di CMake vengono creati con CMake 3.10.2. Per impostare la versione di CMake, aggiungi quanto segue al file build.gradle del modulo:

Groovy

android {
    ...
    externalNativeBuild {
        cmake {
            ...
            version "cmake-version"
        }
    }
}

Kotlin

android {
    ...
    externalNativeBuild {
        cmake {
            ...
            version = "cmake-version"
        }
    }
}

Se vuoi utilizzare una versione di CMake non inclusa in SDK Manager, segui questi passaggi:

1. Scarica e installa CMake dal sito web ufficiale di CMake.
2. Specifica la versione di CMake che vuoi che Gradle utilizzi nel file build.gradle del modulo.

3. Aggiungi il percorso all'installazione di CMake alla variabile di ambiente PATH o includilo nel file local.properties del progetto, come mostrato. Se Gradle non riesce a trovare la versione di CMake specificata nel file build.gradle, viene visualizzato un errore di build.

   # If you set this property, Gradle no longer uses PATH to find CMake.
   cmake.dir = "path-to-cmake"</pre>
   

4. Se non hai già installato il sistema di compilazione Ninja sulla tua workstation, vai al sito web ufficiale di Ninja, scarica e installa l'ultima versione di Ninja disponibile per il tuo sistema operativo. Assicurati di aggiungere anche il percorso dell'installazione di Ninja alla variabile di ambiente PATH.

Installare una versione specifica dell'NDK

Per installare una versione specifica dell'NDK:

1. Con un progetto aperto, fai clic su Strumenti > SDK Manager.

2. Fai clic sulla scheda SDK Tools (Strumenti SDK).

3. Seleziona la casella di controllo Mostra dettagli pacchetto.

4. Seleziona la casella di controllo NDK (Side by side) e le caselle di controllo sottostanti che corrispondono alle versioni dell'NDK che vuoi installare. Android Studio installa tutte le versioni dell'NDK nella directory android-sdk/ndk/.

   Nota :le versioni di anteprima (ad esempio canary e beta) dell'NDK non vengono visualizzate in questo elenco a meno che tu non modifica il canale di aggiornamento per Android Studio. Puoi installare un'anteprima di Android Studio accanto alla versione stabile.

   Figura 2. La finestra SDK Tools che mostra le opzioni NDK (Side by side)

   Nota: se hai installato un NDK nella cartella ndk-bundle, questo viene visualizzato nell'elenco con l'etichetta NDK. Se utilizzi Gradle versione 3.5 o successiva, puoi selezionare o deselezionare questa casella di controllo. Se lo cancelli, l'NDK installato viene disinstallato, lo spazio su disco viene liberato e la casella di controllo scompare dall'elenco. Se disinstalli l'NDK precedente, rimuovi il valore ndk.dir, ora ritirato, dai file local.properties dei tuoi progetti.

5. Fai clic su OK.

   Una finestra di dialogo indica la quantità di spazio occupata dai pacchetti NDK.

6. Fai clic su OK.

7. Al termine dell'installazione, fai clic su Fine.

8. Il progetto sincronizza automaticamente il file di build ed esegue una build. Risolvi eventuali errori.

9. Configura ogni modulo con la versione dell'NDK che vuoi utilizzare. Quando utilizzi Android Studio 3.6 o versioni successive, se non specifichi la versione, il plug-in Android Gradle sceglie una versione nota per essere compatibile.

Configurare versioni specifiche dell'NDK nel progetto

Potresti dover configurare la versione dell'NDK nel tuo progetto se una delle seguenti condizioni è vera:

• Il tuo progetto è ereditato e devi utilizzare versioni specifiche dell'NDK e del plug-in Android Gradle (AGP). Per ulteriori informazioni, consulta Configurare l'NDK per il plug-in Android per Gradle.

• Hai installato più versioni dell'NDK e vuoi utilizzarne una specifica. In questo caso, specifica la versione utilizzando la proprietà android.ndkVersion nel file build.gradle del modulo, come mostrato nel seguente esempio di codice.

  Groovy

  android {
      ndkVersion "major.minor.build" // e.g.,  ndkVersion "21.3.6528147"
  }

  Kotlin

  android {
      ndkVersion = "major.minor.build" // e.g.,  ndkVersion "21.3.6528147"
  }

Versione NDK predefinita per versione AGP

Prima del rilascio, ogni versione di AGP viene testata a fondo con l'ultima release stabile dell'NDK disponibile in quel momento. Questa versione dell'NDK viene utilizzata per creare i tuoi progetti se non specifichi una versione dell'NDK nel file build.gradle. La versione NDK predefinita per le diverse versioni di AGP è documentata nelle note di rilascio di AGP e nelle note di rilascio precedenti di AGP.