Incorporación de compatibilidad con OpenSSL para Android
El paquete de instalación de Qt incluye compatibilidad con OpenSSL, pero las bibliotecas de OpenSSL no forman parte del paquete debido a restricciones legales en algunos países. Si tu aplicación depende de OpenSSL, considera la posibilidad de incluir las bibliotecas SSL en el paquete de tu aplicación (APK o AAB), ya que el dispositivo de destino puede tenerlas o no.
Puede utilizar la función estática QSslSocket::supportsSsl() para comprobar si el dispositivo de destino es compatible con SSL. En primer lugar, incluya el encabezado:
#include <QSslSocket>A continuación, utiliza la siguiente línea para comprobar si se admite SSL:
qDebug() << "Device supports OpenSSL: " << QSslSocket::supportsSsl();Consulta la sección Application Output de Qt Creator o la documentación de Android logcat para obtener información sobre ese mensaje de registro.
Incorporación de las bibliotecas de OpenSSL
Utilizando el práctico repositorio «OpenSSL for Android», puedes incluir directamente las bibliotecas de OpenSSL en tu propio proyecto.
Con CMake, añade lo siguiente a tu ` CMakeLists.txt`:
if (ANDROID)
include(FetchContent)
FetchContent_Declare(
android_openssl
DOWNLOAD_EXTRACT_TIMESTAMP true
URL https://github.com/KDAB/android_openssl/archive/refs/heads/master.zip
)
FetchContent_MakeAvailable(android_openssl)
include(${android_openssl_SOURCE_DIR}/android_openssl.cmake)
endif()O, si has clonado el repositorio en un subdirectorio:
include(<path/to/android_openssl>/android_openssl.cmake)A continuación, añade las bibliotecas a tus objetivos:
qt_add_executable(your_target_name ..)
qt_add_executable(your_second_target_name ..)
if (ANDROID)
add_android_openssl_libraries(your_target_name your_second_target_name)
endif()Para qmake, añade lo siguiente a tu archivo .pro:
android: include(<path/to/android_openssl/openssl.pri)Como alternativa, para añadir bibliotecas adicionales, como libcrypto y libssl. Para CMake, utiliza:
set_target_properties(<target_name> PROPERTIES
QT_ANDROID_EXTRA_LIBS "<path_to_libs_dir>/libcrypto_3.so" "<path_to_libs_dir>/libssl_3.so"
)O, para qmake, utiliza:
ANDROID_EXTRA_LIBS += \
<path_to_libs_dir>/libcrypto_3.so \
<path_to_libs_dir>/libssl_3.soNota: Cuando se compila para varias arquitecturas, incluye las bibliotecas de OpenSSL para todas las arquitecturas de destino.
Con Qt Creator es posible añadir bibliotecas adicionales. Para obtener más información, consulta Qt Creator: Añadir bibliotecas a proyectos CMake y Qt Creator: Añadir bibliotecas a proyectos qmake.
Compilación de OpenSSL para Android
Las siguientes instrucciones te guían para compilar manualmente las bibliotecas de OpenSSL:
- Descarga los fuentes de OpenSSL.
- Descomprime los fuentes en una carpeta y accede a ella mediante la CLI.
Nota: Si su plataforma de desarrollo es Windows, necesitará
msysconperl5.14 o posterior para compilar OpenSSL. - Añade la cadena de herramientas LLVM de Android a tu ruta de acceso; por ejemplo, en Linux utiliza:
export PATH=~/Android/Sdk/ndk/27.2.12479018/toolchains/llvm/prebuilt/<host>/bin:$PATHEl SDK de Android suele instalarse mediante Qt Creator o Android Studio en las siguientes ubicaciones:
- Linux:
~/Android/Sdk/ - macOS:
~/Library/Android/sdk/ - Windows:
C:\Users\<USER>\AppData\Local\Android\Sdk\
- Linux:
- Configura las fuentes de OpenSSL para compilar para Android utilizando el siguiente comando, donde <arch> puede tomar uno de los siguientes valores:
arm,arm64,x86ox86_64:./Configure shared android-<arch> -D__ANDROID_API__=28Nota: Debe tener en cuenta la activación o desactivación de las funciones SSL en función de las restricciones legales de la región en la que esté disponible su aplicación. Para obtener más información sobre las funciones configurables, consulte Opciones de configuración de OpenSSL.
- Sin sufijo, Android carga las bibliotecas del sistema
libcrypto.soylibssl.so. Estas pueden ser versiones diferentes a las de sus bibliotecas o a las que espera Qt. Para garantizar que las aplicaciones Qt puedan cargar las bibliotecas OpenSSL compiladas manualmente, ejecute los siguientes comandos:make -j$(nproc) SHLIB_VERSION_NUMBER= build_libs mkdir -p ${out_path} cp libcrypto.so ${out_path}/libcrypto_3.so cp libssl.so ${out_path}/libssl_3.so cd ${out_path} patchelf --set-soname libcrypto_3.so libcrypto_3.so patchelf --set-soname libssl_3.so libssl_3.so patchelf --replace-needed libcrypto.so libcrypto_3.so libssl_3.soNota: Aunque las bibliotecas compartidas
libcryptoylibsslno tienen versión, llevarán el sufijo _3.A continuación, configura la variable de entorno en tu archivo main.cpp:
qputenv("ANDROID_OPENSSL_SUFFIX", "<custom_suffix>");Nota: Android no carga bibliotecas con versión.
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.