1. windows10下編譯32位元和64位元webrtc(m77)靜態庫

省略掛代理下載depot_tools以及webrtc程式碼的過程。。。
可參考webrtc編譯

務必在 cmd 終端環境下進入到 webrtc\src 目錄，再執行以下操作！

1.1. 環境設定

• 在系統環境變數下編輯PATH，將depot_tools所在路徑放在PATH變數最前面。
• 設定環境變數 DEPOT_TOOLS_WIN_TOOLCHAIN=0

1.2. 編譯流程

1. 檢出m77版本的webrtc

   git checkout -b m77 remotes/branch-heads/m77
   

   gclient sync -D
   

   m77版本對應詳情：

   commit ad73985e75684cb4ac4dadb9d3d86ad0d66612a0 (HEAD -> m77, branch-heads/m77)
   Author: Henrik Boström <[email protected]>
   Date:   Wed Aug 21 12:09:51 2019 +0200
   
   Add implemented-but-missing members to RTCMediaStreamTrackStats::Members
   ...
   

2. 設定編譯引數

   gn args out\m77
   

   在彈出的 out\m77\args.gn 文字檔案中輸入編譯引數，或者直接以命令列引數形式攜帶。

3. 生成ninja編譯指令碼，並生成vs2017工程檔案

   gn gen out\m77 --ide=vs2017
   

4. 使用ninja編譯，將過程紀錄檔記錄到檔案

   ninja -C out\m77 -d stats >> out\m77\comp.log
   

1.3. 先說遇到的問題

1. ImportError: No module named win32file

   [236/2777] LIB obj/media/rtc_constants.lib
   FAILED: obj/media/rtc_constants.lib 
   e:/google/depot_tools/bootstrap-2@3_8_10_chromium_23_bin/python/bin/python.exe ../../build/toolchain/win/tool_wrapper.py link-wrapper environment.x64 False lib.exe /nologo /ignore:4221 /OUT:obj/media/rtc_constants.lib @obj/media/rtc_constants.lib.rsp
   Traceback (most recent call last):
   File "../../build/toolchain/win/tool_wrapper.py", line 31, in <module>
       import win32file    # pylint: disable=import-error
   ImportError: No module named win32file
   [237/2777] CXX obj/logging/rtc_stream_config/rtc_stream_config.obj
   

   參考Build issue with M76 version of webrtc on Windows

   使用以下命令

   python -m pip install pywin32
   

   最好保證系統環境變數路徑中沒有其他版本的python影響。

   然後繼續執行編譯流程中第4步。

2. fatal error C1189: #error: "See: bugs.webrtc.

   這個問題在編譯引數 is_clang=false 時才會出現

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

   註釋掉該行之後繼續執行編譯流程中第4步，發現後續還會出現類似的報錯

   E:\google\webrtc\src\modules/video_coding/codecs/h264/h264_color_space.h(20): fatal error C1189: #error:  "See: bugs.webrtc.org/9213#c13."
   

   E:\google\webrtc\src\modules/video_coding/codecs/h264/h264_decoder_impl.h(21): fatal error C1189: #error:  "See: bugs.webrtc.org/9213#c13."
   

   ，所以一次性註釋掉三個檔案中將會報錯的行：See: bugs.webrtc.org/9213#c13.

   • modules/video_coding/codecs/h264/h264_decoder_impl.h(21)
   • modules/video_coding/codecs/h264/h264_encoder_impl.h(21)
   • modules/video_coding/codecs/h264/h264_color_space.h(20)

   然後繼續執行編譯流程中第4步。

3. error C2059: 語法錯誤:「字串」

   [13/1314] CC obj/third_party/ffmpeg/ffmpeg_internal/pcm.obj
   FAILED: obj/third_party/ffmpeg/ffmpeg_internal/pcm.obj 
   ...
   ../../third_party/ffmpeg/libavcodec/pcm.c(629): error C2059: 語法錯誤:「字串」
   

   同樣註釋掉報錯這一行，然後繼續執行編譯流程中第4步。

4. 關於應用程式在webrtc.lib連結靜態庫時報錯

   Linker can't find CreatePeerConnectionFactory after M77 update

   修改方法

   148073: Add missing dependencies to the static library

   然後重新生成會增加：create_peerconnection_factory.lib
   同時更新：webrtc.lib

   再次編譯後報另外的連線錯誤：

   1>webrtc.lib(http_common.obj) : error LNK2019: 無法解析的外部符號 _AcquireCredentialsHandleA@36，該符號在函數 "enum rtc::HttpAuthResult... 中被參照
   1>webrtc.lib(http_common.obj) : error LNK2019: 無法解析的外部符號 __imp__FreeCredentialsHandle@4，該符號在函數 "public: virtual __thiscall rtc::`anonymous namespace'::NegotiateAuthContext::~NegotiateAuthContext(void)"... 中被參照
   1>webrtc.lib(http_common.obj) : error LNK2019: 無法解析的外部符號 _InitializeSecurityContextA@48，該符號在函數 "enum rtc::HttpAuthResult... 中被參照
   1>webrtc.lib(http_common.obj) : error LNK2019: 無法解析的外部符號 _CompleteAuthToken@8，該符號在函數 "enum rtc::HttpAuthResult __cdecl rtc::HttpAuthenticate... 中被參照
   1>webrtc.lib(http_common.obj) : error LNK2019: 無法解析的外部符號 __imp__DeleteSecurityContext@4，該符號在函數 "public: virtual __thiscall rtc::`anonymous namespace'::NegotiateAuthContext::~NegotiateAuthContext(void)"... 中被參照
   1>... : fatal error LNK1120: 5 個無法解析的外部命令
   

   解決方法：

   連結依賴庫中增加Secur32.lib
   微軟的解釋：包含了security.h的標頭檔案要加#pragma comment(lib,"Secur32.lib")
   AcquireCredentialsHandleA function (sspi.h)

   在這兩個檔案中都有對security.h的參照：
   rtc_base/http_common.cc:19:#include <security.h>
rtc_base/socket_adapters.cc:27:#include <security.h>

5. 無法解析的外部符號 avpriv_emms_asm

   這個問題在 is_clang=false 編譯64位元庫之後連結webrtc靜態庫時出現

   雖然生成了webrtc.lib，但在應用程式或者dll在連結webrtc時會報錯

   4>  正在建立庫 ... 和物件 ...
   4>webrtc.lib(autorename_libavcodec_utils.obj) : error LNK2019: 無法解析的外部符號 avpriv_emms_asm，該符號在函數 avcodec_default_execute 中被參照
   4>webrtc.lib(decode.obj) : error LNK2001: 無法解析的外部符號 avpriv_emms_asm
   4>webrtc.lib(vp3.obj) : error LNK2001: 無法解析的外部符號 avpriv_emms_asm
   4>webrtc.lib(pcm.obj) : error LNK2001: 無法解析的外部符號 avpriv_emms_asm
   4>E:\gitlab\sdk\zkms_client\build-win64\sdk\Debug\zkmsclient.dll : fatal error LNK1120: 1 個無法解析的外部命令
   

   根據網上有限的資料顯示，可能是X64不支援大多數組合指令，webrtc原始碼的第三方目錄ffmpeg裡面有組合程式碼。用clang編譯沒這個問題，但是clang編譯的庫vc不能參照。只能替換ffmpeg原始碼或者在windows上編譯 好ffmpeg，然後將ffmpeg的include和lib檔案新增到webrtc專案。

   但是筆者後來使用clang編譯的庫在vc下仍能正常使用。

參考：

webrtc 支援openh264
在win10上編譯webRTC（問題篇）
windows上編譯webrtc_m84支援h.264編解碼遇到的問題總結
webrtc 4577 version Build error，unresoved symbol avpriv_emms_asm, build with vs2017，x64

1.4. 編譯引數

在 gn args out\m77 命令執行之後彈出的文字檔案中就是編譯時需要的所有引數，關於全部引數及說明可以使用命令 gn args out\m77 --list 檢視。

1.4.1. 32位元編譯引數範例

# Build arguments go here.
# See "gn args <out_dir> --list" for available build arguments.

is_clang = true
is_debug = true

proprietary_codecs = true

rtc_build_examples = false
rtc_build_tools = false

rtc_include_internal_audio_device = false
rtc_include_pulse_audio = false
rtc_include_tests = false

rtc_libvpx_build_vp9 = false

rtc_use_gtk = false
rtc_use_h264 = true

target_cpu = "x86"
treat_warnings_as_errors = false

use_aura = false
use_custom_libcxx = false
use_gold = true
use_lld = false
use_ozone = true
use_rtti = true

1.4.2. 64位元編譯引數範例

只需將上述 target_cpu 的值換成 "x64" 即可。

1.5. 生成目標

如果一切順利，最終生成一大堆lib檔案，實際上我們只需要 webrtc.lib 檔案足矣。

1.6. 提取標頭檔案和庫檔案

1.6.1. 庫檔案提取

新建批次檔 gen-webrtc-lib.bat，鍵入以下內容。

echo off
 
:: 定義源目錄
set sourcePath=E:\google\webrtc\src\out\m77\obj
:: 定義目標路徑
set resulePath=E:\google\webrtc\lib
 
xcopy %sourcePath%\*.lib %resulePath%\  /s /c /y /h /r /f

pause

執行批次檔 gen-webrtc-lib.bat，webrtc的所有編譯好的庫檔案會拷貝到目標路徑下。

1.6.2. 標頭檔案提取

新建批次檔 gen-webrtc-inc.bat，鍵入以下內容。

echo off

:: 定義源目錄
set sourcePath=E:\google\webrtc\src
:: 定義目標路徑
set resulePath=E:\google\webrtc\include

robocopy %sourcePath% %resulePath% *.h *.hpp *.hxx ^
  /s /mt /log:robocopy-log.txt /fp /ndl  ^
  /xd ^
  "%sourcePath%\.git" ^
  "%sourcePath%\build" ^
  "%sourcePath%\build_overrides" ^
  "%sourcePath%\buildtools" ^
  "%sourcePath%\data" ^
  "%sourcePath%\examples" ^
  "%sourcePath%\out" ^
  "%sourcePath%\rtc_tools" ^
  "%sourcePath%\resources" ^
  "%sourcePath%\test" ^
  "%sourcePath%\testing" ^
  "%sourcePath%\tools" ^
  "%sourcePath%\tools_webrtc" ^
  "%sourcePath%\third_party\blink" ^
  "%sourcePath%\third_party\depot_tools" ^
  "%sourcePath%\third_party\catapult"

pause

執行批次檔 gen-webrtc-inc.bat，webrtc的標頭檔案會以源目錄結構形式拷貝到目標路徑下。

有關robocopy的使用，參考robocopy