This directory contains files that make it possible for Linux
distributions to build Chromium using system libraries and exclude the
source code for Chromium's bundled copies of system libraries in a
consistent manner. Nothing here is used in normal developer builds.
For more info on the Linux distros' philosophy on bundling system
libraries and why this exists, please read the following:
- https://fedoraproject.org/wiki/Packaging:No_Bundled_Libraries
- https://wiki.gentoo.org/wiki/Why_not_bundle_dependencies
- http://www.debian.org/doc/debian-policy/ch-source.html#s-embeddedfiles
For more Chromium-specific context please read
http://spot.livejournal.com/312320.html .
Additional resources which might provide even more context:
- http://events.linuxfoundation.org/sites/events/files/slides/LinuxCon%202014%20Slides_0.pdf
- https://lwn.net/Articles/619158/
This directory is provided in the source tree so one can follow the
above guidelines without having to download additional tools and worry
about having the right version of the tool. It is a compromise solution
which takes into account Chromium developers who want to avoid the
perceived burden of more conditional code in build files, and
expectations of Open Source community, where using system-provided
libraries is the norm.
Usage:
1. remove_bundled_libraries.py <preserved-directories>
For example: remove_bundled_libraries.py third_party/mesa
The script scans sources looking for third_party directories.
Everything that is not explicitly preserved is removed (except for
GYP/GN build files), and the script fails if any directory passed on
command line does not exist (to ensure list is kept up to date).
This is intended to be used on source code extracted from a tarball,
not on a git repository.
NOTE: by default this will not remove anything (for safety). Pass
the --do-remove flag to actually remove files.
2. replace_gn_files.py --system-libraries lib...
This swaps out a normal library GN build file that is intended for
use with a bundled library for a build file that is set up to use
the system library. While some build files have use_system_libfoo
build flags, using unbundled build files has the advantage that Linux
distros can build Chromium without having to specify many additional
build flags.
For example: replace_gn_files.py --system-libraries libxml
25bc371334