Начало работы с Qt для Android

Установка необходимых компонентов

Для использования Qt для Android требуется следующее:

• Набор инструментов Java Development Kit (JDK), предоставляемый AdoptOpenJDK для всех платформ. Он необходим для сборки приложений Android. Также поддерживаются другие альтернативы, такие как OpenJDK для Linux или Java SE Development Kit для Windows.

  Примечание: При использовании Qt для Android необходимо использовать JDK 11 или более раннюю версию.

• Gradle для сборки пакетов приложений (APK) и наборов приложений (AAB) для устройств Android. Gradle поставляется с Qt 5.9 и более поздними версиями.

  Примечание: Использование Ant для сборки APK больше не поддерживается.

• Инструменты командной строки Android SDK для установки следующих пакетов, необходимых для компиляции приложений Qt для Android:
  • Инструменты платформы
  • Инструменты сборки
  • Хотя бы одна платформа SDK
  • NDK Android, который содержит компиляторы и отладчики для Android.

  Примечание: Qt Creator 4.12 или более поздней версии может автоматически настроить инструменты SDK, NDK и необходимые пакеты. Дополнительную информацию см. в разделе Qt Creator: Указание настроек устройства Android.

  Примечание: Если вы используете инструменты SDK 26.x или ниже, требуется JDK 8. Версии, превышающие 8, могут вызвать проблемы для инструментов Android SDK.

  Примечание: Если ваша версия Qt старше версии v5.9, используйте пакет инструментов SDK v25.2.5 или более ранней версии.

• NDK Android можно установить с помощью инструмента sdkmanager. Кроме того, его можно загрузить и извлечь вручную в выбранный каталог.

Разные версии Qt зависят от разных версий NDK, как указано ниже:

Примечание: В Qt 5.14.0 и 5.14.1 с NDK r21 была исправлена ошибка в QTBUG-81461.

Примечание: Убедитесь, что вы распаковали Android SDK и NDK в доступном для записи каталоге, к которому Qt Creator сможет получить доступ позже. В противном случае Qt Creator не сможет использовать sdkmanager или найти все компоненты, даже если они были установлены вручную.

Установка необходимых компонентов Android SDK

После загрузки и распаковки инструментов командной строки SDK используйте инструмент командной строки sdkmanager для установки необходимых пакетов:

cd <ANDROID_SDK_ROOT>/tools/bin/
./sdkmanager --sdk_root=<ANDROID_SDK_ROOT> --install "cmdline-tools;latest"
./sdkmanager --sdk_root=<ANDROID_SDK_ROOT> --install "platform-tools" "platforms;android-29" "build-tools;29.0.2" "ndk;21.3.6528147"

Android Studio или пользовательский интерфейс диспетчера пакетов SDK в Qt Creator (SDK Manager UI) также можно использовать для установки необходимых пакетов SDK.

Для использования эмулятора Android установите его, выполнив следующую команду:

./sdkmanager --sdk_root=<ANDROID_SDK_ROOT> --install "emulator" "patcher;v4"

Конфигурация, зависящая от платформы

Windows

По умолчанию драйвер USB в Windows не позволяет отлаживать с помощью инструмента Android Debug Bridge (ADB). Необходимо установить дополнительный драйвер USB, предоставляемый пакетом Android SDK extras. Для его установки выполните следующие действия:

sdkmanager.bat --sdk_root=<ANDROID_SDK_ROOT> --install "extras;google;usb_driver"

После завершения установки пакета установите драйвер из <ANDROID_SDK_ROOT>/extras/google/usb_driver. Попробуйте выполнить несколько основных команд adb и проверьте, отвечает ли ваше устройство Android на них.

Linux

Для использования инструментов, таких как adb или gdb, которые могут использоваться в Qt Creator, необходимы следующие зависимости:

sudo apt-get install libstdc++6 libncurses5

Для запуска эмулятора Android также необходимы следующие зависимости:

sudo apt-get install libsdl1.2debian

IDE Qt Creator

IDE Qt Creator можно использовать для разработки приложений Qt для Android. Дополнительную информацию см. в разделе Qt Creator: Подключение устройств Android.

Тестирование вашей конфигурации

Теперь вы можете протестировать свою конфигурацию разработки, запустив примеры, поставляемые с установкой Qt. Дополнительную информацию см. в разделе Примеры Qt для Android.

Чтобы разработать простое приложение с нуля, см. Qt Creator: Создание мобильного приложения.