summaryrefslogtreecommitdiffstats
path: root/third_party/libwebrtc/docs/native-code/development/prerequisite-sw/index.md
diff options
context:
space:
mode:
Diffstat (limited to 'third_party/libwebrtc/docs/native-code/development/prerequisite-sw/index.md')
-rw-r--r--third_party/libwebrtc/docs/native-code/development/prerequisite-sw/index.md65
1 files changed, 65 insertions, 0 deletions
diff --git a/third_party/libwebrtc/docs/native-code/development/prerequisite-sw/index.md b/third_party/libwebrtc/docs/native-code/development/prerequisite-sw/index.md
new file mode 100644
index 0000000000..810c87943a
--- /dev/null
+++ b/third_party/libwebrtc/docs/native-code/development/prerequisite-sw/index.md
@@ -0,0 +1,65 @@
+# WebRTC development - Prerequisite software
+
+## Depot Tools
+
+1. [Install the Chromium depot tools][depot-tools].
+
+2. On Windows, depot tools will download a special version of Git during your
+first `gclient sync`. On Mac and Linux, you'll need to install [Git][git] by
+yourself.
+
+## Linux (Ubuntu/Debian)
+
+A script is provided for Ubuntu, which is unfortunately only available after
+your first gclient sync:
+
+```
+$ ./build/install-build-deps.sh
+```
+
+Most of the libraries installed with this script are not needed since we now
+build using Debian sysroot images in build/linux, but there are still some tools
+needed for the build that are installed with
+[install-build-deps.sh][install-build-deps].
+
+You may also want to have a look at the [Chromium Linux Build
+instructions][chromium-linux-build-instructions] if you experience any other problems building.
+
+## Windows
+
+Follow the [Chromium's build instructions for Windows][chromium-win-build-instructions].
+
+WebRTC requires Visual Studio 2017 to be used. If you only have version 2015
+available, you might be able to keep using it for some time by setting
+`GYP_MSVS_VERSION=2015` in your environment. Keep in mind that this is not a
+suppported configuration however.
+
+## macOS
+
+Xcode 12 or higher is required. Latest Xcode is recommended to be able to build
+all code. You may use `xcode-select --install` to install it.
+
+Absence of Xcode will cause errors like:
+```
+xcrun: error: invalid active developer path (/Library/Developer/CommandLineTools), missing xcrun at: /Library/Developer/CommandLineTools/usr/bin/xcrun
+```
+
+## Android
+
+You'll need a Linux development machine. WebRTC is using the same Android
+toolchain as Chrome (downloaded into `third_party/android_tools`) so you won't
+need to install the NDK/SDK separately.
+
+1. Install Java OpenJDK as described in the
+[Chromium Android prerequisites][chromium-android-build-build-instructions]
+2. All set! If you don't run Ubuntu, you may want to have a look at
+[Chromium's Linux prerequisites][chromium-linux-prerequisites] for distro-specific details.
+
+
+[depot-tools]: https://commondatastorage.googleapis.com/chrome-infra-docs/flat/depot_tools/docs/html/depot_tools_tutorial.html#_setting_up
+[git]: http://git-scm.com
+[install-build-deps]: https://cs.chromium.org/chromium/src/build/install-build-deps.sh
+[chromium-linux-build-instructions]: https://chromium.googlesource.com/chromium/src/+/main/docs/linux/build_instructions.md
+[chromium-win-build-instructions]: https://chromium.googlesource.com/chromium/src/+/main/docs/windows_build_instructions.md
+[chromium-linux-prerequisites]: https://chromium.googlesource.com/chromium/src/+/main/docs/linux/build_instructions.md#notes
+[chromium-android-build-build-instructions]: https://chromium.googlesource.com/chromium/src/+/main/docs/android_build_instructions.md