diff --git a/thirdparty/libtommath/HPKBUILD b/thirdparty/libtommath/HPKBUILD new file mode 100644 index 0000000000000000000000000000000000000000..a0d37c6a5eb4b7012728fdce221e5d173526ad55 --- /dev/null +++ b/thirdparty/libtommath/HPKBUILD @@ -0,0 +1,72 @@ +# Contributor: wupingyuan +# Maintainer: wupingyuan +pkgname=libtommath +pkgver=1.2.0 +pkgrel=0 +pkgdesc="This is the git repository for LibTomMath, a free open source portable number theoretic multiple-precision integer (MPI) library written entirely in C." +url="https://github.com/libtom/libtommath" +archs=("armeabi-v7a" "arm64-v8a") +license=("public domain") +depends=() +makedepends=() +install= +source="https://github.com/libtom/$pkgname/archive/refs/tags/v$pkgver.tar.gz" + +autounpack=true +downloadpackage=true +buildtools="make" +builddir=$pkgname-$pkgver +packagename=$builddir.tar.gz +cc= +ar= +ranlib= + +prepare() { + cp -rf $builddir $builddir-$ARCH-build + cd $builddir-$ARCH-build + ar=${OHOS_SDK}/native/llvm/bin/llvm-ar + ranlib=${OHOS_SDK}/native/llvm/bin/llvm-ranlib + if [ $ARCH == ${archs[0]} ] + then + cc=${OHOS_SDK}/native/llvm/bin/arm-linux-ohos-clang + fi + if [ $ARCH == ${archs[1]} ] + then + cc=${OHOS_SDK}/native/llvm/bin/aarch64-linux-ohos-clang + fi + cd $OLDPWD +} + +build() { + cd $builddir-$ARCH-build + make CC=${cc} AR=${ar} RANLIB=${ranlib} -j4 > `pwd`/build.log 2>&1 + ret=$? + cd $OLDPWD + return $ret +} + +package() { + cd $builddir-$ARCH-build + make install PREFIX=$LYCIUM_ROOT/usr/$pkgname-$ARCH-install >> `pwd`/build.log 2>&1 + ret=$? + cd $OLDPWD + return $ret +} + +check() { + # 生成测试可执行文件 + cd $builddir-$ARCH-build + make CC=${cc} test_standalone >> `pwd`/build.log 2>&1 + ret=$? + unset cc ar ranlib + cd $OLDPWD + echo "The test must be on an OpenHarmony device!" + # 在OpenHarmony开发板中执行用例 + # ./test + return $ret +} + +# 清理环境 +cleanbuild(){ + rm -rf ${PWD}/$builddir $builddir-armeabi-v7a-build $builddir-arm64-v8a-build #${PWD}/$packagename +} \ No newline at end of file diff --git a/thirdparty/libtommath/README.OpenSource b/thirdparty/libtommath/README.OpenSource new file mode 100644 index 0000000000000000000000000000000000000000..7ec1ec22c80f6bf7c5cd989c51bce352b19e23ba --- /dev/null +++ b/thirdparty/libtommath/README.OpenSource @@ -0,0 +1,11 @@ +[ + { + "Name": "libtommath", + "License": "public domain", + "License File": "LICENSE", + "Version Number": "1.2.0", + "Owner": "wupingyuan@huawei.com", + "Upstream URL": "https://github.com/libtom/libtommath/archive/refs/tags/v1.2.0.tar.gz", + "Description": "This is the git repository for LibTomMath, a free open source portable number theoretic multiple-precision integer (MPI) library written entirely in C." + } +] diff --git a/thirdparty/libtommath/README_zh.md b/thirdparty/libtommath/README_zh.md new file mode 100644 index 0000000000000000000000000000000000000000..8328689f8d2f8cb93bac6f81a3172d4298f69465 --- /dev/null +++ b/thirdparty/libtommath/README_zh.md @@ -0,0 +1,12 @@ +# libtommath三方库说明 +## 功能简介 +libtommath是一个完全用C语言编写的免费开源可移植数字理论多精度整数(MPI)库。 +## 使用约束 +- IDE版本:DevEco Studio 3.1 Release +- SDK版本:ohos_sdk_public 3.2.11.9 (API Version 9 Release) +- 三方库版本:1.2.0 +- 当前适配的功能:数字理论多精度整数 +- [BSD](https://github.com/libtom/libtommath) + +## 集成方式 ++ [应用hap包集成](docs/hap_integrate.md) diff --git a/thirdparty/libtommath/SHA512SUM b/thirdparty/libtommath/SHA512SUM new file mode 100644 index 0000000000000000000000000000000000000000..72271855fd05cd3ed8317d3dad618a416f38796c --- /dev/null +++ b/thirdparty/libtommath/SHA512SUM @@ -0,0 +1 @@ +500bce4467d6cdb0b014e6c66d3b994a8d63b51475db6c3cd77c15c8368fbab4e3b5c458fcd5b35838b74c457a33c15b42d2356964f5ef2a0bd31fd544735c9a libtommath-1.2.0.tar.gz diff --git a/thirdparty/libtommath/docs/hap_integrate.md b/thirdparty/libtommath/docs/hap_integrate.md new file mode 100644 index 0000000000000000000000000000000000000000..a7ee9ee138ab3ea1dc672c7a5c7db85d9ee8ad6d --- /dev/null +++ b/thirdparty/libtommath/docs/hap_integrate.md @@ -0,0 +1,67 @@ +# libtommath集成到应用hap +本库是在RK3568开发板上基于OpenHarmony3.2 Release版本的镜像验证的,如果是从未使用过RK3568,可以先查看[润和RK3568开发板标准系统快速上手](https://gitee.com/openharmony-sig/knowledge_demo_temp/tree/master/docs/rk3568_helloworld)。 +## 开发环境 +- ubuntu20.04 +- [OpenHarmony3.2Release镜像](https://gitee.com/link?target=https%3A%2F%2Frepo.huaweicloud.com%2Fopenharmony%2Fos%2F3.2-Release%2Fdayu200_standard_arm32.tar.gz) +- [ohos_sdk_public 3.2.11.9 (API Version 9 Release)](https://gitee.com/link?target=https%3A%2F%2Frepo.huaweicloud.com%2Fopenharmony%2Fos%2F3.2-Release%2Fohos-sdk-windows_linux-public.tar.gz) +- [DevEco Studio 3.1 Beta2](https://gitee.com/link?target=https%3A%2F%2Fcontentcenter-vali-drcn.dbankcdn.cn%2Fpvt_2%2FDeveloperAlliance_package_901_9%2Ff3%2Fv3%2FuJyuq3syQ2ak4hE1QZmAug%2Fdevecostudio-windows-3.1.0.400.zip%3FHW-CC-KV%3DV1%26HW-CC-Date%3D20230408T013335Z%26HW-CC-Expire%3D315360000%26HW-CC-Sign%3D96262721EDC9B34E6F62E66884AB7AE2A94C2A7B8C28D6F7FC891F46EB211A70) +- [准备三方库构建环境](../../../tools/README.md#编译环境准备) +- [准备三方库测试环境](../../../tools/README.md#ci环境准备) +## 编译三方库 +- 下载本仓库 + ``` + git clone https://gitee.com/openharmony-sig/tpc_c_cplusplus.git --depth=1 + ``` +- 三方库目录结构 + ``` + tpc_c_cplusplus/thirdparty/libtommath #三方库libtommath的目录结构如下 + ├── docs #三方库相关文档的文件夹 + ├── HPKBUILD #构建脚本 + ├── SHA512SUM #三方库校验文件 + ├── README.OpenSource #说明三方库源码的下载地址,版本,license等信息 + ├── README_zh.md + ``` + +- 将libtommath拷贝至tools/main目录下 + ``` + cd tpc_c_cplusplus + cp thirdparty/libtommath tools/main -rf + ``` +- 在tools目录下编译三方库 + 编译环境的搭建参考[准备三方库构建环境](../../../tools/README.md#编译环境准备) + ``` + cd tools + ./build.sh libtommath + ``` +- 三方库头文件及生成的库 + 在tools目录下会生成usr目录,该目录下存在已编译完成的32位和64位三方库 + ``` + libtommath-arm64-v8a-install libtommath-armeabi-v7a-install + ``` + +- [测试三方库](#测试三方库) + +## 应用中使用三方库 + +- 在IDE的cpp目录下新增thirdparty目录,将编译生成的库拷贝到该目录下,如下图所示 + ![thirdparty_install_dir](pic/libtommath_install_dir.jpg) +- 在最外层(cpp目录下)CMakeLists.txt中添加如下语句 + ``` + #将三方库加入工程中 + target_link_libraries(entry PRIVATE ${CMAKE_CURRENT_SOURCE_DIR}/thirdparty/libtommath-${OHOS_ARCH}-install/lib/libtommath.a) + #将三方库的头文件加入工程中 + target_include_directories(entry PRIVATE ${CMAKE_CURRENT_SOURCE_DIR}/thirdparty/libtommath-${OHOS_ARCH}-install/include) + ``` + ![libtommath_usage](pic/libtommath_usage.jpg) +## 测试三方库 +三方库的测试使用原库自带的测试用例来做测试,[准备三方库测试环境](../../../tools/README.md#ci环境准备) + +进入到构建目录执行./test运行测试用例(arm64-v8a-build为构建64位的目录,armeabi-v7a-build为构建32位的目录) + + ![libtommath_test](pic/libtommath_test.jpg) + +## 参考资料 +- [润和RK3568开发板标准系统快速上手](https://gitee.com/openharmony-sig/knowledge_demo_temp/tree/master/docs/rk3568_helloworld) +- [OpenHarmony三方库地址](https://gitee.com/openharmony-tpc) +- [OpenHarmony知识体系](https://gitee.com/openharmony-sig/knowledge) +- [通过DevEco Studio开发一个NAPI工程](https://gitee.com/openharmony-sig/knowledge_demo_temp/blob/master/docs/napi_study/docs/hello_napi.md) diff --git a/thirdparty/libtommath/docs/pic/libtommath_install_dir.jpg b/thirdparty/libtommath/docs/pic/libtommath_install_dir.jpg new file mode 100644 index 0000000000000000000000000000000000000000..fc0946664af4322b40a3df55e32bd14a1cea1b62 Binary files /dev/null and b/thirdparty/libtommath/docs/pic/libtommath_install_dir.jpg differ diff --git a/thirdparty/libtommath/docs/pic/libtommath_test.jpg b/thirdparty/libtommath/docs/pic/libtommath_test.jpg new file mode 100644 index 0000000000000000000000000000000000000000..4c831d511c2edaac6628d492b538012b688b1ffe Binary files /dev/null and b/thirdparty/libtommath/docs/pic/libtommath_test.jpg differ diff --git a/thirdparty/libtommath/docs/pic/libtommath_usage.jpg b/thirdparty/libtommath/docs/pic/libtommath_usage.jpg new file mode 100644 index 0000000000000000000000000000000000000000..c3fabb0b8e20bc0db77ce3fb22ecfa5df1c24d0d Binary files /dev/null and b/thirdparty/libtommath/docs/pic/libtommath_usage.jpg differ