mebedtls 地址:https://github.com/Mbed-TLS/mbedtls
准备工作:
- clone mebedtls 仓库到本地(tag: mbedtls-2.26.0)
- 鸿蒙工具链(SDK version: v5.0.5)
编译文件修改:
对 CMakeLists.txt 进行修改,主要是关闭了以下几个选项
- ENABLE_PROGRAMS
- MBEDTLS_FATAL_WARNINGS
- ENABLE_TESTING
ENABLE_PROGRAMS 和 ENABLE_TESTING 是添加程序和测试,因为我们只需要库,所以不需要这些,减少编译文件和时间
MBEDTLS_FATAL_WARNINGS 是将警告当成错误处理,这个也需要关闭,不然编译不了
option(ENABLE_PROGRAMS "Build mbed TLS programs." OFF)
option(MBEDTLS_FATAL_WARNINGS "Compiler warnings treated as errors" OFF)
option(ENABLE_TESTING "Build mbed TLS tests." OFF)
注:CMakeLists.txt 位于根目录下,不需要改其他子文件夹里的 CMakeLists.txt
添加编译脚本(build.sh)
- 指定鸿蒙工具链的路径
- 添加 CMAKE 命令行
- 指定库的输出目录
#!/bin/bash
set -e
NDK_PATH=D:/Emuator/v5.0.5/sdk/12/native
CMAKE=$NDK_PATH/build-tools/cmake/bin/cmake
STRIP=$NDK_PATH/llvm/bin/llvm-strip
arch=arm64-v8a
rm -rf build
$CMAKE -B build -G Ninja \
-DOHOS_PLATFORM=OHOS -DOHOS_ARCH=$arch \
-DCMAKE_TOOLCHAIN_FILE=$NDK_PATH/build/cmake/ohos.toolchain.cmake
cd build
ninja
# 创建输出目录
mkdir -p ../libs/$arch
# 处理所有三个静态库
for lib in crypto x509 tls; do
cp ./library/libmbed${lib}.a ../libs/$arch/
done
cd ..
编译过程:
打开 bash,避免使用 powershell,因为 bash 可以看到编译的过程
$ ./build.sh
输出:
编译生成的静态库是在根目录下的 libs 文件夹里
使用:
在其他项目中引用 mbedtls 时,需要同时指定这三个静态库,否则会出现一些函数的符号文件找不到
可以参考下面的写法:
set(BUILD_ARCH "arm64-v8a")
include_directories(
${SRC_PATH_ROOT}/mbedtls/include
)
target_link_libraries(project PUBLIC
libace_napi.z.so
${SRC_PATH_ROOT}/mbedtls/lib/ohos/${BUILD_ARCH}/libmbedcrypto.a
${SRC_PATH_ROOT}/mbedtls/lib/ohos/${BUILD_ARCH}/libmbedx509.a
${SRC_PATH_ROOT}/mbedtls/lib/ohos/${BUILD_ARCH}/libmbedtls.a
)
小结:编译这种库之前看一遍 README,了解下可以使用哪些工具来编译,以及中间可能出现的编译错误,这样能减少时间来完成这件事。