当前位置：首页 > news >正文

使用 Visual Studio 2019 修改 WebRTC 源码

news 来源：原创 2025/6/13 7:25:53

要使用 Visual Studio 2019 修改 WebRTC 源码，你可以按照以下步骤来完成编译、调试与修改流程。WebRTC 是一个使用 GN 和 Ninja 构建系统的大型 C++ 项目，整个流程略微复杂。下面是完整指南：

✅ 一、准备环境

1. 安装 Visual Studio 2019

安装以下组件：

Desktop development with C++
C++ CMake tools（可选）
Windows 10 SDK（版本 >= 10.0.18362）

2. 安装 Git 和 Python

Git: Git
Python 3.8+（推荐使用 64 位）

3. 安装 Chromium 的 depot_tools（WebRTC 使用它管理代码）

git clone https://chromium.googlesource.com/chromium/tools/depot_tools.git

然后将 depot_tools 目录添加到系统环境变量 PATH 中。

✅ 二、获取 WebRTC 源码

1. 创建工作目录并获取源码

mkdir webrtc-checkout
cd webrtc-checkout
fetch --nohooks webrtc
cd src

第一次运行 fetch 会花较长时间下载依赖。

2. 同步依赖项

gclient sync

✅ 三、配置构建参数（适配 VS2019）

gn gen out/Default --ide=vs2019

你可以修改默认的构建参数：

gn args out/Default

示例参数（args.gn 文件内容）：

is_debug = true
target_os = "win"
target_cpu = "x64"
is_clang = false
use_rtti = true

is_clang = false 表示使用 VS2019 的 MSVC 编译器。

args.gn 文件不是默认就存在的，而是在你运行以下命令时手动创建或编辑的。

可以在命令行直接设置构建参数，而不写 args.gn 文件，这是 GN 官方支持的做法。语法：

gn gen out/目录 --args='参数1=值1 参数2=值2 ...'

例如：

gn gen out/Win --args='is_debug=true target_os="win" target_cpu="x64" is_clang=false'

核心常用构建参数（通用）

参数	含义
`is_debug`	是否构建为 Debug 模式（默认 `true`）
`target_os`	目标操作系统，如 `"win"`, `"android"`, `"ios"`, `"linux"`, `"mac"`
`target_cpu`	目标 CPU 架构，如 `"x64"`, `"x86"`, `"arm"`, `"arm64"`
`is_clang`	是否使用 Clang 编译器（Windows 默认 `true`，可设为 `false` 用 MSVC）
`use_lld`	是否使用 LLVM 的 LLD 链接器（适用于 Clang）
`symbol_level`	符号信息级别（0 = 无调试符号，1 = 减少信息，2 = 完整）
`use_rtti`	是否启用 C++ RTTI（Run-Time Type Info），默认 `false`
`use_custom_libcxx`	是否使用自定义 libc++，默认 `true`（如你用系统 libc++ 可设为 `false`）

WebRTC 项目专有参数

参数	含义
`rtc_include_tests`	是否编译测试代码（如 unit tests），默认 `true`
`rtc_build_tools`	是否构建 WebRTC 工具程序（如 `peerconnection_server`）
`rtc_use_h264`	是否启用 H.264 支持（通常用于 Android/iOS）
`rtc_build_examples`	是否构建官方示例程序（如 `peerconnection_client`）
`rtc_enable_protobuf`	启用 protobuf 支持（部分功能依赖）
`rtc_enable_android_aar`	构建为 Android AAR 包（仅 Android）
`rtc_include_ilbc`	是否包含 iLBC 编解码器
`rtc_include_opus`	是否包含 Opus 编解码器
`rtc_include_internal_audio_device`	是否使用内置音频采集模块
`rtc_use_x11`	是否启用 X11（Linux）
`rtc_enable_sctp`	启用数据通道用的 SCTP 支持
`rtc_enable_peer_connection`	启用 PeerConnection 模块（大部分人都要设为 `true`）
`rtc_enable_video`	启用视频模块
`rtc_enable_audio`	启用音频模块

iOS/Android 专用参数

iOS：

参数	含义
`ios_enable_code_signing`	是否启用代码签名（默认 `true`，CI 构建时应设为 `false`）
`enable_ios_bitcode`	启用 Bitcode
`ios_deployment_target`	最低支持版本（如 `"12.0"`）

Android：

参数	含义
`android_ndk_root`	指定 Android NDK 路径
`android_sdk_root`	指定 Android SDK 路径
`android_deploy_target`	最低 Android API 版本
`rtc_enable_android_aar`	构建成 `.aar` 文件
`use_jdk_jar`	使用本地 JDK 的 jar 工具

查看所有可用参数

如果你想列出当前项目支持的全部 GN 参数，可以在 src 目录下运行：

gn args out/Default --list

你会看到所有参数及默认值、注释说明。

✅ 四、用 Visual Studio 2019 打开项目

运行完 gn gen 后，会生成 all.sln 解决方案文件：

out\Default\all.sln

你可以直接用 VS2019 打开它，进行源码浏览、修改和调试。

✅ 五、构建和运行

WebRTC 使用 Ninja 构建系统。你不能直接用 Visual Studio 编译，需要用命令行构建：

ninja -C out/Default

但你可以：

用 VS2019 编辑代码
设置断点，调试 test 或你自己的 main() 程序
用 ninja 编译后，用 VS2019 调试编译好的 .exe

多平台构建流程（多构建目录）

你可以针对不同平台建立多个构建输出目录：

📦 Windows 编译目录：

gn gen out/Win --args='target_os="win" target_cpu="x64" is_clang=false'

📦 Android 编译目录：

gn gen out/Android --args='target_os="android" target_cpu="arm64" is_debug=false'

（前提是你已经安装 Android NDK，并设置环境变量）

📦 iOS 编译目录（macOS 上）：

gn gen out/iOS --args='target_os="ios" target_cpu="arm64" ios_enable_code_signing=false'

编译命令示例

ninja -C out/Win ninja -C out/Android ninja -C out/iOS

注意事项

平台	额外要求
Android	需要安装 Android NDK、配置 JAVA_HOME、ANDROID_HOME
iOS	只能在 macOS 上编译，需安装 Xcode 和 iOS SDK
Windows	可用 MSVC 或 Clang 编译，但 MSVC 支持更好

✅ 六、修改源码的建议

WebRTC 的源码结构很复杂，修改前建议你：

找入口：如 api/peer_connection/, modules/video_coding/, p2p/, media/
查找调用路径：可用 CTRL+T 或 右键 -> 查找所有引用
添加调试输出：推荐使用 RTC_LOG(LS_INFO) << "Log message";

例如：

#include "rtc_base/logging.h"
RTC_LOG(LS_INFO) << "My custom log";

日志默认输出到标准输出，也可以配置到文件。

✅ 七、参考工具

Ninja 官网
GN 官网
WebRTC Git 仓库
WebRTC 编译 Wiki：https://webrtc.googlesource.com/src/+/refs/heads/main/docs/native-code/development/

✅修改与更新合并

推荐方式 —— Git 分支管理

在 WebRTC 主仓库目录（通常是 src/）中切换到新分支：
```
cd src/ git checkout -b my_feature_branch 
```

修改你想改的文件，比如：

vim modules/audio_processing/echo_cancellation.cc

提交你的修改：

git add . git commit -m "My custom changes"

当官方更新发布后，更新 remote 并合并：
```
git fetch origin git rebase origin/main 
```
或者如果你不想用 rebase，可以：
```
git merge origin/main 
```
如果有冲突，Git 会提示你解决冲突。解决后继续 rebase 或 commit。