webrtc编译

webrtc编译

最近研究 libmediasoupclient,而 libmediasoupclient 又依赖 libwebrtc,所以首先就想着先在windows上编译一个webrtc的库,先是在网上找了一大堆,发现都不全面,导致各种问题,这里做个归纳总结。

由于 webrtc 是google的产物,而且很多东西都是自成一家,所以前提是需要FQ的。准备一个本地的代理,例如127.0.0.1:10080

windows

挂代理

代理需要挂在git和cmd下,后面通过git拉取depot_tools和webrtc都要借助git的代理,而挂在cmd下是为了在depot_tools下载好之后安装一系列工具链时下载用。

git

通过git拉取代码有http、https、ssh三种方式,对于这三种方式要分两种方式挂代理。详细可参考Git设置代理。本文后续使用的是https方式,所以只需要配置http和https即可。

  • http和https
    • git命令方式
      这里只针对后续可能使用的url地址使用代理,如果不带特定的url的话,会作用于全局。
      git config --global http.https://*.googlesource.com.proxy http://127.0.0.1:10080
      git config --global https.https://*.googlesource.com.proxy http://127.0.0.1:10080
      git config --global http.https://*.appspot.com.proxy http://127.0.0.1:10080
      git config --global https.https://*.appspot.com.proxy http://127.0.0.1:10080
      
    • 修改git配置文件
      修改git的配置文件 .gitconfig
      [http "https://*.googlesource.com"]
          proxy = http://127.0.0.1:10080
      [https "https://*.googlesource.com"]
          proxy = http://127.0.0.1:10080
      [http "https://*.appspot.com"]
          proxy = http://127.0.0.1:10080
      [https "https://*.appspot.com"]
          proxy = http://127.0.0.1:10080
      
  • ssh
    修改 .ssh 文件夹下的 config 文件
    Host googlesource.com
    User git
    ProxyCommand connect -H 127.0.0.1:10080 %h %p
    
    如果是socks5代理的话,最后的选项 -H 改成 -S

cmd

在cmd中直接设置环境变量,这两条命令只在当前窗口有效!

set http_proxy=127.0.0.1:10080
set https_proxy=127.0.0.1:10080

安装depot_tools

按照webrtc源码编译要求的,编译webrtc之前的准备工作需要安装google自家的depot_tools工具链。这个工具链的安装部署直接关系到后面是否能顺利下载webrtc的源码。

按照depot_tools安装描述的过程,大致分为以下几步:

  1. 获取 depot_tools

    • 使用 git 工具直接从google源码库中拉取

      git clone https://chromium.googlesource.com/chromium/tools/depot_tools.git
      
    • 直接下载depot_tools包并解压(解压时要以防某些解压工具不将压缩包中的隐藏文件一并解压!) https://storage.googleapis.com/chrome-infra/depot_tools.zip

  2. 设置环境变量
    将depot_tools文件夹所在路径设置在系统环境变量 PATH 的最前面!

  3. 执行 gclient
    通过cmd运行gclient,注意在此之前设置了cmd的代理!这条命令执行完成后,depot_tools目录下会多出很多东西,像python、git等工具都会被下载并安装在depot_tools的子目录下,被用于后续的过程,所以即使本地没有安装这些工具也不要紧。
    这条指令执行完后,大致会下载700-800左右的内容,最后会提示错误,因为后续只需要用来同步webrtc源码以及构建编译脚本等,所以忽略这个报错即可。
    WARNING: Your metrics.cfg file was invalid or nonexistent. A new one will be created.
    Error: client not configured; see 'gclient config'

    若在此步骤中出现以下错误,则还需要将本地代理设置为系统代理模式,具体原因参考:将PowerShell从版本5.1升级到7,以解决谷歌gclient下载CIPD client时报错的问题

    Updating depot_tools...
    Downloading CIPD client for windows-amd64 from https://chrome-infra-packages.appspot.com/client?platform=windows-amd64&version=git_revision:6e9be28a4c4e3a804f400dc6c2ed08b866f0a38b...
    FAILURE:
    +
    Invoke-WebRequest : 无法连接到远程服务器
    所在位置 E:\google\depot_tools\.cipd_impl.ps1:115 字符: 5
    +     Invoke-WebRequest -UserAgent $UserAgent -Uri $URL -OutFile $TmpPa ...
    +     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
        + CategoryInfo          : InvalidOperation: (System.Net.HttpWebRequest:HttpWebRequest) [Invoke-WebRequest],WebExce
        ption
        + FullyQualifiedErrorId : WebCmdletWebResponseException,Microsoft.PowerShell.Commands.InvokeWebRequestCommand
    
    Retrying after a short nap...
    
  4. 创建chrome/4147d的分支

    git checkout -b m84 origin/chrome/4147
    

    并再次执行 gclient sync

编译webrtc

下载源码

按照以下命令一步一步执行,第三步的fetch最花费时间,大概需要下载10G的内容,所以留意你代理的流量套餐!

mkdir webrtc
cd webrtc
fetch --nohooks webrtc
gclient sync

编译

我这里按照mediasoap要求的m84版本的webrtc编译为例

  1. 先创建m84版本(branch-heads/4147)的分支m84,然后执行 gclient sync

    git checkout -b m84 refs/remotes/branch-heads/4147
    
  2. 在环境变量中先设置 DEPOT_TOOLS_WIN_TOOLCHAIN 为0,否则在生成ninja工程时会报错

    set DEPOT_TOOLS_WIN_TOOLCHAIN=0
    
  3. 生成ninja工程

    gn gen out/m84 --args="is_debug=false is_component_build=false is_clang=false rtc_include_tests=false rtc_use_h264=true use_rtti=true use_custom_libcxx=false treat_warnings_as_errors=false"
    

    如果本地已安装有python3,并且被首选为python3的执行路径,这里有可能会出现报错,如:ValueError: path is on mount 'C:', start on mount 'F:',此时可以将本地安装的python3卸载或者去掉其环境变量,让depot_tool使用自带的python组件即可。

  4. 编译

    ninja -C out/m84 >> compile.log
    
  5. 编译过程中出现错误终端,打开compile.log文件查看失败的地方:

    [1466/3605] CC obj/third_party/ffmpeg/ffmpeg_internal/pcm.obj
    FAILED: obj/third_party/ffmpeg/ffmpeg_internal/pcm.obj 
    ...
    ...
    ...
    ../../third_party/ffmpeg/libavcodec/pcm.c(623): error C2059: 语法错误:“字符串”
    

    这里我将源文件中对应报错的行注释掉。

  6. 继续执行第4步,然后又出现下列错误

    [1834/2133] CXX obj/modules/video_coding/webrtc_h264/h264.obj
    FAILED: obj/modules/video_coding/webrtc_h264/h264.obj 
    ...
    ...
    ...
    E:\google\webrtc\src\modules/video_coding/codecs/h264/h264_decoder_impl.h(21): fatal error C1189: #error:  "See: bugs.webrtc.org/9213#c13."
    

    仍然注释掉报错行之后继续第4步,发现后续还会出现类似的报错,所以这里一次性注释掉另外三个文件中的行:See: bugs.webrtc.org/9213#c13.。三个文件分别是:

    • webrtc\src\modules/video_coding/codecs/h264/h264_decoder_impl.h(21)
    • webrtc\src\modules/video_coding/codecs/h264/h264_encoder_impl.h(21)
    • webrtc\src\modules/video_coding/codecs/h264/h264_color_space.h(20)
  7. 最终生成结果显示一大堆链接错误

    [286/289] LINK peerconnection_client.exe peerconnection_client.exe.pdb
    FAILED: peerconnection_client.exe peerconnection_client.exe.pdb 
    ...
    error LNK2001: 无法解析的外部符号 avpriv_emms_asm
    ...
    ./peerconnection_client.exe : fatal error LNK1120: 1 个无法解析的外部命令
    [287/289] LINK(DLL) webrtc_unity_plugin.dll webrtc_unity_plugin.dll.lib webrtc_unity_plugin.dll.pdb
    FAILED: webrtc_unity_plugin.dll webrtc_unity_plugin.dll.lib webrtc_unity_plugin.dll.pdb 
    ...
    error LNK2001: 无法解析的外部符号 avpriv_emms_as
    ...
    ./webrtc_unity_plugin.dll : fatal error LNK1120: 1 个无法解析的外部命令
    

    忽略,反正在out/m84/obj目录下已经生成我要的webrtc.lib文件了。

Linux

安装depot_tools

  1. 拉取depot_tools

    先设置git的代理,然后拉取depot_tools的代码,之后设置depot_tools的路径到 PATH 环变量。

  2. gclient sync

    在depot_tools目录下执行 gclient sync 之前,先做两件事:

    • 修改 update_depot_tools 文件
      将depot_tools目录下的 update_depot_tools 文件中关于使用root用户时就退出的地方去掉,否则运行这条指令的时候会提示Running depot tools as root is sad.,然后就没了反应。
    • 设置 curl 或者整个linux环境代理
      这里直接设置整个linux环境的代理,否则执行这条指令之后会提示curl https://chrome-infra-packages.appspot.com/ 失败之类的提示。
      可以在 ~/.bashrc 文件中最后加入下列两条,之后每次进入终端后,输入命令setproxy就可以了。
      alias setproxy="export http_proxy=http://10.18.0.60:10080;export https_proxy=http://10.18.0.60:10080;echo 'HTTP Proxy on';"
      alias unsetproxy="unset http_proxy; unset https_proxy; echo 'HTTP Proxy off';"
      

编译webrtc

参考windows上编译webrtc的步骤。

ubuntu上gcc版本最好在6.3之上,并且pkg-config和python已经安装,若pkg-config未安装,则会在生成ninja工程时报错,若gcc版本过低,则在编译时会报错!

参考

WebRTC development
WebRTC Development
depot_tools_tutorial
Git设置代理
curl 设置代理
Windows配置代理下载depot_tools
在win10上编译webRTC(问题篇)
Windows上WebRTC的源码下载和编译
Windows下webrtc.lib 的编译及vs工程中使用

posted @ 2021-08-02 14:56  never715  阅读(2188)  评论(6编辑  收藏  举报