Добавление поддержки OpenSSL для Android

Пакет установки Qt поставляется с поддержкой OpenSSL, но библиотеки OpenSSL не входят в пакет из-за юридических ограничений в некоторых странах. Если ваше приложение зависит от OpenSSL, рассмотрите возможность добавления библиотек SSL в пакет приложения (APK), так как целевое устройство может или не может их иметь.

Вы можете использовать статический метод QSslSocket::supportsSsl() для проверки поддержки SSL на целевом устройстве. Сначала включите заголовок:

#include <QSslSocket>

Затем используйте следующую строку для проверки поддержки SSL:

qDebug() << "Device supports OpenSSL: " << QSslSocket::supportsSsl();

Проверьте раздел Application Output в Qt Creator или раздел logcat в Android для результата.

Компиляция OpenSSL для Android

Для удобства можно использовать репозиторий Github с предварительно скомпилированными версиями и скриптом сборки, без необходимости ручного пошагового компиляции. Более подробную информацию см. в OpenSSL для Android. Если вы скачали репозиторий, можете перейти к Использованию библиотек OpenSSL с Qt для Android.

Следующие инструкции помогут вам скомпилировать библиотеки OpenSSL вручную:

1. Загрузите исходные коды OpenSSL 1.1.x с сайта OpenSSL.
2. Распакуйте исходные коды в папку и перейдите в эту папку через командную строку.

   Примечание: Если ваша платформа разработки — Windows, вам необходимо msys с perl версии 5.14 или более поздней для компиляции OpenSSL.

3. Добавьте Android LLVM инструмент (NDK r20b или r21) в ваш путь:

   export PATH="<android_ndk_path>/toolchains/llvm/prebuilt/<host>/bin":$PATH

4. Настройте исходные коды OpenSSL для компиляции под Android с помощью следующей команды:

   ./Configure shared android-<arch> -D__ANDROID_API__=21

   Где <arch> может принимать значение: arm, arm64, x86, x86_64.

   Примечание: Вы должны настроить включение или отключение функций SSL в соответствии с юридическими ограничениями в регионе, где доступно ваше приложение. Более подробную информацию о настраиваемых функциях см. в Параметрах конфигурации OpenSSL.

5. Для компиляции libcrypto и libssl общих библиотек, которые не имеют версии, но имеют суффикс _1_1, выполните команду:

   make -j$(nproc) SHLIB_VERSION_NUMBER= SHLIB_EXT=_1_1.so build_libs

   Без суффикса Android 5 (API 21) загрузит системные библиотеки libcrypto.so и libssl.so, которые являются OpenSSL 1.0, а не ваши библиотеки.

   Если вы хотите использовать другой суффикс, вы должны изменить SHLIB_EXT в предыдущей команде и установить переменную среды ANDROID_OPENSSL_SUFFIX перед доступом к API сети Qt.

   make -j$(nproc) SHLIB_VERSION_NUMBER= SHLIB_EXT=<custom_suffix>.so build_libs

   Затем установите переменную среды в файле main.ccp:

   qputenv("ANDROID_OPENSSL_SUFFIX", "<custom_suffix>");

   Примечание: Android не загружает библиотеки с версиями.

Использование библиотек OpenSSL с Qt для Android

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

• Использование файлов проекта:

  Используя удобный репозиторий OpenSSL для Android, вы можете напрямую добавить включённые проекты в свой собственный проект, добавив следующее в ваш файл .pro:

  android: include(<path/to/android_openssl/openssl.pri)

  Или, если используете CMake, добавьте следующее в свой файл CMakeLists.txt:

  if (ANDROID)
      include(<path/to/android_openssl/CMakeLists.txt)
  endif()

  В качестве альтернативы, вы можете использовать переменную Qt для Android ANDROID_EXTRA_LIBS для добавления дополнительных библиотек, в основном libcrypto и libssl. Для QMake используйте:

  ANDROID_EXTRA_LIBS += \
      <path_to_libs_dir>/libcrypto_1_1.so \
      <path_to_libs_dir>/libssl_1_1.so

  Для CMake:

  set(ANDROID_EXTRA_LIBS
      <path_to_libs_dir>/ibcrypto_1_1.so
      <path_to_libs_dir>/libssl_1_1.so
  CACHE INTERNAL "")

  Примечание: При работе с несколькими архитектурами включайте библиотеки OpenSSL для всех целевых архитектур.

• Используя Qt Creator, можно добавить дополнительные библиотеки. Дополнительную информацию см. в Qt Creator: Добавление библиотек в проекты.