Google se compromete a impulsar la igualdad racial para las comunidades afrodescendientes. Obtén información al respecto.

Cómo instalar y configurar el NDK y CMake

Para compilar y depurar el código nativo para tu app, necesitas los siguientes componentes:

  • El kit de desarrollo nativo (NDK) de Android: es un conjunto de herramientas que te permite utilizar código C y C++ con Android.
  • CMake: es una herramienta de compilación externa que funciona junto con Gradle para compilar tu biblioteca nativa. No necesitas este componente si solo planeas usar ndk-build.
  • LLDB es el depurador que usa Android Studio para depurar código nativo. De forma predeterminada, LLDB se instala junto con Android Studio.

En esta página, se describe cómo usar Android Studio o la herramienta sdkmanager para descargar e instalar esos componentes.

Cómo instalar el NDK y CMake

Cuando instalas el NDK, Android Studio selecciona el último NDK disponible. Para la mayoría de los proyectos, instalar esa versión predeterminada del NDK es suficiente. Sin embargo, si tu proyecto necesita una o más versiones específicas del NDK, puedes descargarlas y configurarlas. Eso te ayudará a garantizar compilaciones reproducibles en proyectos que dependan de una versión específica del NDK. Android Studio instala todas las versiones del NDK en el directorio android-sdk/ndk/.

Para instalar CMake y el NDK predeterminado en Android Studio, debes hacer lo siguiente:

  1. Con un proyecto abierto, haz clic en Tools > SDK Manager.

  2. Haz clic en la pestaña SDK Tools.

  3. Selecciona las casillas de verificación NDK (Side by side) y CMake.

    Imagen de SDK Manager Figura 1: La ventana Herramientas del SDK donde se muestra la opción NDK (Side by side)

  4. Haz clic en OK.

    Un cuadro de diálogo te indica cuánto espacio consume el paquete NDK en el disco.

  5. Haz clic en Aceptar.

  6. Cuando finalices la instalación, haz clic en Finish.

  7. Tu proyecto sincronizará automáticamente el archivo de compilación y realizará una. Resuelve cualquier error que se genere.

Cómo configurar una versión específica de CMake

SDK Manager incluye la versión bifurcada de CMake 3.6.0 y 3.10.2. Los proyectos en los que no se configura una versión específica de CMake se compilan con CMake 3.10.2. Para configurar la versión de CMake, agrega lo siguiente al archivo build.gradle de tu módulo:

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

Si deseas usar CMake 3.7 o una versión posterior que no se incluye en SDK Manager, sigue estos pasos:

  1. Descarga e instala CMake 3.7 o una versión posterior desde el sitio web oficial de CMake.
  2. Especifica la versión de CMake que deseas que use Gradle en el archivo build.gradle del módulo:
  3. Agrega la ruta de acceso a la instalación de CMake a la variable de entorno PATH o inclúyela en el archivo local.properties del proyecto, como se muestra a continuación. Si Gradle no encuentra la versión de CMake que especificaste en el archivo build.gradle, se mostrará un error de compilación.

    # If you set this property, Gradle no longer uses PATH to find CMake.
    cmake.dir="path-to-cmake"
    
  4. Si aún no tienes instalado el sistema de compilación Ninja en tu estación de trabajo, accede al sitio web oficial y descarga e instala la versión más reciente disponible para tu SO. Asegúrate de agregar también la ruta de acceso a la instalación de Ninja a la variable de entorno PATH.

Cómo instalar una versión específica del NDK

Para instalar una versión específica del NDK, debes hacer lo siguiente:

  1. Con un proyecto abierto, haz clic en Tools > SDK Manager.

  2. Haz clic en la pestaña SDK Tools.

  3. Selecciona la casilla de verificación Show Package Details.

  4. Selecciona la casilla de verificación NDK (Side by side) y las que se encuentran debajo de ella que correspondan a las versiones del NDK que deseas instalar. Android Studio instala todas las versiones del NDK en el directorio android-sdk/ndk/.

    Imagen de la ventana SDK Tools Figura 2: La ventana Herramientas del SDK donde se muestran las opciones de NDK (Side by side)

  5. Haz clic en OK.

    Un cuadro de diálogo te indica cuánto espacio consumen los paquetes NDK.

  6. Haz clic en Aceptar.

  7. Cuando finalices la instalación, haz clic en Finish.

  8. Tu proyecto sincronizará automáticamente el archivo de compilación y realizará una. Resuelve cualquier error que se genere.

  9. Configura cada módulo con la versión del NDK que quieres que use. Cuando usas Android Studio 3.6 o una versión posterior, si no especificas la versión, el complemento de Gradle para Android elige una que reconoce como compatible.

Cómo configurar versiones específicas del NDK en tu proyecto

Es posible que debas configurar la versión del NDK en tu proyecto si se cumple alguna de las siguientes condiciones:

  • Tu proyecto es heredado y debes usar versiones específicas del NDK y del complemento de Gradle para Android (AGP). Para obtener más información, consulta Cómo configurar el NDK para el complemento de Gradle para Android.
  • Hay varias versiones del NDK instaladas y quieres usar una específica. En ese caso, indica la versión mediante la propiedad android.ndkVersion en el archivo build.gradle del módulo, como se muestra en la siguiente muestra de código.
android {
    ndkVersion "major.minor.build" // e.g.,  ndkVersion '21.3.6528147'
}

Versión predeterminada del NDK según la versión del AGP

Antes del lanzamiento, cada versión de AGP se prueba de manera exhaustiva con la versión estable del NDK más reciente en ese momento. En el caso de AGP 3.6 y versiones posteriores, se usará esa versión del NDK a fin de compilar tus proyectos si NO especificas una versión del NDK en el archivo build.gradle. La versión predeterminada del NDK está documentada dentro de las notas de la versión de AGP. En la siguiente tabla, se muestran las versiones predeterminadas actuales del NDK:

Versión del complemento de Android Studio y Gradle
4.1 4.0 3.6 3.5 3.4
Versión predeterminada del NDK
que se especificó para la versión de AGP
21.1.6352462 21.0.6113669 20.0.5594570 No se especificó ninguna versión predeterminada