Skip to content

Building the WebRTC lib for Windows

Jump to bottom Edit New page
ken edited this page Mar 27, 2017 · 13 revisions

This guide is specific to the WebRTC release that is being compiled. It has been tested on 64-bit Windows 10 to build WebRTC branch-head/57.

These instructions are derived from following links:

Download dependencies

  1. Install Visual Studio 2015 Update 2 or later - Community Edition should work if its license is appropriate for you. Use the Custom Install option and select:

    • Visual C++, which will select three sub-categories including MFC
    • Universal Windows Apps Development Tools > Tools
    • Universal Windows Apps Development Tools > Windows 10 SDK (10.0.10586)

  2. Install the Chromium depot tolls

  3. Download depot_tools.zip and decompress it.

  4. Add depot_tools to the end of your PATH: * With Administrator access:

    • Control Panel > System and Security > System > Advanced system settings

    • Modify the PATH system variable to include depot_tools

* Without Administrator access:

  * `Control Panel > User Accounts > User Accounts > Change my environment variables`

  * Add a PATH user variable: `%PATH%;C:\path\to\depot_tools`
  1. Run gclient from the cmd shell. The first time it is run, it will install its own copy various tools.

Download the source code

  1. Create a working directory, enter it, and run fetch webrtc. This guide assumes a specific working folder structure. This operation starts from a base directory, eg., workspace and proceeds from there. References made later on expect the Tincan repo to be cloned into workspace/ipop-project/
mkdir webrtc-checkout
cd webrtc-checkout
fetch --nohooks webrtc
  1. Choose the stable release 57 rather than the most recent release by entering:
cd src
git branch -r
git checkout branch-heads/57
  1. Download the code
gclient sync

Note: The download will take a while, but it no longer downloads the Chromium repository after branch-head/57. Do not interrupt this step or you may need to start all over again (a new gclient sync may be enough, but you might also need wipe your webrtc_checkout\src folder and start over).

Update your checkout

To update an existing checkout, you can run

git rebase-update
gclient sync

The first command updates the primary Chromium source repository and rebases any of your local branches on top of tip-of-tree (aka the Git branch origin/master). If you don't want to use this script, you can also just use git pull or other common Git commands to update the repo.

The second command syncs the subrepositories to the appropriate versions and re-runs the hooks as needed.

Building WebRTC library

  1. After downloading the code, you can start you can optionally edit build/config/compiler/BUILD.gn and set use_rtti = true. You can also set build/config/BUILDCONFIG.gn is_debug=false for a release build.

The default configuration is for a 64-bit debug build:

gn gen out/Debug_x64 "--args=use_rtti=true"
ninja -C out/Debug_x64 rtc_base
ninja -C out/Debug_x64 p2p
ninja -C out/Debug_x64 field_trial_default
ninja -C out/Debug_x64 protobuf_full

To create a 64-bit release build you must edit the GN args and set is_debug = true

gn gen out/Release_x64 "--args=is_debug = false use_rtti=true"
ninja -C out/Release_x64 rtc_base
ninja -C out/Release_x64 p2p
ninja -C out/Release_x64 field_trial_default
ninja -C out/Release_x64 protobuf_full

Extract the static libraries

Currently the libraries we need from out/Debug_x64 and out/Release_x64 are:
boringssl.lib;field_trial_default.lib;protobuf_full.lib;rtc_base.lib; rtc_base_approved.lib;rtc_p2p.lib;json_writer.obj;json_value.obj;json_reader.obj

cp ./out/Debug_x64/boringssl.dll.lib ../../ipop-project/Tincan/external/lib/debug_x64/win/boringssl.lib
cp ./out/Debug_x64/obj/webrtc/system_wrappers/field_trial_default.lib ../../ipop-project/Tincan/external/lib/debug_x64/win/
cp ./out/Debug_x64/obj/webrtc/base/rtc_base.lib ../../ipop-project/Tincan/external/lib/debug_x64/win/
cp ./out/Debug_x64/obj/webrtc/base/rtc_base_approved.lib ../../ipop-project/Tincan/external/lib/debug_x64/win/
cp ./out/Debug_x64/obj/webrtc/p2p/rtc_p2p.lib ../../ipop-project/Tincan/external/lib/debug_x64/win/
cp ./out/Debug_x64/obj/third_party/protobuf/protobuf_full.lib ../../ipop-project/Tincan/external/lib/debug_x64/win/
cp ./out/Debug_x64/obj/third_party/jsoncpp/jsoncpp/json_reader.obj ../../ipop-project/Tincan/external/lib/debug_x64/win/
cp ./out/Debug_x64/obj/third_party/jsoncpp/jsoncpp/json_writer.obj ../../ipop-project/Tincan/external/lib/debug_x64/win/
cp ./out/Debug_x64/obj/third_party/jsoncpp/jsoncpp/json_value.obj ../../ipop-project/Tincan/external/lib/debug_x64/win/

cp ./out/Debug_x64/boringssl.dll.pdb ../../ipop-project/Tincan/external/lib/debug_x64/win/boringssl.pdb
cp ./out/Debug_x64/obj/third_party/jsoncpp/jsoncpp_cc.pdb ../../ipop-project/Tincan/external/lib/debug_x64/win/
cp ./out/Debug_x64/obj/third_party/protobuf/protobuf_full.lib ../../ipop-project/Tincan/external/lib/debug_x64/win/
cp ./out/Debug_x64/obj/webrtc/p2p/rtc_p2p_cc.pdb ../../ipop-project/Tincan/external/lib/debug_x64/win/
cp ./out/Debug_x64/obj/webrtc/base/rtc_base_cc.pdb ../../ipop-project/Tincan/external/lib/debug_x64/win/
cp ./out/Debug_x64/obj/webrtc/base/rtc_base_approved_cc.pdb ../../ipop-project/Tincan/external/lib/debug_x64/win/
cp ./out/Debug_x64/obj/webrtc/system_wrappers/field_trial_default_cc.pdb ../../ipop-project/Tincan/external/lib/debug_x64/win/

cp ./out/Release_x64/obj/third_party/boringssl/boringssl.lib ../../ipop-project/Tincan/external/lib/release_x64/win/boringssl.lib
cp ./out/Release_x64/obj/webrtc/system_wrappers/field_trial_default.lib ../../ipop-project/Tincan/external/lib/release_x64/win/
cp ./out/Release_x64/obj/webrtc/base/rtc_base.lib ../../ipop-project/Tincan/external/lib/release_x64/win/
cp ./out/Release_x64/obj/webrtc/base/rtc_base_approved.lib ../../ipop-project/Tincan/external/lib/release_x64/win/
cp ./out/Release_x64/obj/webrtc/p2p/rtc_p2p.lib ../../ipop-project/Tincan/external/lib/release_x64/win/
cp ./out/Release_x64/obj/third_party/protobuf/protobuf_full.lib ../../ipop-project/Tincan/external/lib/release_x64/win/
cp ./out/Release_x64/obj/third_party/jsoncpp/jsoncpp/json_reader.obj ../../ipop-project/Tincan/external/lib/release_x64/win/
cp ./out/Release_x64/obj/third_party/jsoncpp/jsoncpp/json_writer.obj ../../ipop-project/Tincan/external/lib/release_x64/win/
cp ./out/Release_x64/obj/third_party/jsoncpp/jsoncpp/json_value.obj ../../ipop-project/Tincan/external/lib/release_x64/win/

cp ./out/Release_x64/obj/third_party/boringssl/boringssl_c.pdb ../../ipop-project/Tincan/external/lib/release_x64/win/
cp ./out/Release_x64/obj/webrtc/system_wrappers/field_trial_default_cc.pdb ../../ipop-project/Tincan/external/lib/release_x64/win/
cp ./out/Release_x64/obj/third_party/jsoncpp/jsoncpp_cc.pdb ../../ipop-project/Tincan/external/lib/release_x64/win/
cp ./out/Release_x64/obj/webrtc/base/rtc_base_cc.pdb ../../ipop-project/Tincan/external/lib/release_x64/win/
cp ./out/Release_x64/obj/webrtc/base/rtc_base_approved_cc.pdb ../../ipop-project/Tincan/external/lib/release_x64/win/
cp ./out/Release_x64/obj/webrtc/p2p/rtc_p2p_cc.pdb ../../ipop-project/Tincan/external/lib/release_x64/win/
cp ./out/Release_x64/obj/third_party/protobuf/protobuf_full.lib ../../ipop-project/Tincan/external/lib/debug_x64/win/

Copy the header files for this branch-head

IPOP Website | IPOP Wiki

Clone this wiki locally