webrtc编译相关记录

created by 杨金彪

可以使用的编译选项

gn gen out/linux --args=’ is_debug=true target_os=“linux” target_cpu=“x64” is_clang=false treat_warnings_as_errors=false rtc_include_tests=false rtc_use_h264=true is_component_build=false use_custom_libcxx=false rtc_enable_protobuf=false use_rtti=true proprietary_codecs=true ’ --ide=“qtcreator”

等待测试的选项：

ffmpeg_branding=\"Chrome\"

使用boringssl webrtc自带的

gn gen out/linux --args=‘is_debug=true target_os=“linux” target_cpu=“x64” is_clang=false treat_warnings_as_errors=false is_component_build=false rtc_include_tests=false rtc_use_h264=true rtc_enable_protobuf=false use_rtti=true use_custom_libcxx=false treat_warnings_as_errors=false use_ozone=true’ --ide=qtcreator

使用openssl 需要重看编译问题.编译没有通过 有问题.

gn gen out/linux --args=‘is_debug=false target_os=“linux” target_cpu=“x64” treat_warnings_as_errors=false is_component_build=false is_clang=false rtc_include_tests=false rtc_use_h264=true rtc_enable_protobuf=false use_rtti=true use_custom_libcxx=false treat_warnings_as_errors=false use_ozone=true rtc_build_ssl=false rtc_ssl_root="/home/yang/code/openssl-1.0.2t"’ --ide=qtcreator

libmediasoup客户端的构建

cmake . -Bbuild -DLIBWEBRTC_INCLUDE_PATH:PATH=/home/yang/webrtc/agora/webrtc/src/ -DLIBWEBRTC_BINARY_PATH:PATH=/home/yang/newtest/webrtc/agora/webrtc/src/out/Release/obj -DCMAKE_CXX_FLAGS="-fvisibility=hidden"

-D_GLIBCXX_USE_CXX11_ABI=0 // 链接到旧版本，未启用c++11特性，std::string是std::basic_string，如将c++11下的string当作参数传入非c++11库，就会出现error: cannot convert ‘const std::__cxx11::basic_string’ to ‘const char*’，或者未定义的方法引用（undefined reference）

-D_GLIBCXX_USE_CXX11_ABI=1 // 链接到新版本
#define _GLIBCXX_USE_CXX11_ABI 0
#define _GLIBCXX_USE_CXX11_ABI 1

=====参数说明：
use_ozone
Current value (from the default) = false
From //build/config/ui.gni:30

Indicates if Ozone is enabled. Ozone is a low-level library layer for Linux
that does not require X11. Enabling this feature disables use of glib, x11,
Pango, and Cairo.

4 additional_target_cpus是我们想要在我们的整体架构中加入的额外的架构。在这里在一个库中我们需要有：arm，arm64，x86，以及x64架构。

5 is_component_build表示的是我们需要进行静态搭建还是动态搭建。我们在这里设定为false因为iOS需要静态构建。

=====end参数说明
cmake . -Bbuild -DLIBWEBRTC_INCLUDE_PATH:PATH=/home/yang/webrtc/agora/webrtc/src/ -DLIBWEBRTC_BINARY_PATH:PATH=/home/yang/newtest/webrtc/agora/webrtc/src/out/Release/obj

-DOPENSSL_INCLUDE_DIR:PATH=${PATH_TO_OPENSSL_HEADERS}
-DCMAKE_USE_OPENSSL=ON

gclient是用来同步代码，在和src同级目录会有一个隐藏.gclient文件，里面记录了基本的代码拉取设置
src里面的各个目录、甚至子目录，基本上都是一个独立的git库
gclient sync的命令回去检查整个项目的完整情况，并同步代码
如果gclient sync无法通过，一般都不是代码的问题，是因为工具链或依赖库和当前代码需要的不一致
gclient是用来同步代码和工具链的
gn 是用来产生ninja所需的配置文件
ninja 才是编译的
代码里面有很多*.gni，可以认为是和make脚本差不多的，是告诉ninja，我要编译某个项目
例如AppRTCMobile，需要哪些代码文件、以来哪些库

set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -DWEBRTC_LINUX=1 -DWEBRTC_POSIX=1")
gn clean < out_dir>

删除输出目录的内容，除了args.gn和创建一个足以重新生成构建的忍者构建环境。
个人见解：该命令行作用应与xcode中clean操作功能相识，clean后out中目录相关目录会被删除，
但不需要重新gn新的一份，可直接用ninja编译。

add_definitions(-D_GLIBCXX_USE_CXX11_ABI=0)

参考这个网址，意思是说gnustl过时了，应该用c++_shared。于是把APP_STL := gnustl_static改为APP_STL := c++_shared编译通过。

Problem was indeed that the library is built using libc++. Rebuilding on libstdc++ made the link suceed.
.clang version 9 .0.0 (trunk 3576 92).

相关参考的网址:

https://github.com/hujianhua888/webrtc_vs2015
https://webrtc.agora.io/
http://120.92.49.206:3232/chromiumsrc?page=3
https://blog.csdn.net/bvngh3247/article/details/81298131
https://github.com/mpromonet/webrtc-streamer
https://github.com/hujianhua888/webrtc_vs2015

QMAKE_CFLAGS 设置c编译器flag参数 QMAKE_CFLAGS += -g
QMAKE_CXXFLAGS 设置c++编译器flag参数 QMAKE_CXXFLAGS += -g
QMAKE_LFLAGS 设置链接器flag参数 QMAKE_LFLAGS += -rdynamic

rtti

下载和编译参照：http://depthlove.github.io/2019/05/02/webrtc-development-2-source-code-download-and-build/

最后的编译选项：

gn gen out/linux --args=‘target_os=“linux” target_cpu=“x64” is_debug=true is_clang=false treat_warnings_as_errors=false rtc_include_tests=false is_clang=false rtc_use_h264=true is_component_build=false use_custom_libcxx=false rtc_enable_protobuf=false use_rtti=true proprietary_codecs = true --ide=“qtcreator”’

1、连接webrtc静态库时候出现：error adding symbols: Malformed archive

vi build/config/compiler/BUILD.gn

搜索 complete_static_lib

去掉arflags = [ “-T” ] ，不用-T

连接：https://bugs.chromium.org/p/chromium/issues/detail?id=801925

2、GLIBCXX_3.4.20 not found(required by /home/webrtc/src/lout/linux/protoc)

可以升级libstdc++6.so的库

或者rtc_enable_protobuf=false 不使用protobuf

3、用GCC编译器而不是clang编译，选项is_clang=false、

3.1出现各种警告导致错误退出

declared with attribute warn_unused_result [-Werror=unused-result]

解决——添加选项：is_clang=false treat_warnings_as_errors=falsse

3.2 …/…/webrtc/base/array_view_unittest.cc:219:26: error: use of deleted function ‘rtc::BufferT::BufferT(const rtc::BufferT&) [with T = unsigned char]’

const rtc::Buffer cb = “very const”;

解决——添加选项：rtc_include_tests=false

4、连接时候各种C++库连接不了问题

解决：use_custom_libcxx=false这是用来控制编译WebRtc时使用的c++库的。原因很简单，如果不加这个编译开关的话，WebRtc编译默认使用libc++来编译，而我们编译别的代码用的是libstdc++，这样在编译的过程中就会导致用到std::string的地方各种错误

但是不要用这个选项use_custom_libcxx_for_host=false不然会有各种库问题

6、fatal error: list: No such file or directory#include
解决——export CPLUS_INCLUDE_PATH=/usr/include/c++/4.8:/usr/include/x86_64-linux-gnu/c++/4.8:$CPLUS_INCLUDE_PATH

5、webrtc编译出来的是静态库，如果你在编译一个动态库时候引用这个libwebrtc.a静态库，那么再用这个动态库取连接最终的应用程序时候，会报找不到webrtc的里面的标识。这个是本身特性的影响，如果要这样用，那么编译静态库时候要加入选项 -fPIC：表示编译为位置独立(地址无关)的代码 才允许这样使用。——因为webrtc编译还没有去人看，怎么加入这个选项，那么只能把代码中的libvrtp.so库去掉，直接编译执行程序。

插曲：

1、因为连接webrtc静态库时候出现：error adding symbols: Malformed archive问题，想看看静态库是否生成正确。才知道原来静态库可以解压成一个个.o文件，并且可以把多个静态库压缩成一个。
ar x /usr/local/lib/A.a——解压
ar x /usr/local/lib/B.a
ar x /usr/local/lib/C.a
ar cru libABC.a *.o——压缩
ranlib libABC.a——更新静态库的符号索引表

2、apt-get 安装程序时候出现版本依赖问题
apt : Depends: libstdc++6 (>= 4.6) but it is not going to be installed
解决——2.1、通过ubuntu官网下载对应的deb包安装。
2.2、通过已有的机器在目录/var/cache/apt/archives/下查找对应的包，拷贝过去安装。

龙芯的webrtc的编译:

/home/yang/build-bizchat-unknown-Debug/3party/deepin/src:/usr/lib/x86_64-linux-gnu/:/home/yang/build-bizchat-unknown-Debug/sdklib_wrapper/:/home/yang/bizchat/bizBin/lib/:/usr/lib/x86_64-linux-gnu

H264编译选项调整的参考

WebRTC可以支持H264，但在Linux下编译时，默认没有打开。
rtc_use_h264，这个开关控制了是否使用 H264 （对应C++代码中的宏 WEBRTC_USE_H264），在 webrtc/webrtc.gni 文件中定义：
rtc_use_h264 = proprietary_codecs && !is_android && !is_ios
proprietary_codecs 在 build/config/features.gni 中定义：
proprietary_codecs = is_chrome_branded || is_chromecast
我在 Linux 下编译，branded 默认是 Chromium ，所以，proprietary_codecs 默认就是 false 。
想来想去，只好通过 gn gen 时传入 args 来调整比较方便，使用下面的命令来生成 ninja 构建文件：
gn gen out/h264Debug --args=“proprietary_codecs=true”
执行完毕后，可以使用下列命令验证一下：
gn args out/h264Debug --list=proprietary_codecs
gn args out/h264Debug --list=rtc_use_h264

你是对 ssl 的函数加了 visibility hidden 属性吗？

多个库冲突的时候增加 visibility hidden 避免被外部的库调用。

添加 -fPIC

第一种 （笔者所采用的，因需修改原始CMakeLists.txt文件，感觉不太方便，非常希望能在cmake命令参数中处理）
add_compile_options(-fPIC)
第二种
set(CMAKE_C_FLAGS “KaTeX parse error: Double subscript at position 9: {CMAKE_C_̲FLAGS} -fPIC") …{CMAKE_CXX_FLAGS} -fPIC”)

//杨金彪整理