【亲测免费】 Android OpenSSL支持指南

项目基础介绍

项目名称：KDAB的Android OpenSSL

• 主要编程语言: 该仓库主要是脚本语言（如Shell脚本和CMakeLists.txt），以及用于编译的配置文件，不直接涉及特定编程语言，但它服务于C++项目（特别是Qt应用程序）。
• 项目描述: 此开源项目提供了OpenSSL库的预编译版本，专为Android平台设计，特别是针对Qt应用。包含了用于不同Qt版本的SSL库，并且提供了QMake和CMake的集成方法，简化了Qt Android应用中使用OpenSSL的流程。

新手使用特别注意事项与解决步骤

注意事项1：正确选择OpenSSL版本兼容性

• 问题: 用户可能会遇到版本不匹配的问题，尤其是在尝试将其集成到特定版本的Qt应用时。
• 解决步骤:
  1. 根据你的Qt项目版本，选择正确的子目录（如ssl_3用于Qt 6.5及以上，ssl_1_1用于Qt 5.12.5及更高版本）。
  2. 在项目配置文件中指定正确的openssl.pri或通过CMake加入对应的路径，确保所选的OpenSSL版本与Qt兼容。

注意事项2：环境配置

• 问题: 缺乏正确的NDK版本或环境变量设置可能导致编译失败。
• 解决步骤:
  1. 确保你的开发环境中已安装适合的Android NDK版本，并将其路径添加到系统环境变量中。
  2. 使用build_ssl.sh脚本重建库之前，检查脚本中的NDK路径是否对应于你的环境设置。
  3. 对于Linux或macOS，确保有patchelf命令可用，特别是在构建OpenSSL 3+时。

注意事项3：集成方式错误

• 问题: 错误地将OpenSSL集成到QMake或CMake项目中。
• 解决步骤:
  • QMake项目: 在.pro文件中加入include(path_to_android_openssl/openssl.pri)。
  • CMake项目:
    1. 如果是从远程克隆，通过FetchContent添加依赖：在CMakeLists.txt中使用指定的URL和FetchContent指令。
    2. 确保在你的目标(qt_add_executable)下方，仅在Android条件下调用add_android_openssl_libraries函数。

通过遵循上述步骤，新手可以避免常见的陷阱，顺利地在Android上的Qt项目中集成和使用OpenSSL库。