Установите и настройте NDK и CMake.

Для компиляции и отладки собственного кода вашего приложения вам понадобятся следующие компоненты:

• Android Native Development Kit (NDK): набор инструментов, позволяющий использовать код C и C++ с Android.
• CMake: внешний инструмент сборки, работающий вместе с Gradle для сборки вашей нативной библиотеки. Этот компонент вам не нужен, если вы планируете использовать только ndk-build.
• LLDB: отладчик, используемый Android Studio для отладки нативного кода. По умолчанию LLDB устанавливается вместе с Android Studio.

На этой странице описывается, как установить эти компоненты автоматически или с помощью Android Studio или инструмента sdkmanager для их загрузки и установки вручную.

Установить NDK и CMake автоматически

Плагин Android Gradle 4.2.0+ может автоматически установить необходимые NDK и CMake при первой сборке проекта, если их лицензии были приняты заранее. Если вы уже ознакомились с условиями лицензии и согласны с ними, вы можете предварительно принять их в скриптах с помощью следующей команды:

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

Установите NDK и CMake

При установке NDK Android Studio выбирает последнюю доступную версию NDK. Для большинства проектов достаточно установки этой версии NDK по умолчанию. Однако, если вашему проекту требуется одна или несколько определённых версий NDK, вы можете загрузить и настроить нужные версии . Это поможет обеспечить воспроизводимость сборок в проектах, каждый из которых зависит от определённой версии NDK. Android Studio устанавливает все версии NDK в каталог android-sdk /ndk/ .

Чтобы установить CMake и NDK по умолчанию в Android Studio, выполните следующие действия:

1. Открыв проект, нажмите Инструменты > Менеджер SDK .

2. Откройте вкладку «Инструменты SDK» .

3. Установите флажки NDK (Бок о бок) и CMake .

   Рисунок 1. Окно инструментов SDK , показывающее опцию NDK (бок о бок)

4. Нажмите ОК .

   В диалоговом окне будет указано, сколько места занимает пакет NDK на диске.

5. Нажмите ОК .

6. После завершения установки нажмите кнопку Готово .

7. Ваш проект автоматически синхронизирует файл сборки и выполняет сборку. Устраните все возникающие ошибки.

Настройте конкретную версию CMake

SDK Manager включает в себя форк CMake 3.6.0 и версию 3.10.2. Проекты, для которых не указана конкретная версия CMake, собираются с использованием CMake 3.10.2. Чтобы указать версию CMake, добавьте следующее в файл build.gradle вашего модуля:

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

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

Если вы хотите использовать версию CMake, которая не включена в SDK Manager, выполните следующие действия:

1. Загрузите и установите CMake с официального сайта CMake.
2. Укажите версию CMake, которую Gradle должен использовать, в файле build.gradle вашего модуля.

3. Добавьте путь к установке CMake в переменную окружения PATH или в файл local.properties вашего проекта, как показано ниже. Если Gradle не может найти версию CMake, указанную в файле build.gradle , возникнет ошибка сборки.

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

4. Если на вашей рабочей станции ещё не установлена система сборки Ninja, перейдите на официальный сайт Ninja , скачайте и установите последнюю версию Ninja для вашей ОС. Не забудьте также добавить путь к установленной системе Ninja в переменную окружения PATH .

Установить определенную версию NDK

Чтобы установить конкретную версию NDK, выполните следующие действия:

1. Открыв проект, нажмите Инструменты > Менеджер SDK .

2. Откройте вкладку «Инструменты SDK» .

3. Установите флажок Показать сведения о пакете .

4. Установите флажок NDK (Side by side) и флажки под ним, соответствующие версиям NDK, которые вы хотите установить. Android Studio устанавливает все версии NDK в каталог android-sdk /ndk/ .

   Рисунок 2. Окно инструментов SDK, показывающее параметры NDK (бок о бок)

5. Нажмите ОК .

   В диалоговом окне отображается информация о том, сколько места занимают пакеты NDK.

6. Нажмите ОК .

7. После завершения установки нажмите кнопку Готово .

8. Ваш проект автоматически синхронизирует файл сборки и выполняет сборку. Устраните все возникающие ошибки.

9. Настройте каждый модуль , указав нужную версию NDK. При использовании Android Studio 3.6 или выше, если версия не указана, плагин Android Gradle выберет версию, с которой он заведомо совместим.

Настройте конкретные версии NDK в вашем проекте

Вам может потребоваться настроить версию NDK в вашем проекте, если выполняется одно из следующих условий:

• Ваш проект унаследован, и вам необходимо использовать определённые версии NDK и плагина Android Gradle (AGP). Подробнее см. в разделе «Настройка NDK для плагина Android Gradle» .

• У вас установлено несколько версий NDK, и вы хотите использовать определённую. В этом случае укажите версию с помощью свойства android.ndkVersion в файле build.gradle модуля, как показано в следующем примере кода.

  Круто

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

  Котлин

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

Версия NDK по умолчанию для каждой версии AGP

Перед выпуском каждая версия AGP тщательно тестируется с использованием последней стабильной версии NDK на момент выпуска. Эта версия NDK используется для сборки ваших проектов, если вы не указали версию NDK в файле build.gradle . Версии NDK по умолчанию для различных версий AGP описаны в примечаниях к выпуску AGP и примечаниях к предыдущим выпускам AGP .