diff --git a/thirdparty/libwebp/OAT.xml b/thirdparty/libwebp/OAT.xml new file mode 100644 index 0000000000000000000000000000000000000000..59bfaa37935f10e40e862ab0f657aa7f0bbc2823 --- /dev/null +++ b/thirdparty/libwebp/OAT.xml @@ -0,0 +1,21 @@ + + + + + + + + + + + + + + + + + + + + + diff --git a/thirdparty/libwebp/README.OpenSource b/thirdparty/libwebp/README.OpenSource new file mode 100644 index 0000000000000000000000000000000000000000..fd6816819ee8733fafc1ff939e1f7346349df53b --- /dev/null +++ b/thirdparty/libwebp/README.OpenSource @@ -0,0 +1,11 @@ +[ + { + "Name": "xxHash", + "License": "BSD licensed", + "License File": "https://github.com/Cyan4973/xxHash/blob/dev/LICENSE", + "Version Number": "v0.8.1", + "Owner": "1596268623@qq.com", + "Upstream URL": "https://github.com/Cyan4973/xxHash/archive/refs/tags/v0.8.1.tar.gz", + "Description": "xxHash is an Extremely fast Hash algorithm, processing at RAM speed limits. Code is highly portable." + } +] diff --git a/thirdparty/libwebp/README_zh.md b/thirdparty/libwebp/README_zh.md new file mode 100644 index 0000000000000000000000000000000000000000..a1460ab23f2f34e8567a9d649743452c5d43eb27 --- /dev/null +++ b/thirdparty/libwebp/README_zh.md @@ -0,0 +1,12 @@ +# xxHash 三方库说明 +## 功能简介 +xxHash是一种极快的哈希算法，在RAM速度限制下处理。 代码具有高度可移植性 +## 使用约束 +- IDE版本：DevEco Studio 3.1 Release +- SDK版本：ohos_sdk_public 4.0.8.1 (API Version 9 Release) +- 三方库版本：v0.8.1 +- xxHash是一种极快的哈希算法，在RAM速度限制下处理。 代码具有高度可移植性 +- [GNU Library General Public License](https://github.com/Cyan4973/xxHash/blob/dev/LICENSE) + +## 集成方式 ++ [应用hap包集成](docs/hap_integrate.md) diff --git a/thirdparty/libwebp/docs/hap_integrate.md b/thirdparty/libwebp/docs/hap_integrate.md new file mode 100644 index 0000000000000000000000000000000000000000..8c26b18b6652131ab17c421db19820e247a8e27c --- /dev/null +++ b/thirdparty/libwebp/docs/hap_integrate.md @@ -0,0 +1,84 @@ +# xxHash集成到应用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 4.0.8.1 (API Version 10 Release)](https://gitee.com/link?target=http%3A%2F%2Fdownload.ci.openharmony.cn%2Fversion%2FMaster_Version%2FOpenHarmony_4.0.8.1%2F20230608_091058%2Fversion-Master_Version-OpenHarmony_4.0.8.1-20230608_091058-ohos-sdk-public.tar.gz) +- [DevEco Studio 3.1 Release](https://gitee.com/link?target=https%3A%2F%2Fcontentcenter-vali-drcn.dbankcdn.cn%2Fpvt_2%2FDeveloperAlliance_package_901_9%2F81%2Fv3%2FtgRUB84wR72nTfE8Ir_xMw%2Fdevecostudio-windows-3.1.0.501.zip%3FHW-CC-KV%3DV1%26HW-CC-Date%3D20230621T074329Z%26HW-CC-Expire%3D315360000%26HW-CC-Sign%3D22F6787DF6093ECB4D4E08F9379B114280E1F65DA710599E48EA38CB24F3DBF2) +- [准备三方库构建环境](../../../tools/README.md#编译环境准备) +- [准备三方库测试环境](../../../tools/README.md#ci环境准备) +## 编译三方库 +- 下载本仓库 + ``` + git clone https://gitee.com/openharmony-sig/tpc_c_cplusplus.git --depth=1 + ``` +- 三方库目录结构 + ``` + tpc_c_cplusplus/thirdparty/xxHash #三方库的目录结构如下 + ├── docs #三方库相关文档的文件夹 + ├── HPKBUILD #构建脚本 + ├── SHA512SUM #三方库校验文件 + ├── README.OpenSource #说明三方库源码的下载地址，版本，license等信息 + ├── README_zh.md + ``` + +- 将三方库拷贝至tools/main目录下 + ```shell + cd tpc_c_cplusplus + mkdir -p main + cp thirdparty/libpng tools/main/ -rf + cp thirdparty/xxHash tools/main/ -rf + cp thirdparty/libjpeg-turbo tools/main/ -rf + ``` +- 在tools目录下编译三方库 + 编译环境的搭建参考[准备三方库构建环境](../../../tools/README.md#编译环境准备) + ``` + cd tools + ./build.sh ./build.sh xxHash libpng libjpeg-turbo + ``` +- 三方库头文件及生成的库 + 在tools目录下会生成usr目录，该目录下存在已编译完成的32位和64位三方库 + ``` + xxHash/arm64-v8a + xxHash/armeabi-v7a + ``` + +- [测试三方库](#测试三方库) + +## 应用中使用三方库 + +- 在IDE的cpp目录下新增thirdparty目录，将编译生成的库拷贝到该目录下，如下图所示 + ![thirdparty_install_dir](pic/install_dir.png) +- 在最外层（cpp目录下）CMakeLists.txt中添加如下语句 + +``` +#将三方库加入工程中 +target_link_libraries(entry PRIVATE ${CMAKE_CURRENT_SOURCE_DIR}/thirdparty/libjpeg-turbo/${OHOS_ARCH}/lib/libjpeg.a) +target_link_libraries(entry PRIVATE ${CMAKE_CURRENT_SOURCE_DIR}/thirdparty/libjpeg-turbo/${OHOS_ARCH}/lib/libturbojpeg.a) +target_link_libraries(entry PRIVATE ${CMAKE_CURRENT_SOURCE_DIR}/thirdparty/libpng/${OHOS_ARCH}/lib/libpng.a) +target_link_libraries(entry PRIVATE ${CMAKE_CURRENT_SOURCE_DIR}/thirdparty/libpng/${OHOS_ARCH}/lib/libpng16.a) +target_link_libraries(entry PRIVATE ${CMAKE_CURRENT_SOURCE_DIR}/thirdparty/libwebp/${OHOS_ARCH}/lib/libsharpyuv.so.0.0.0) +target_link_libraries(entry PRIVATE ${CMAKE_CURRENT_SOURCE_DIR}/thirdparty/libwebp/${OHOS_ARCH}/lib/libwebp.so.7.1.6) +target_link_libraries(entry PRIVATE ${CMAKE_CURRENT_SOURCE_DIR}/thirdparty/libwebp/${OHOS_ARCH}/lib/libwebpdecoder.so.3.1.6) +target_link_libraries(entry PRIVATE ${CMAKE_CURRENT_SOURCE_DIR}/thirdparty/libwebp/${OHOS_ARCH}/lib/libwebpdemux.so.2.0.12) +target_link_libraries(entry PRIVATE ${CMAKE_CURRENT_SOURCE_DIR}/thirdparty/libwebp/${OHOS_ARCH}/lib/libwebpmux.so.3.0.11) +#将三方库的头文件加入工程中 +target_include_directories(entry PRIVATE ${CMAKE_CURRENT_SOURCE_DIR}/thirdparty/libjpeg-turbo/${OHOS_ARCH}/include) +target_include_directories(entry PRIVATE ${CMAKE_CURRENT_SOURCE_DIR}/thirdparty/libpng/${OHOS_ARCH}/include) +target_include_directories(entry PRIVATE ${CMAKE_CURRENT_SOURCE_DIR}/thirdparty/libwebp/${OHOS_ARCH}/include) +``` + ![thirdparty_usage](pic/usage.png) +## 测试三方库 +三方库的测试使用原库自带的测试用例来做测试 + +进入到构建目录获取,执行ctest，运行测试用例（xxHash-arm64-v8a-build为构建64位的目录，xxHash-armeabi-v7a-build为构建32位的目录） + ![thirdparty_test_result](pic/test_result.png) + + +## 参考资料 +- [润和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/libwebp/docs/pic/install_dir.png b/thirdparty/libwebp/docs/pic/install_dir.png new file mode 100755 index 0000000000000000000000000000000000000000..802cbac20f3fc5a43fcd949bfda62333c7dd45f2 Binary files /dev/null and b/thirdparty/libwebp/docs/pic/install_dir.png differ diff --git a/thirdparty/libwebp/docs/pic/test_result.png b/thirdparty/libwebp/docs/pic/test_result.png new file mode 100755 index 0000000000000000000000000000000000000000..f1d2523729d8514d1cbffcd48092d9d3808414d9 Binary files /dev/null and b/thirdparty/libwebp/docs/pic/test_result.png differ diff --git a/thirdparty/libwebp/docs/pic/usage.png b/thirdparty/libwebp/docs/pic/usage.png new file mode 100755 index 0000000000000000000000000000000000000000..2da5473b70c8d8beefb85d21446a32e8aab8bb5c Binary files /dev/null and b/thirdparty/libwebp/docs/pic/usage.png differ diff --git a/thirdparty/xxHash/HPKBUILD b/thirdparty/xxHash/HPKBUILD new file mode 100644 index 0000000000000000000000000000000000000000..8c543742a55872e786aeaea98fd94f9fdfa6b6cb --- /dev/null +++ b/thirdparty/xxHash/HPKBUILD @@ -0,0 +1,50 @@ +# Contributor: Jeff Han +# Maintainer: Jeff Han +pkgname=libwebp +pkgver=v1.3.0 +pkgrel=0 +pkgdesc="" +url="" +archs=("armeabi-v7a" "arm64-v8a") +license="BSD" +depends=("libpng" "libjpeg-turbo") # TODO GIF/SDL +makedepends=() + +source="https://github.com/webmproject/$pkgname/archive/refs/tags/$pkgver.tar.gz" + +autounpack=true +downloadpackage=true + +builddir=$pkgname-${pkgver:1} +packagename=$builddir.tar.gz + +prepare() { + mkdir -p $builddir/$ARCH-build +} + +build() { + cd $builddir + ${OHOS_SDK}/native/build-tools/cmake/bin/cmake "$@" -DBUILD_SHARED_LIBS=ON -DOHOS_ARCH=$ARCH -B$ARCH-build -S./ -L > `pwd`/$ARCH-build/build.log 2>&1 + make -j4 -C $ARCH-build >> `pwd`/$ARCH-build/build.log 2>&1 + ret=$? + cd $OLDPWD + return $ret +} + +package() { + cd "$builddir" + make -C $ARCH-build install >> `pwd`/$ARCH-build/build.log 2>&1 + cd $OLDPWD +} + +check() { + echo "The test must be on an OpenHarmony device!" + #拷贝到开发板运行： + #cd xxHash-0.8.1/tests + #/bin/sh ./unicode_lint.sh +} + +# 清理环境 +cleanbuild(){ + rm -rf ${PWD}/$builddir #${PWD}/$packagename +} diff --git a/thirdparty/xxHash/OAT.xml b/thirdparty/xxHash/OAT.xml new file mode 100644 index 0000000000000000000000000000000000000000..59bfaa37935f10e40e862ab0f657aa7f0bbc2823 --- /dev/null +++ b/thirdparty/xxHash/OAT.xml @@ -0,0 +1,21 @@ + + + + + + + + + + + + + + + + + + + + + diff --git a/thirdparty/xxHash/README.OpenSource b/thirdparty/xxHash/README.OpenSource new file mode 100644 index 0000000000000000000000000000000000000000..fd6816819ee8733fafc1ff939e1f7346349df53b --- /dev/null +++ b/thirdparty/xxHash/README.OpenSource @@ -0,0 +1,11 @@ +[ + { + "Name": "xxHash", + "License": "BSD licensed", + "License File": "https://github.com/Cyan4973/xxHash/blob/dev/LICENSE", + "Version Number": "v0.8.1", + "Owner": "1596268623@qq.com", + "Upstream URL": "https://github.com/Cyan4973/xxHash/archive/refs/tags/v0.8.1.tar.gz", + "Description": "xxHash is an Extremely fast Hash algorithm, processing at RAM speed limits. Code is highly portable." + } +] diff --git a/thirdparty/xxHash/README_zh.md b/thirdparty/xxHash/README_zh.md new file mode 100644 index 0000000000000000000000000000000000000000..a1460ab23f2f34e8567a9d649743452c5d43eb27 --- /dev/null +++ b/thirdparty/xxHash/README_zh.md @@ -0,0 +1,12 @@ +# xxHash 三方库说明 +## 功能简介 +xxHash是一种极快的哈希算法，在RAM速度限制下处理。 代码具有高度可移植性 +## 使用约束 +- IDE版本：DevEco Studio 3.1 Release +- SDK版本：ohos_sdk_public 4.0.8.1 (API Version 9 Release) +- 三方库版本：v0.8.1 +- xxHash是一种极快的哈希算法，在RAM速度限制下处理。 代码具有高度可移植性 +- [GNU Library General Public License](https://github.com/Cyan4973/xxHash/blob/dev/LICENSE) + +## 集成方式 ++ [应用hap包集成](docs/hap_integrate.md) diff --git a/thirdparty/xxHash/SHA512SUM b/thirdparty/xxHash/SHA512SUM new file mode 100644 index 0000000000000000000000000000000000000000..c5fb61f59b03f6b60b55ab04e84ca1bff5326e5c --- /dev/null +++ b/thirdparty/xxHash/SHA512SUM @@ -0,0 +1 @@ +96f73ba6caee4e65535721ca80faa976f51930eb6693e4499593e896f15269dfb756defabe7afbefb3bd2ef90afc0c95e3ba49d8020bc18589c34e9e680d955a libwebp-1.3.0.tar.gz diff --git a/thirdparty/xxHash/docs/hap_integrate.md b/thirdparty/xxHash/docs/hap_integrate.md new file mode 100644 index 0000000000000000000000000000000000000000..2953fd676c66df449c9f7f78b021c14c5e0bdb04 --- /dev/null +++ b/thirdparty/xxHash/docs/hap_integrate.md @@ -0,0 +1,73 @@ +# xxHash集成到应用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 4.0.8.1 (API Version 10 Release)](https://gitee.com/link?target=http%3A%2F%2Fdownload.ci.openharmony.cn%2Fversion%2FMaster_Version%2FOpenHarmony_4.0.8.1%2F20230608_091058%2Fversion-Master_Version-OpenHarmony_4.0.8.1-20230608_091058-ohos-sdk-public.tar.gz) +- [DevEco Studio 3.1 Release](https://gitee.com/link?target=https%3A%2F%2Fcontentcenter-vali-drcn.dbankcdn.cn%2Fpvt_2%2FDeveloperAlliance_package_901_9%2F81%2Fv3%2FtgRUB84wR72nTfE8Ir_xMw%2Fdevecostudio-windows-3.1.0.501.zip%3FHW-CC-KV%3DV1%26HW-CC-Date%3D20230621T074329Z%26HW-CC-Expire%3D315360000%26HW-CC-Sign%3D22F6787DF6093ECB4D4E08F9379B114280E1F65DA710599E48EA38CB24F3DBF2) +- [准备三方库构建环境](../../../tools/README.md#编译环境准备) +- [准备三方库测试环境](../../../tools/README.md#ci环境准备) +## 编译三方库 +- 下载本仓库 + ``` + git clone https://gitee.com/openharmony-sig/tpc_c_cplusplus.git --depth=1 + ``` +- 三方库目录结构 + ``` + tpc_c_cplusplus/thirdparty/xxHash #三方库的目录结构如下 + ├── docs #三方库相关文档的文件夹 + ├── HPKBUILD #构建脚本 + ├── SHA512SUM #三方库校验文件 + ├── README.OpenSource #说明三方库源码的下载地址，版本，license等信息 + ├── README_zh.md + ``` + +- 将三方库拷贝至tools/main目录下 + ```shell + cd tpc_c_cplusplus + cp thirdparty/xxHash tools/main -rf + ``` +- 在tools目录下编译三方库 + 编译环境的搭建参考[准备三方库构建环境](../../../tools/README.md#编译环境准备) + ``` + cd tools + ./build.sh xxHash + ``` +- 三方库头文件及生成的库 + 在tools目录下会生成usr目录，该目录下存在已编译完成的32位和64位三方库 + ``` + xxHash/arm64-v8a + xxHash/armeabi-v7a + ``` + +- [测试三方库](#测试三方库) + +## 应用中使用三方库 + +- 在IDE的cpp目录下新增thirdparty目录，将编译生成的库拷贝到该目录下，如下图所示 + ![thirdparty_install_dir](pic/install_dir.png) +- 在最外层（cpp目录下）CMakeLists.txt中添加如下语句 + +``` +xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx +xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx +#将三方库加入工程中 +target_link_libraries(entry PRIVATE ${CMAKE_CURRENT_SOURCE_DIR}/thirdparty/xxHash/${OHOS_ARCH}/lib/libarchive.a) +#将三方库的头文件加入工程中 +target_include_directories(entry PRIVATE ${CMAKE_CURRENT_SOURCE_DIR}/thirdparty/xxHash/${OHOS_ARCH}/include) +``` + ![thirdparty_usage](pic/usage.png) +## 测试三方库 +三方库的测试使用原库自带的测试用例来做测试 + +进入到构建目录获取,执行ctest，运行测试用例（xxHash-arm64-v8a-build为构建64位的目录，xxHash-armeabi-v7a-build为构建32位的目录） + ![thirdparty_test_result](pic/test_result.png) + + +## 参考资料 +- [润和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)