在Ubuntu系统上为Android交叉编译OpenSSL

在Ubuntu系统上为Android交叉编译OpenSSL以OpenSSL 3.5.7为例需要配置好Android NDK环境并使用OpenSSL自带的配置脚本进行编译。选取OpenSSL版本可以在官网查看https://openssl-library.org/source/建议选择带有LTS标识的版本为长期支持版。在windows系统上配置Ubuntu系统虚拟机步骤详见上一篇文章本文不再赘述。以下是具体的步骤和示例脚本。1. 准备工作首先更新Ubuntu系统的软件包列表并安装必要的构建工具sudoaptupdatesudoaptinstall-ybuild-essentialwgettarunzipmakeclang2. 下载并配置 Android NDKOpenSSL的交叉编译需要用到Android NDK。建议使用稳定版本例如 NDK r25c 或 r26b。1. 下载 NDK以 r25c 为例cd~wgethttps://dl.google.com/android/repository/android-ndk-r25c-linux.zip2. 解压 NDKunzipandroid-ndk-r25c-linux.zip3. 设置环境变量你可以将其记录在临时变量中或者写入~/.bashrcexportANDROID_NDK_HOME$HOME/android-ndk-r25cexportANDROID_NDK_ROOT$ANDROID_NDK_HOMEexportPATH$ANDROID_NDK_HOME/toolchains/llvm/prebuilt/linux-x86_64/bin:$PATH永久写入环境变量具体操作步骤如下步骤 1使用 nano 打开~/.bashrc文件在终端中输入以下命令nano~/.bashrc步骤 2将环境变量添加到文件末尾使用键盘上的下方向键一直滑到文件的最底部然后在文件的最末尾粘贴以下内容# Android NDK environment variablesexportANDROID_NDK_HOME$HOME/android-ndk-r25cexportANDROID_NDK_ROOT$ANDROID_NDK_HOMEexportPATH$ANDROID_NDK_HOME/toolchains/llvm/prebuilt/linux-x86_64/bin:$PATH步骤 3保存并退出按Ctrl O保存。按Enter确认文件名。按Ctrl X退出nano编辑器。步骤 4使配置立即生效在当前终端运行以下命令使刚刚修改的配置立即生效不需要重启电脑或重新打开终端source~/.bashrc验证是否成功你可以运行以下命令来验证环境变量是否已正确配置echo$ANDROID_NDK_HOME如果终端正确输出了/home/你的用户名/android-ndk-r25c或者你的实际 NDK 路径说明配置已经永久生效。今后每次你打开新的终端窗口这些变量都会自动加载。3. 下载 OpenSSL 源码本文以 OpenSSL 3.5.7 (长期支持版本 LTS) 为例。cd~wgethttps://www.openssl.org/source/openssl-3.5.7.tar.gztar-zxvfopenssl-3.5.7.tar.gzcdopenssl-3.5.74. 编写编译脚本由于Android有不同的架构如arm64-v8a,armeabi-v7a,x86_64,x86编写一个自动化脚本可以方便地为这些架构生成预编译库。在openssl-3.5.7目录下创建一个名为build_android.sh的脚本nanobuild_android.sh将以下内容复制到脚本中#!/bin/bash# 1. 显式指定你的 NDK 路径请确保该路径与你实际解压的 NDK 路径一致exportANDROID_NDK_ROOT$HOME/android-ndk-r25cexportANDROID_NDK_HOME$ANDROID_NDK_ROOT# 检查 NDK 路径是否存在if[!-d$ANDROID_NDK_ROOT];thenechoError: NDK directory not found at$ANDROID_NDK_ROOTechoPlease check your NDK path in this script.exit1fi# 定义支持的架构和对应的OpenSSL配置名称ARCHS(arm64-v8aandroid-arm6421armeabi-v7aandroid-arm21x86_64android-x86_6421x86android-x8621)# 获取当前工作目录SRC_DIR$(pwd)# 定义输出目录OUTPUT_DIR${SRC_DIR}/android_build# 将 NDK 工具链加入 PATHexportPATH$ANDROID_NDK_ROOT/toolchains/llvm/prebuilt/linux-x86_64/bin:$PATH# 循环编译各个架构for((i0;i${#ARCHS[]};i3));doABI${ARCHS[i]}TARGET${ARCHS[i1]}API${ARCHS[i2]}echoechoBuilding OpenSSL for${ABI}(API${API})...echo# 清理之前的编译残留makeclean2/dev/null# 创建输出路径PREFIX${OUTPUT_DIR}/${ABI}mkdir-p${PREFIX}# 配置 OpenSSL./Configure${TARGET}\-D__ANDROID_API__${API}\--prefix${PREFIX}\--openssldir${PREFIX}/ssl\no-shared\no-tests# 编译并安装make-j$(nproc)makeinstall_swdoneechoBuild completed. Outputs are located in:${OUTPUT_DIR}5. 执行编译1. 给脚本赋予执行权限chmodx build_android.sh2. 运行脚本./build_android.sh6. 查看编译结果编译完成后预编译的文件会输出在openssl-3.5.7/android_build目录下。目录结构大致如下android_build/ ├── arm64-v8a │ ├── bin │ ├── include │ │ └── openssl │ └── lib │ ├── libcrypto.a │ └── libssl.a ├── armeabi-v7a │ ...include/openssl存放头文件在 Android 项目如 CMake中配置target_include_directories时会用到。lib存放生成的静态库libcrypto.a和libssl.a。如果在脚本配置中去掉了no-shared此处还会生成libcrypto.so和libssl.so。验证生成的文件你可以运行以下命令来查看生成的预编译库文件结构ls-l/home/openclaw/openssl-3.5.7/android_build你应该会看到生成了 4 个对应 Android 架构的文件夹。接着你可以检查具体某个架构下的库文件是否存在例如arm64-v8als-l/home/openclaw/openssl-3.5.7/android_build/arm64-v8a/lib/如果在这个lib文件夹下看到了libcrypto.a和libssl.a说明这些就是你所需要的 Android 预编译静态库。注意事项API Level: 脚本中设置的__ANDROID_API__为21。如果你的应用需要支持更旧的设备或者需要使用更新的系统特性可以根据实际需求调整该值例如24、26等。动态库与静态库:默认脚本中开启了no-shared这会生成静态库 (.a)。静态库便于打包不易产生动态链接冲突。如果需要动态库 (.so)请从脚本的./Configure命令中移除no-shared行。