diff --git a/thirdparty/coturn/HPKBUILD b/thirdparty/coturn/HPKBUILD new file mode 100644 index 0000000000000000000000000000000000000000..2bd77fe1adf7b23a8670e65dd46f4845ad00e300 --- /dev/null +++ b/thirdparty/coturn/HPKBUILD @@ -0,0 +1,72 @@ +# Contributor: Chen Xu +# Maintainer: Chen Xu +pkgname=coturn +pkgver="4.6.2" +pkgrel=0 +pkgdesc="coturn is a free open source implementation of TURN and STUN Server. The TURN Server is a VoIP media traffic NAT traversal server and gateway." +url="https://github.com/coturn/coturn" +archs=("armeabi-v7a" "arm64-v8a") +license=("BSD-3-Clause") +depends=("openssl" "libevent" "sqlite") +makedepends=() + +source="https://github.com/$pkgname/$pkgname/archive/refs/tags/$pkgver.tar.gz" + +downloadpackage=true +autounpack=true +buildtools="configure" + +builddir=$pkgname-${pkgver} +packagename=$builddir.tar.gz + +source envset.sh +host= + +prepare() { + cp -rf $builddir $builddir-$ARCH-build + if [ $ARCH == "armeabi-v7a" ] + then + setarm32ENV + host=arm-linux + fi + if [ $ARCH == "arm64-v8a" ] + then + setarm64ENV + host=aarch64-linux + fi +} + +build() { + cd $builddir-$ARCH-build + PKG_CONFIG_LIBDIR="${pkgconfigpath}" ./configure "$@" --host=$host > `pwd`/build.log 2>&1 + make -j4 VERBOSE=1 >> `pwd`/build.log 2>&1 + ret=$? + cd $OLDPWD + return $ret +} + +package() { + cd $builddir-$ARCH-build + make install VERBOSE=1 >> `pwd`/build.log 2>&1 + cd $OLDPWD + unset host +} + +check() { + if [ $ARCH == "armeabi-v7a" ] + then + unsetarm32ENV + fi + if [ $ARCH == "arm64-v8a" ] + then + unsetarm64ENV + fi + echo "The test must be on an OpenHarmony device!" + # export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:${LYCIUM_ROOT}/usr/libevent/arm64-v8a/lib/:${LYCIUM_ROOT}/usr/openssl/arm64-v8a/lib:${LYCIUM_ROOT}/usr/sqlite/arm64-v8a/lib + # make test VERBOSE=1 +} + +# 清理环境 +cleanbuild() { + rm -rf ${PWD}/$builddir ${PWD}/$builddir-arm64-v8a-build ${PWD}/$builddir-armeabi-v7a-build #${PWD}/$packagename +} diff --git a/thirdparty/coturn/HPKCHECK b/thirdparty/coturn/HPKCHECK new file mode 100644 index 0000000000000000000000000000000000000000..77205599c9522a99f0ebd0b620f85a171eccedc1 --- /dev/null +++ b/thirdparty/coturn/HPKCHECK @@ -0,0 +1,15 @@ +# Contributor: Chen Xu +# Maintainer: Chen Xu + +source HPKBUILD > /dev/null 2>&1 +logfile=${LYCIUM_THIRDPARTY_ROOT}/${pkgname}/${pkgname}_${ARCH}_${OHOS_SDK_VER}_test.log + +openharmonycheck() { + res=0 + cd $builddir-$ARCH-build + make test VERBOSE=1 > ${logfile} 2>&1 + res=$? + + cd $OLDPWD + return $res +} diff --git a/thirdparty/coturn/OAT.xml b/thirdparty/coturn/OAT.xml new file mode 100644 index 0000000000000000000000000000000000000000..a203e523c1aaf25beaf1003708ee5b2f4c8ecc4f --- /dev/null +++ b/thirdparty/coturn/OAT.xml @@ -0,0 +1,63 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/thirdparty/coturn/README.OpenSource b/thirdparty/coturn/README.OpenSource new file mode 100644 index 0000000000000000000000000000000000000000..dfbeb02993a9032e2041107f788863813225cd42 --- /dev/null +++ b/thirdparty/coturn/README.OpenSource @@ -0,0 +1,11 @@ +[ + { + "Name": "coturn", + "License": "BSD-3-Clause", + "License File": "LICENSE", + "Version Number": "4.6.2", + "Owner": "chenxu.unix@gmail.com", + "Upstream URL": "https://github.com/coturn/coturn.git", + "Description": "coturn is a free open source implementation of TURN and STUN Server. The TURN Server is a VoIP media traffic NAT traversal server and gateway." + } +] diff --git a/thirdparty/coturn/README_zh.md b/thirdparty/coturn/README_zh.md new file mode 100644 index 0000000000000000000000000000000000000000..e7926fd2c2320e4b5beadaf542d665faf01cd3b8 --- /dev/null +++ b/thirdparty/coturn/README_zh.md @@ -0,0 +1,11 @@ +# coturn三方库说明 +## 功能简介 +coturn是TURN和STUN服务器的免费开源实现。 +## 使用约束 +- IDE版本：DevEco Studio 3.1 Release +- SDK版本：ohos_sdk_public 4.0.8.1 (API Version 10 Release) +- 三方库版本：4.6.2 +- 当前适配的功能：STUN、TURN、ICE + +## 集成方式 ++ [应用hap包集成](docs/hap_integrate.md) diff --git a/thirdparty/coturn/SHA512SUM b/thirdparty/coturn/SHA512SUM new file mode 100644 index 0000000000000000000000000000000000000000..7d3d6cf1a1c3c0a37de2c935d7c21eadd14b64a7 --- /dev/null +++ b/thirdparty/coturn/SHA512SUM @@ -0,0 +1 @@ +ab8457921952a00b34111c03f2e5a2a9035977566270fdf9c8b9b777346645a8b233574134c0ef1c3aa2cf84bd89fbc82648678144c68ac0dff1712ce503b731 coturn-4.6.2.tar.gz diff --git a/thirdparty/coturn/docs/hap_integrate.md b/thirdparty/coturn/docs/hap_integrate.md new file mode 100644 index 0000000000000000000000000000000000000000..3a68170eb353cb97226dad736a1f060ac0ec28bd --- /dev/null +++ b/thirdparty/coturn/docs/hap_integrate.md @@ -0,0 +1,75 @@ +# coturn集成到应用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) +- [准备三方库构建环境](../../../lycium/README.md#1编译环境准备) +- [准备三方库测试环境](../../../lycium/README.md#3ci环境准备) +## 编译三方库 +- 下载本仓库 + ``` + git clone https://gitee.com/openharmony-sig/tpc_c_cplusplus.git --depth=1 + ``` +- 三方库目录结构 + ``` + tpc_c_cplusplus/thirdparty/coturn #三方库coturn的目录结构如下 + ├── docs #三方库相关文档的文件夹 + ├── HPKBUILD #构建脚本 + ├── HPKCHECK #自动化测试脚本 + ├── SHA512SUM #三方库校验文件 + ├── OAT.xml #OAT文件 + ├── README.OpenSource #说明三方库源码的下载地址，版本，license等信息 + ├── README_zh.md + ``` + +- 在lycium目录下编译三方库 + 编译环境的搭建参考[准备三方库构建环境](../../../lycium/README.md#1编译环境准备) + + ``` + cd lycium + ./build.sh coturn + ``` +- 三方库头文件及生成的库 + 在lycium目录下会生成usr目录，该目录下存在已编译完成的32位和64位三方库 + ``` + coturn/armeabi-v7a coturn/arm64-v8a + ``` + +- [测试三方库](#测试三方库) + +## 应用中使用三方库 + +- 在IDE的cpp目录下新增thirdparty目录，将编译生成的库头文件拷贝到该目录下, 如下图所示 + ![thirdparty_install_dir](pic/screen_cut.jpg) + +- 在最外层（cpp目录下）CMakeLists.txt中添加如下语句 + ``` + #将三方库加入工程中 + target_link_libraries(entry PRIVATE ${CMAKE_CURRENT_SOURCE_DIR}/../../../libs/${OHOS_ARCH}/libturnclient.a) + + #将三方库的头文件加入工程中 + target_include_directories(entry PRIVATE + ${CMAKE_CURRENT_SOURCE_DIR}/thirdparty/coturn/${OHOS_ARCH}/include) + ``` + +## 测试三方库 +三方库的测试使用原库自带的测试用例来做测试，[准备三方库测试环境](../../../lycium/README.md#3ci环境准备) + +- 进入到构建目录,执行如下命令（arm64-v8a-build为构建64位的目录，armeabi-v7a-build为构建32位的目录） +注意:以下为64位命令，如需测试32位，请将arm64-v8a替换为armeabi-v7a。 +``` +export LD_LIBRARY_PATH=${LYCIUM_ROOT}/usr/libevent/arm64-v8a/lib/:${LYCIUM_ROOT}/usr/openssl/arm64-v8a/lib:${LYCIUM_ROOT}/usr/sqlite/arm64-v8a/lib:$LD_LIBRARY_PATH +make test +``` + +测试用例运行结果如下： + + ![coturn_test](pic/run_screen_cut.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/coturn/docs/pic/run_screen_cut.jpg b/thirdparty/coturn/docs/pic/run_screen_cut.jpg new file mode 100644 index 0000000000000000000000000000000000000000..f31b5a48435c81323dcac0da8afac30b22345750 Binary files /dev/null and b/thirdparty/coturn/docs/pic/run_screen_cut.jpg differ diff --git a/thirdparty/coturn/docs/pic/screen_cut.jpg b/thirdparty/coturn/docs/pic/screen_cut.jpg new file mode 100755 index 0000000000000000000000000000000000000000..34ed6e7d636d215c6f230e9e0f0d26a5a286591d Binary files /dev/null and b/thirdparty/coturn/docs/pic/screen_cut.jpg differ