https://github.com/sourcey/webrtc-builds
Automated WebRTC build scripts for Linux, Windows, Mac, Android and iOS.
https://github.com/sourcey/webrtc-builds
Last synced: 10 months ago
JSON representation
Automated WebRTC build scripts for Linux, Windows, Mac, Android and iOS.
- Host: GitHub
- URL: https://github.com/sourcey/webrtc-builds
- Owner: sourcey
- License: bsd-3-clause
- Fork: true (vsimon/webrtcbuilds)
- Created: 2016-09-23T18:09:46.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2019-12-30T14:47:56.000Z (over 6 years ago)
- Last Synced: 2024-08-13T03:07:15.667Z (almost 2 years ago)
- Language: Shell
- Homepage: https://sourcey.com/precompiled-webrtc-libraries/
- Size: 117 MB
- Stars: 154
- Watchers: 16
- Forks: 73
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# WebRTC Automated Builds
[](https://circleci.com/gh/sourcey/webrtc-builds)
These cross platform build scripts automate the hard work of building and packaging WebRTC. Big thanks to @vsimon for laying the foundation for these scripts.
## Supported platforms
* **OSX**: [Homebrew](http://brew.sh/) recommend. Build for 'mac' and 'ios'.
* **Windows**: Visual Studio Community 2015 Update 3 or newer
with a bash shell such as [Git for Windows](https://msysgit.github.io) or [MSYS](http://www.mingw.org/wiki/msys)
installed.
* **Linux**: Debian or Ubuntu flavour with `apt-get` available. Build for 'linux' and 'android'.
## Usage
To build the latest version of WebRTC just type:
```
# Build latest WebRTC for current platform:
./build.sh
# To compile a specific branch with both x64 and x86 libraries you would run:
./build.sh -c x64 -b branch-heads/66
./build.sh -c x86 -b branch-heads/66 -x
# To cross compile both x64 and x86 libraries for iOS you would run (on MacOS):
./build.sh -c x64 -t ios
./build.sh -c x86 -t ios -x
```
Or with options:
```
Usage:
$0 [OPTIONS]
WebRTC automated build script.
OPTIONS:
-o OUTDIR Output directory. Default is 'out'
-b BRANCH Latest revision on git branch. Overrides -r. Common branch names are 'branch-heads/nn', where 'nn' is the release number.
-r REVISION Git SHA revision. Default is latest revision.
-t TARGET OS The target os for cross-compilation. Default is the host OS such as 'linux', 'mac', 'win'. Other values can be 'android', 'ios'.
-c TARGET CPU The target cpu for cross-compilation. Default is 'x64'. Other values can be 'x86', 'arm64', 'arm'.
-l BLACKLIST List *.o objects to exclude from the static library.
-e Compile WebRTC with RTII enabled.
-f Build only mode. Skip repo sync and dependency checks, just build, compile and package.
-d Debug mode. Print all executed commands.
-h Show this message
EOF
```
The output packages will be saved to `{OUTDIR}/webrtcbuilds----.`, where `` is the revision number of the commit, `` is the short git SHA
of the commit, and `-` is the OS (linux, mac, win) and CPU (x64, x86) of the target environment.
On Windows `7-Zip` is used for compressing packages, which produces vastly superiour output file size. On mac and linux the output file is `tar.gz`.
## Running tests
Once you have compiled the libraries you can run a quick compile test to ensure build integrity:
```
./test/run_tests.sh out/webrtc-17657-02ba69d-linux-x64
```
## Further reading
The following links point to official WebRTC related documentation:
* [https://webrtc.org/native-code/development/](https://webrtc.org/native-code/development/)
* [https://webrtc.org/native-code/development/prerequisite-sw/](https://webrtc.org/native-code/development/prerequisite-sw/)
* [http://dev.chromium.org/developers/how-tos/install-depot-tools](http://dev.chromium.org/developers/how-tos/install-depot-tools)
* [https://chromium.googlesource.com/chromium/src/+/master/docs/windows_build_instructions.md](https://chromium.googlesource.com/chromium/src/+/master/docs/windows_build_instructions.md)
* [https://chromium.googlesource.com/chromium/src/+/master/tools/gn/docs/quick_start.md](https://chromium.googlesource.com/chromium/src/+/master/tools/gn/docs/quick_start.md)