O Google tem o compromisso de promover a igualdade racial para as comunidades negras. Saiba como.

Instalar e configurar o NDK e o CMake

Para compilar e depurar código nativo para um app, serão necessários os seguintes componentes:

  • Kit de desenvolvimento nativo do Android (NDK, na sigla em inglês): um conjunto de ferramentas que permitem usar códigos C e C++ com o Android.
  • CMake: uma ferramenta de criação externa que funciona com o Gradle para criar sua biblioteca nativa. Esse componente não é necessário se você pretende usar apenas o ndk-build.
  • LLDB: o depurador usado pelo Android Studio para depurar códigos nativos. Por padrão, o LLDB será instalado com o Android Studio.

Esta página descreve como usar o Android Studio ou a ferramenta sdkmanager para fazer o download desses componentes e instalá-los.

Instalar o NDK e o CMake

Quando você instala o NDK, o Android Studio seleciona o NDK mais recente disponível. Para a maioria dos projetos, a instalação dessa versão padrão do NDK é o suficiente. No entanto, caso seu projeto precise de uma ou mais versões específicas do NDK, você poderá fazer o download e a configuração de versões específicas. Isso ajuda a garantir a criação de versões reproduzíveis em projetos que dependem de uma versão específica do NDK. O Android Studio instala todas as versões do NDK no diretório android-sdk/ndk/.

Para instalar o CMake e o NDK padrão no Android Studio, siga estas etapas:

  1. Com um projeto aberto, clique em Tools > SDK Manager.

  2. Clique na guia SDK Tools.

  3. Marque as caixas de seleção NDK (Side by side) e CMake.

    Imagem do SDK Manager Figura 1: a janela SDK Tools mostrando a opção NDK (Side by side).

  4. Clique em OK.

    Uma caixa de diálogo informará quanto espaço o pacote NDK consome no disco.

  5. Clique em OK.

  6. Quando a instalação estiver concluída, clique em Finish.

  7. Seu projeto sincronizará automaticamente o arquivo de versão e criará uma nova versão. Resolva os erros que ocorrerem.

Instalar uma versão específica do NDK

Para instalar uma versão específica do NDK, siga estas etapas:

  1. Com um projeto aberto, clique em Tools > SDK Manager.

  2. Clique na guia SDK Tools.

  3. Marque a caixa de seleção Show Package Details.

  4. Marque a caixa de seleção NDK (Side by side) e as caixas de seleção abaixo que corresponderem às versões do NDK que você quer instalar. O Android Studio instala todas as versões do NDK no diretório android-sdk/ndk/.

    Imagem da janela do Ferramentas do SDK Figura 2: a janela SDK Tools mostrando as opções NDK (Side by side).

  5. Clique em OK.

    Uma caixa de diálogo informará quanto espaço os pacotes NDK consomem no disco.

  6. Clique em OK.

  7. Quando a instalação estiver concluída, clique em Finish.

  8. Seu projeto sincronizará automaticamente o arquivo de versão e criará uma nova versão. Resolva os erros que ocorrerem.

  9. Configure cada módulo com a versão do NDK que você quer que o projeto use. Ao usar o Android Studio 3.6 ou versões mais recentes, caso a versão não seja especificada, o plug-in do Android Gradle escolherá uma versão com que seja compatível.

Instalar o NDK na linha de comando

Para instalar uma ou mais versões do NDK usando a linha de comando, siga estas etapas:

  1. Use a ferramenta sdkmanager para ver versões dos pacotes CMake e NDK disponíveis:

    sdkmanager --list
        
  2. Passe as strings ao sdkmanager pelos pacotes que você quer instalar. Por exemplo, para instalar o CMake e o NDK, use a seguinte sintaxe:

        sdkmanager --install
                  "ndk;major.minor.build"
                  "cmake;major.minor.micro.build"
        
  3. Configure cada módulo do projeto com a versão do NDK que você quer que ele use.

Configurar versões específicas do NDK no projeto

Se você instalar uma versão específica do NDK e quiser usá-la em um módulo, especifique a versão usando a propriedade android.ndkVersion no arquivo build.gradle do módulo, conforme mostrado na amostra de código a seguir.

    android {
        ndkVersion "major.minor.build"
    }