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

Пакет установки Qt поставляется с поддержкой OpenSSL, но библиотеки OpenSSL не входят в пакет из-за юридических ограничений в некоторых странах. Если ваше приложение зависит от OpenSSL, рассмотрите возможность упаковки библиотек SSL вместе с вашим приложением Package (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 v5.14 или более поздней версией для сборки OpenSSL.

3. Добавьте Android LLVM инструментную цепочку (NDK r20b или r21) в вашу переменную среды:
4. Настройте исходные коды OpenSSL для сборки для Android с помощью следующей команды:

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

   Где <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 Network.

   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: Добавление библиотек в проекты.