Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Pour compiler et déboguer le code natif de votre application, vous avez besoin des composants suivants :
Le kit de développement Android natif (NDK) : ensemble d'outils qui vous permet d'utiliser le code C et C++ avec Android.
CMake : outil de compilation externe qui fonctionne avec Gradle pour créer votre bibliothèque native. Vous n'avez pas besoin de ce composant si vous prévoyez uniquement d'utiliser ndk-build.
LLDB : débogueur utilisé par Android Studio pour déboguer le code natif. Par défaut, LLDB sera installé avec Android Studio.
Cette page explique comment installer ces composants automatiquement, ou en utilisant Android Studio ou l'outil sdkmanager pour les télécharger et les installer manuellement.
Installer automatiquement le NDK et CMake
Le plug-in Android Gradle 4.2.0+ peut installer automatiquement CMake et le NDK requis la première fois que vous compilez votre projet si leurs licences ont été acceptées à l'avance.
Si vous avez déjà lu et accepté les conditions d'utilisation de la licence, vous pouvez pré-accepter les licences dans des scripts à l'aide de la commande suivante :
Lorsque vous installez le NDK, Android Studio sélectionne le dernier NDK disponible. Pour la plupart des projets, l'installation de cette version par défaut du NDK est suffisante.
Si votre projet nécessite une ou plusieurs versions spécifiques du NDK, vous pouvez télécharger et configurer des versions spécifiques. Cela vous permet de vous assurer que les compilations reproductibles des projets dépendent chacune d'une version spécifique du NDK. Android Studio installe toutes les versions du NDK dans le répertoire android-sdk/ndk/.
Pour installer CMake et le NDK par défaut dans Android Studio, procédez comme suit :
Ouvrez un projet, puis cliquez sur Tools > SDK Manager (Outils > SDK Manager).
Cliquez sur l'onglet SDK Tools.
Cochez les cases NDK (Side by side) (NDK (côte à côte)) et CMake.
Figure 1 : Fenêtre SDK Tools qui affiche l'option NDK (Side by side) (NDK (côte à côte))
Cliquez sur OK.
Une boîte de dialogue vous indique l'espace que le package NDK utilise sur le disque.
Cliquez sur OK.
Une fois l'installation terminée, cliquez sur Finish (Terminer).
Votre projet synchronise automatiquement le fichier de compilation et exécute une compilation.
Corrigez les erreurs qui se produisent.
Configurer une version spécifique de CMake
SDK Manager inclut la version dupliquée 3.6.0 de CMake et la version 3.10.2. Les projets qui ne définissent pas de version CMake spécifique sont créés avec CMake 3.10.2. Pour définir la version de CMake, ajoutez les éléments suivants au fichier build.gradle de votre module :
Si vous souhaitez utiliser une version de CMake non incluse par SDK Manager, procédez comme suit :
Téléchargez et installez CMake à partir du site Web officiel de CMake.
Spécifiez la version de CMake que Gradle doit utiliser dans le fichier build.gradle de votre module.
Ajoutez le chemin d'accès à l'installation de CMake à votre variable d'environnement PATH ou incluez-le dans le fichier local.properties de votre projet, comme indiqué. Si Gradle ne parvient pas à trouver la version de CMake que vous avez spécifiée dans le fichier build.gradle, vous obtenez une erreur de compilation.
# If you set this property, Gradle no longer uses PATH to find CMake.
cmake.dir = "path-to-cmake"</pre>
Si le système de compilation Ninja n'est pas encore installé sur votre station de travail, accédez au site Web officiel de Ninja, puis téléchargez et installez la dernière version de Ninja disponible pour votre OS.
Veillez également à ajouter le chemin d'accès à l'installation de Ninja à votre variable d'environnement PATH.
Installer une version spécifique du NDK
Pour installer une version spécifique du NDK, procédez comme suit :
Ouvrez un projet, puis cliquez sur Tools > SDK Manager (Outils > SDK Manager).
Cliquez sur l'onglet SDK Tools.
Cochez la case Show Package Details (Afficher les détails du package).
Cochez la case NDK (Side by side) (NDK (côte à côte)) et les cases situées en dessous correspondant aux versions NDK que vous souhaitez installer. Android Studio installe toutes les versions du NDK dans le répertoire android-sdk/ndk/.
Figure 2 : Fenêtre SDK Tools qui affiche les options NDK (Side by side) (NDK (côte à côte))
Cliquez sur OK.
Une boîte de dialogue vous indique l'espace que le ou les packages NDK utilisent.
Cliquez sur OK.
Une fois l'installation terminée, cliquez sur Finish (Terminer).
Votre projet synchronise automatiquement le fichier de compilation et exécute une compilation.
Corrigez les erreurs qui se produisent.
Configurez chaque module avec la version du NDK que vous souhaitez utiliser. Lorsque vous utilisez Android Studio 3.6 ou version ultérieure, si vous ne spécifiez pas la version, le plug-in Android Gradle choisit une version avec laquelle il est compatible.
Configurer des versions spécifiques du NDK dans votre projet
Vous devrez peut-être configurer la version du NDK dans votre projet si l'une des conditions suivantes est remplie :
Votre projet est hérité, et vous devez utiliser des versions spécifiques du NDK et du plug-in Android Gradle (AGP). Pour en savoir plus, consultez Configurer le NDK pour le plug-in Android Gradle.
Plusieurs versions du NDK sont installées et vous souhaitez utiliser une version spécifique. Dans ce cas, spécifiez la version à l'aide de la propriété android.ndkVersion dans le fichier build.gradle du module, comme indiqué dans l'exemple de code suivant.
Avant la publication, chaque version AGP est testée de manière approfondie avec la dernière version NDK stable à ce moment-là. Cette version du NDK est utilisée pour compiler vos projets si vous ne spécifiez pas de version du NDK dans le fichier build.gradle. La version NDK par défaut pour les différentes versions d'AGP est documentée dans les notes de version d'AGP et les anciennes notes de version d'AGP.
Le contenu et les exemples de code de cette page sont soumis aux licences décrites dans la Licence de contenu. Java et OpenJDK sont des marques ou des marques déposées d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/27 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Il n'y a pas l'information dont j'ai besoin","missingTheInformationINeed","thumb-down"],["Trop compliqué/Trop d'étapes","tooComplicatedTooManySteps","thumb-down"],["Obsolète","outOfDate","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Mauvais exemple/Erreur de code","samplesCodeIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/08/27 (UTC)."],[],[],null,["To compile and debug native code for your app, you need the following components:\n\n- The Android Native Development Kit (NDK): a set of tools that allows you to use C and C++ code with Android.\n- CMake: an external build tool that works alongside Gradle to build your native library. You do not need this component if you only plan to use ndk-build.\n- LLDB: the debugger Android Studio uses to debug native code. By default, LLDB will be installed alongside Android Studio.\n\nThis page describes how to install these components automatically, or by using\nAndroid Studio or the `sdkmanager` tool to download and install them manually.\n\nInstall NDK and CMake automatically\n\nAndroid Gradle Plugin 4.2.0+ can automatically install the required NDK and CMake\nthe first time you build your project if their licenses have been accepted in advance.\nIf you've already read and agree to the license terms, then you can pre-accept\nthe licenses in scripts with the following command: \n\n yes | ${sdk}/cmdline-tools/latest/bin/sdkmanager --licenses\n\nInstall the NDK and CMake\n\nWhen you install the NDK, Android Studio selects the latest available NDK. For\nmost projects, installing this default version of the NDK is sufficient.\nIf your project needs one or more specific versions of the NDK, though, you can\n[download and configure specific versions](#specific-version). Doing so helps\nyou ensure reproducible builds across projects that each depend on a specific\nversion of the NDK. Android Studio installs all versions of the NDK in the\n\u003cvar translate=\"no\"\u003eandroid-sdk\u003c/var\u003e`/ndk/` directory.\n\nTo install CMake and the default NDK in Android Studio, do the following:\n\n1. With a project open, click **Tools \\\u003e SDK Manager**.\n\n2. Click the **SDK Tools** tab.\n\n3. Select the **NDK (Side by side)** and **CMake** checkboxes.\n\n\n **Figure 1.** The **SDK Tools** window showing the **NDK (Side by side)**\n option\n | **Note:** If you have an NDK installed in the `ndk-bundle` folder, it appears in the list with the label **NDK** . If you are using Android Gradle plugin 3.5.0 or later, you can select this checkbox or clear it. Clearing the checkbox uninstalls the NDK, freeing up disk space, and causes the checkbox to disappear from the list. If you uninstall the legacy NDK, remove the `ndk.dir` value, which is now deprecated, from your projects' `local.properties` files.\n4. Click **OK**.\n\n A dialog box tells you how much space the NDK package consumes on disk.\n5. Click **OK**.\n\n6. When the installation is complete, click **Finish**.\n\n7. Your project automatically syncs the build file and performs a build.\n Resolve any errors that occur.\n\nConfigure a specific version of CMake\n\nThe SDK Manager includes the 3.6.0 forked version of\nCMake and version 3.10.2. Projects that don't set a\nspecific CMake version are built with CMake 3.10.2. To\nset the CMake version, add the following to your module's `build.gradle` file: \n\nGroovy \n\n```groovy\nandroid {\n ...\n externalNativeBuild {\n cmake {\n ...\n version \"\u003cvar translate=\"no\"\u003ecmake-version\u003c/var\u003e\"\n }\n }\n}\n```\n\nKotlin \n\n```kotlin\nandroid {\n ...\n externalNativeBuild {\n cmake {\n ...\n version = \"\u003cvar translate=\"no\"\u003ecmake-version\u003c/var\u003e\"\n }\n }\n}\n```\n\nIf you want to use a CMake version that is not included by the\nSDK Manager, follow these steps:\n\n1. Download and install [CMake](https://cmake.org/download/) from the official CMake website.\n2. Specify the CMake version you want Gradle to use in your module's `build.gradle` file.\n3. Either add the path to the CMake installation to your `PATH` environment\n variable or include it in your project's `local.properties` file, as\n shown. If Gradle is unable to find the version of CMake you specified in\n your `build.gradle` file, you get a build error.\n\n # If you set this property, Gradle no longer uses PATH to find CMake.\n cmake.dir = \"\u003cvar translate=\"no\"\u003epath-to-cmake\u003c/var\u003e\"\u003c/pre\u003e\n\n4. If you don't already have the Ninja build system installed on your\n workstation, go to the [official Ninja website](https://ninja-build.org/),\n and download and install the latest version of Ninja available for your OS.\n Make sure to also add the path to the Ninja installation to your\n `PATH` environment variable.\n\nInstall a specific version of the NDK\n\nTo install a specific version of the NDK, do the following:\n\n1. With a project open, click **Tools \\\u003e SDK Manager**.\n\n2. Click the **SDK Tools** tab.\n\n3. Select the **Show Package Details** checkbox.\n\n4. Select the **NDK (Side by side)** checkbox and the checkboxes below it that\n correspond to the NDK versions you want to install. Android Studio installs\n all versions of the NDK in the \u003cvar translate=\"no\"\u003eandroid-sdk\u003c/var\u003e`/ndk/`\n directory.\n\n | **Note:** Preview releases (for example, canary and beta) of the NDK do not show up in this list unless you [change the update channel](/studio/preview/install-preview#change_your_update_channel) for Android Studio. You can [install an Android Studio preview](/studio/preview/install-preview) side-by-side with the stable version.\n\n\n **Figure 2.** The **SDK Tools** window showing the **NDK (Side by side)**\n options\n | **Note:** If you have an NDK installed in the `ndk-bundle` folder, it appears in the list with the label **NDK** . If you are using Gradle version 3.5 or later, you can select this checkbox or clear it. Clearing it uninstalls the NDK installed, freeing up disk space, and cause the checkbox to disappear from the list. If you uninstall the legacy NDK, remove the `ndk.dir` value, which is now deprecated, from your projects' `local.properties` files.\n5. Click **OK**.\n\n A dialog box tells you how much space the NDK package(s) consumes.\n6. Click **OK**.\n\n7. When the installation is complete, click **Finish**.\n\n8. Your project automatically syncs the build file and performs a build.\n Resolve any errors that occur.\n\n9. [Configure each module](#apply-specific-version) with the version of the NDK\n you want it to use. When using Android Studio 3.6 or higher, if you do not\n specify the version, the Android Gradle plugin chooses a version that it is\n known to be compatible with.\n\nConfigure specific versions of the NDK in your project\n\nYou may need to configure the version of the NDK in your project if one of the\nfollowing is true:\n\n- Your project is inherited and you need to use specific versions of the NDK and the Android Gradle plugin (AGP). For more information, see [Configure the NDK for the Android Gradle plugin](/studio/projects/configure-agp-ndk).\n- You have multiple versions of the NDK installed and you want to use a specific\n one. In this case, specify the version using the `android.ndkVersion`\n property in the module's `build.gradle` file, as shown in the following code\n sample.\n\n Groovy \n\n ```groovy\n android {\n ndkVersion \"\u003cvar translate=\"no\"\u003emajor\u003c/var\u003e.\u003cvar translate=\"no\"\u003eminor\u003c/var\u003e.\u003cvar translate=\"no\"\u003ebuild\u003c/var\u003e\" // e.g., ndkVersion \"21.3.6528147\"\n }\n ```\n\n Kotlin \n\n ```kotlin\n android {\n ndkVersion = \"\u003cvar translate=\"no\"\u003emajor\u003c/var\u003e.\u003cvar translate=\"no\"\u003eminor\u003c/var\u003e.\u003cvar translate=\"no\"\u003ebuild\u003c/var\u003e\" // e.g., ndkVersion \"21.3.6528147\"\n }\n ```\n\nDefault NDK version per AGP version\n\nBefore release, each AGP version is thoroughly tested with the latest stable NDK\nrelease at that time. This NDK version is used to build your projects if you\ndon't specify an NDK version in the `build.gradle` file. The default NDK version\nfor different versions of AGP are documented in the\n[AGP release notes](/build/releases/gradle-plugin#compatibility) and\n[AGP past release notes](/build/releases/past-releases)."]]
Figure 1 : Fenêtre SDK Tools qui affiche l'option NDK (Side by side) (NDK (côte à côte))
Figure 2 : Fenêtre SDK Tools qui affiche les options NDK (Side by side) (NDK (côte à côte))