WebRTC 构建浏览器

Abstract	WebRTC Build Tools
Authors	Walter Fan
Status	WIP
Updated	2024-08-21

构建工具

首先需要安装 depot tools

git clone https://chromium.googlesource.com/chromium/tools/depot_tools.git
export PATH="$PATH:/path/to/depot_tools"
# if you install it on the home folder , do not use ~
export PATH="$PATH:${HOME}/depot_tools"

构建 Chrome

Mac 系统

https://chromium.googlesource.com/chromium/src/+/master/docs/mac_build_instructions.md

Mac 上需要运行

sudo xcode-select -s /Applications/Xcode.app/Contents/Developer

mkdir chromium && cd chromium
caffeinate fetch chromium
cd src
gclient runhooks
gn args out/Default
gn gen out/Default
autoninja -C out/Default chrome

其中, gn args out/Default 这一步中编辑如下的配置文件， 以回忆编译速度

# Set build arguments here. See `gn help buildargs`.
is_debug = false
dcheck_always_on = false
is_official_build = true

symbol_level=1
blink_symbol_level=0
v8_symbol_level=0

enable_nacl = false

proprietary_codecs = true
ffmpeg_branding = "Chrome"
chrome_pgo_phase = 0

启动时可以使用

/Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome --enable-logging --v=0 --vmodule=*/webrtc/*=1 --use-fake-device-for-media-stream --use-file-for-fake-video-capture=/Users/yafan/Downloads/FourPeople_1280x720_60.y4m

• 参见 https://support.google.com/chrome/a/answer/6271282?hl=zh-Hans&ref_topic=6314967#zippy=%2Cmac

• 日志文件位于 ~/Library/Application Support/Chromium/chrome_debug.log

Linux 系统

参见

• build_instructions

• debugging tips

git clone https://chromium.googlesource.com/chromium/tools/depot_tools.git
export PATH="$PATH:/home/ubuntu/depot_tools"
mkdir ~/chromium && cd ~/chromium
fetch --nohooks chromium
cd src
./build/install-build-deps.sh
gclient runhooks
gn args out/Default

gn gen out/Default

autoninja -C out/Default chrome

• 为了提高编译速度， 在 gn 的参数文件中填入如下编译参数

blink_symbol_level=0
dcheck_always_on = false
is_official_build = true

is_debug = false
enable_nacl = false

proprietary_codecs = true
ffmpeg_branding = "Chrome"

启动测试

cd /home/ubuntu/chromium/src/out/Default
./chrome --enable-logging --v=0 --vmodule=*/webrtc/*=1 \
--use-fake-device-for-media-stream \
--use-file-for-fake-video-capture=/home/ubuntu/reference_less_video_test_file.y4m

Log file 位于 ~/.config/chromium/chrome_debug.log

mkdir ~/chromium && cd ~/chromium
fetch --nohooks chromium
cd src
./build/install-build-deps.sh
gclient runhooks
gn args out/Default # make args.gn as below
gn gen out/Default
autoninja -C out/Default chrome

• out/default/args.gn

is_debug = false
dcheck_always_on = false
is_official_build = true

symbol_level=1
blink_symbol_level=0
v8_symbol_level=0

is_debug = false
enable_nacl = false

proprietary_codecs = true
ffmpeg_branding = "Chrome"

• 编译和执行相关的单元测试

autoninja -C out/Default unit_tests
out/Default/unit_tests --gtest_filter="PushClientTest.*"

Build Chrome on mac

Building Chrome on a Mac can be a complex process, but here are the basic steps you can follow:

1. Install Xcode: Before you start, make sure you have Xcode installed on your Mac. You can download Xcode from the App Store or from the Apple Developer website.

2. Install depot_tools: depot_tools is a set of tools that you’ll need to download the Chrome source code and manage the build process. You can install depot_tools by following these steps:

• Open Terminal and navigate to the folder where you want to install depot_tools.

• Run the following command: git clone https://chromium.googlesource.com/chromium/tools/depot_tools.git

• Add depot_tools to your PATH environment variable by running the following command: export PATH=$PATH:/path/to/depot_tools

3. Download the Chrome source code: Once you have depot_tools installed, you can download the Chrome source code by running the following command in Terminal: fetch –nohooks chromium

4. Install the build dependencies: Before you can build Chrome, you’ll need to install the build dependencies by running the following command in Terminal: cd chromium && ./build/install-build-deps.sh

5. Generate the build files: Once the build dependencies are installed, you can generate the build files by running the following command in Terminal: gn gen out/Default

6. Build Chrome: Finally, you can build Chrome by running the following command in Terminal: ninja -C out/Default chrome

The build process can take a long time, depending on your computer’s performance. Once the build is complete, you should have a fully functional version of Chrome that you built yourself.

构建 Firefox

1. Install Xcode: Before you start, make sure you have Xcode installed on your Mac. You can download Xcode from the App Store or from the Apple Developer website.

2. Install Mercurial: Mercurial is a version control system that you’ll need to download the Firefox source code. You can install Mercurial by running the following command in Terminal: brew install mercurial

brew install autoconf@2.13 mercurial ccache rustup-init gpg nodejs npm

3. Download the Firefox source code: Once you have Mercurial installed, you can download the Firefox source code by running the following command in Terminal:

hg clone https://hg.mozilla.org/mozilla-central

4. Install the build dependencies: Before you can build Firefox, you’ll need to install the build dependencies by running the following command in Terminal:

./mach bootstrap

5. Generate the build files: Once the build dependencies are installed, you can generate the build files by running the following command in Terminal:

./mach configure

6. Build Firefox: Finally, you can build Firefox by running the following command in Terminal:

./mach build

https://firefox-source-docs.mozilla.org/setup/macos_build.html