Добавьте код C и C++ в свой проект

Добавьте код C и C++ в свой проект Android, поместив его в каталог cpp в модуле проекта. При сборке проекта этот код компилируется в нативную библиотеку, которую Gradle может упаковать вместе с вашим приложением. Ваш код Java или Kotlin затем сможет вызывать функции в вашей нативной библиотеке через интерфейс Java Native Interface (JNI). Чтобы узнать больше об использовании фреймворка JNI, ознакомьтесь с советами по JNI для Android .

Android Studio поддерживает CMake, что полезно для кроссплатформенных проектов. Android Studio также поддерживает ndk-build , который может быть быстрее CMake, но поддерживает только Android. Использование CMake и ndk-build в одном модуле в настоящее время не поддерживается.

Чтобы импортировать существующую библиотеку ndk-build в ваш проект Android Studio, узнайте, как связать Gradle с вашим проектом собственной библиотеки .

На этой странице показано, как настроить Android Studio с необходимыми инструментами сборки, создать новый проект с поддержкой C/C++ и добавить новые файлы C/C++ в ваш проект.

Если вместо этого вы хотите добавить собственный код в существующий проект, выполните следующие действия:

  1. Создайте новые исходные файлы и добавьте их в свой проект Android Studio.
    • Пропустите этот шаг, если у вас уже есть собственный код или вы хотите импортировать готовую собственную библиотеку.
  2. Настройте CMake для сборки вашего нативного исходного кода в библиотеку. Этот скрипт сборки необходим при импорте и компоновке готовых или платформенных библиотек.
    • Если у вас уже есть собственная библиотека, которая имеет скрипт сборки CMakeLists.txt или использует ndk-build и включает скрипт сборки Android.mk , пропустите этот шаг.
  3. Настройте Gradle , указав путь к файлу скрипта CMake или ndk-build . Gradle использует скрипт сборки для импорта исходного кода в ваш проект Android Studio и упаковки вашей нативной библиотеки в приложение.

После настройки проекта получите доступ к собственным функциям из кода Java или Kotlin, используя фреймворк JNI . Чтобы собрать и запустить приложение, нажмите «Запустить». запустить, а затем запустить приложение из строки меню .

Примечание: если ваш существующий проект использует устаревший инструмент ndkCompile , перейдите на использование CMake или ndk-build .

Загрузите NDK и инструменты сборки

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

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

Информацию об установке этих компонентов см. в разделе Установка и настройка NDK и CMake .

Создать новый проект с поддержкой C/C++

Процесс создания нового проекта с поддержкой нативного кода аналогичен созданию любого другого проекта Android Studio , но с дополнительным шагом:

  1. В разделе мастера «Выберите проект» выберите тип проекта Native C++ .
  2. Нажмите «Далее» .
  3. Заполните все остальные поля в следующем разделе мастера.
  4. Нажмите «Далее» .
  5. В разделе мастера «Настройка поддержки C++» вы можете настроить свой проект с помощью поля «Стандарт C++» .
    • В раскрывающемся списке выберите нужную стандартизацию C++. При выборе Toolchain Default будут использоваться настройки CMake по умолчанию.
  6. Нажмите кнопку Готово .

После того, как Android Studio завершит создание нового проекта, откройте панель «Проект» в левой части IDE и выберите в меню пункт «Вид Android» . Как показано на рисунке 1, Android Studio добавит группу cpp :

Рисунок 1. Группы представлений Android для ваших собственных источников и внешних скриптов сборки.

Примечание: это представление не отражает фактическую иерархию файлов на диске, а группирует похожие файлы для упрощения навигации по проекту.

Группа cpp — это место, где вы найдете все исходные файлы нативного кода, заголовочные файлы, скрипты сборки для CMake или ndk-build , а также готовые библиотеки, входящие в ваш проект. Для новых проектов Android Studio создает пример исходного файла на C++ native-lib.cpp и помещает его в каталог src/main/cpp/ вашего модуля app. Этот пример кода предоставляет простую функцию на C++ stringFromJNI() , которая возвращает строку "Hello from C++" . Узнайте, как добавить дополнительные исходные файлы в свой проект, в разделе о создании новых исходных файлов нативного кода .

Подобно тому, как файлы build.gradle указывают Gradle, как собирать ваше приложение, CMake и ndk-build требуют скрипт сборки, чтобы знать, как собирать вашу нативную библиотеку. Для новых проектов Android Studio создаёт скрипт сборки CMake, CMakeLists.txt , и помещает его в корневой каталог вашего модуля. Подробнее о содержимом этого скрипта сборки см. в разделе «Настройка CMake» .

Создайте и запустите пример приложения

Когда вы нажимаете «Выполнить» запустить, а затем запустить приложение из строки меню Android Studio собирает и запускает приложение, отображающее текст «Hello from C++» на вашем Android-устройстве или эмуляторе. Ниже описаны события, происходящие при сборке и запуске примера приложения:

  1. Gradle вызывает ваш внешний скрипт сборки, CMakeLists.txt .
  2. CMake следует командам в скрипте сборки, чтобы скомпилировать исходный файл C++, native-lib.cpp , в общую объектную библиотеку и назвать её libnative-lib.so . Затем Gradle упаковывает её в приложение.
  3. Во время выполнения MainActivity приложения загружает нативную библиотеку с помощью System.loadLibrary() . Теперь нативная функция библиотеки, stringFromJNI() , доступна приложению.
  4. MainActivity.onCreate() вызывает stringFromJNI() , который возвращает "Hello from C++" и использует его для обновления TextView .

Чтобы убедиться, что Gradle упаковывает нативную библиотеку в приложение, используйте APK Analyzer :

  1. Выберите Сборка > Сборка пакетов/APK > Сборка APK .
  2. Выберите Сборка > Анализ APK .
  3. Выберите APK или AAB из каталога app/build/outputs/ и нажмите OK .
  4. Как показано на рисунке 2, вы можете увидеть libnative-lib.so в окне APK Analyzer в lib/<ABI>/ .

    Рисунок 2. Найдите нативную библиотеку с помощью APK Analyzer.

Совет: если вы хотите поэкспериментировать с другими приложениями Android, использующими собственный код, нажмите Файл > Создать > Импортировать образец и выберите пример проекта из списка Ndk .

Создать новые исходные файлы C/C++

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

  1. Если в основном исходном наборе вашего приложения еще нет каталога cpp/ , создайте его следующим образом:
    1. Откройте панель «Проект» в левой части IDE и выберите в меню пункт «Представление проекта» .
    2. Перейдите в your-module > src .
    3. Щелкните правой кнопкой мыши по основному каталогу и выберите Создать > Каталог .
    4. Введите cpp в качестве имени каталога и нажмите OK .

  2. Щелкните правой кнопкой мыши по каталогу cpp/ и выберите Создать > Исходный файл C/C++ .

  3. Введите имя исходного файла, например, native-lib .

  4. В меню «Тип» выберите расширение исходного файла, например .cpp .
    • Нажмите «Изменить типы файлов». Чтобы добавить в меню другие типы файлов, например .cxx или .hxx , выберите другое расширение файла в меню «Расширение исходного файла » и «Расширение заголовка» и нажмите кнопку «ОК» .

  5. Чтобы создать файл заголовка, установите флажок Создать связанный заголовок .

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

После добавления новых файлов C/C++ в ваш проект вам все равно необходимо настроить CMake для включения файлов в вашу собственную библиотеку.

Дополнительные ресурсы

Чтобы узнать больше о поддержке кода C/C++ в вашем приложении, попробуйте следующий ресурс.

Codelabs