4603627f创建于 2023年10月19日历史提交

boringssl集成到应用hap

本库是在RK3568开发板上基于OpenHarmony3.2 Release版本的镜像验证的，如果是从未使用过RK3568，可以先查看润和RK3568开发板标准系统快速上手。

开发环境

开发环境准备

编译三方库

下载本仓库

git clone https://gitee.com/openharmony-sig/tpc_c_cplusplus.git --depth=1

三方库目录结构

tpc_c_cplusplus/thirdparty/boringssl   #三方库boringssl的目录结构如下
├── docs                               #三方库相关文档的文件夹
├── HPKBUILD                           #构建脚本
├── HPKCHECK                           #自动化测试脚本
├── SHA512SUM                          #三方库校验文件
├── README.OpenSource                  #说明三方库源码的下载地址，版本，license等信息
├── README_zh.md                       #三方库说明文档
├── OAT.xml                            #开源扫描相关文件

在tpc_c_cplusplus/lycium目录下编译三方库

编译环境的搭建参考准备三方库构建环境
```
cd tpc_c_cplusplus/lycium
./build.sh boringssl
```
三方库头文件及生成的库

在lycium目录下会生成usr目录，该目录下存在已编译完成的32位和64位三方库和头文件
```
boringssl/arm64-v8a   boringssl/armeabi-v7a
```
测试三方库

应用中使用三方库

拷贝动态库到\\entry\libs\${OHOS_ARCH}\目录：动态库需要在\\entry\libs\${OHOS_ARCH}\目录，才能集成到hap包中，所以需要将对应的so文件拷贝到对应CPU架构的目录
在IDE的cpp目录下新增thirdparty目录，将编译生成的库拷贝到该目录下，如下图所示

在最外层（cpp目录下）CMakeLists.txt中添加如下语句

#将三方库加入工程中
target_link_libraries(entry PRIVATE
    ${CMAKE_CURRENT_SOURCE_DIR}/../../../libs/${OHOS_ARCH}/libssl.a
    ${CMAKE_CURRENT_SOURCE_DIR}/../../../libs/${OHOS_ARCH}/libcrypto.a
    )
#将三方库的头文件加入工程中
target_include_directories(entry PRIVATE ${CMAKE_CURRENT_SOURCE_DIR}/thirdparty/include/boringssl/${OHOS_ARCH})

测试三方库

三方库的测试使用原库自带的测试用例来做测试，准备三方库测试环境

进入到构建目录（arm64-v8a-build为构建64位的目录，armeabi-v7a-build为构建32位的目录）,执行如下操作步骤:

配置环境变量执行如下命令：
```
export LD_LIBRARY_PATH=${LYCIUM_ROOT}/usr/boringssl/${ARCH}/lib:$LD_LIBRARY_PATH
```
注意：LYCIUM_ROOT代表lycium所在目录的绝对路径；ARCH代表构建架构，64位为arm64-v8a，32位为armeabi-v7a。
执行测试项：
```
./ssl/ssl_test --gtest_filter=*-SSLTest.HostMatching
```
注意：ssl_test有一个用例SSLTest.HostMatching由于域名不匹配测试不通过，测试结果与X86平台相同，用--gtest_filter=*-SSLTest.HostMatching过滤掉这个用例
```
./crypto/crypto_test
```
```
./crypto/urandom_test
```
```
./decrepit/decrepit_test
```

boringssl集成到应用hap

开发环境

编译三方库

应用中使用三方库

测试三方库

参考资料