3 # Copyright (c) 2012 The Chromium Authors. All rights reserved.
4 # Use of this source code is governed by a BSD-style license that can be
5 # found in the LICENSE file.
7 # Script to install everything needed to build chromium (well, ideally, anyway)
8 # See http://code.google.com/p/chromium/wiki/LinuxBuildInstructions
9 # and http://code.google.com/p/chromium/wiki/LinuxBuild64Bit
12 echo "Usage: $0 [--options]"
14 echo "--[no-]syms: enable or disable installation of debugging symbols"
15 echo "--[no-]lib32: enable or disable installation of 32 bit libraries"
16 echo "--[no-]arm: enable or disable installation of arm cross toolchain"
17 echo "--[no-]chromeos-fonts: enable or disable installation of Chrome OS"\
19 echo "--no-prompt: silently select standard options/defaults"
20 echo "Script will prompt interactively if options not given."
24 # Checks whether a particular package is available in the repos.
25 # USAGE: $ package_exists <package name>
27 apt-cache pkgnames |
grep -x "$1" > /dev
/null
2>&1
33 --syms) do_inst_syms
=1;;
34 --no-syms) do_inst_syms
=0;;
35 --lib32) do_inst_lib32
=1;;
36 --no-lib32) do_inst_lib32
=0;;
37 --arm) do_inst_arm
=1;;
38 --no-arm) do_inst_arm
=0;;
39 --chromeos-fonts) do_inst_chromeos_fonts
=1;;
40 --no-chromeos-fonts) do_inst_chromeos_fonts
=0;;
41 --no-prompt) do_default
=1
42 do_quietly
="-qq --assume-yes"
44 --unsupported) do_unsupported
=1;;
50 ubuntu_versions
="10\.04|10\.10|11\.04|11\.10|12\.04|12\.10|13\.04"
51 ubuntu_codenames
="lucid|maverick|natty|oneiric|precise|quantal|raring"
52 ubuntu_issue
="Ubuntu ($ubuntu_versions|$ubuntu_codenames)"
53 # GCEL is an Ubuntu-derived VM image used on Google Compute Engine; /etc/issue
54 # doesn't contain a version number so just trust that the user knows what
58 if [ 0 -eq "${do_unsupported-0}" ] ; then
59 if ! egrep -q "($ubuntu_issue|$gcel_issue)" /etc
/issue
; then
60 echo "ERROR: Only Ubuntu 10.04 (lucid) through 13.04 (raring) are"\
61 "currently supported" >&2
65 if ! uname
-m |
egrep -q "i686|x86_64"; then
66 echo "Only x86 architectures are currently supported" >&2
71 if [ "x$(id -u)" != x0
]; then
72 echo "Running as non-root user."
73 echo "You might have to enter your password one or more times for 'sudo'."
77 # Packages needed for chromeos only
78 chromeos_dev_list
="libbluetooth-dev libbrlapi-dev"
80 # Packages need for development
81 dev_list
="apache2.2-bin bison curl elfutils fakeroot flex g++ gperf
82 language-pack-fr libapache2-mod-php5 libasound2-dev libbrlapi-dev
83 libbz2-dev libcairo2-dev libcups2-dev libcurl4-gnutls-dev libelf-dev
84 libgconf2-dev libgl1-mesa-dev libglib2.0-dev libglu1-mesa-dev
85 libgnome-keyring-dev libgtk2.0-dev libkrb5-dev libnspr4-dev
86 libnss3-dev libpam0g-dev libpci-dev libpulse-dev libsctp-dev
87 libspeechd-dev libsqlite3-dev libssl-dev libudev-dev libwww-perl
88 libxslt1-dev libxss-dev libxt-dev libxtst-dev mesa-common-dev
89 metacity patch perl php5-cgi pkg-config python python-cherrypy3
90 python-dev python-psutil rpm ruby subversion ttf-dejavu-core
91 ttf-indic-fonts ttf-kochi-gothic ttf-kochi-mincho ttf-thai-tlwg
95 # 64-bit systems need a minimum set of 32-bit compat packages for the pre-built
96 # NaCl binaries. These are always needed, regardless of whether or not we want
97 # the full 32-bit "cross-compile" support (--lib32).
98 if [ "$(uname -m)" = "x86_64" ]; then
99 dev_list
="${dev_list} libc6-i386 lib32gcc1 lib32stdc++6"
102 # Run-time libraries required by chromeos only
103 chromeos_lib_list
="libpulse0 libbz2-1.0 libcurl4-gnutls-dev"
105 # Full list of required run-time libraries
106 lib_list
="libatk1.0-0 libc6 libasound2 libcairo2 libcups2 libexpat1
107 libfontconfig1 libfreetype6 libglib2.0-0 libgnome-keyring0
108 libgtk2.0-0 libpam0g libpango1.0-0 libpci3 libpcre3 libpixman-1-0
109 libpng12-0 libspeechd2 libstdc++6 libsqlite3-0 libx11-6
110 libxau6 libxcb1 libxcomposite1 libxcursor1 libxdamage1 libxdmcp6
111 libxext6 libxfixes3 libxi6 libxinerama1 libxrandr2 libxrender1
112 libxtst6 zlib1g $chromeos_lib_list"
114 # Debugging symbols for all of the run-time libraries
115 dbg_list
="libatk1.0-dbg libc6-dbg libcairo2-dbg libfontconfig1-dbg
116 libglib2.0-0-dbg libgtk2.0-0-dbg libpango1.0-0-dbg libpcre3-dbg
117 libpixman-1-0-dbg libsqlite3-0-dbg libx11-6-dbg libxau6-dbg
118 libxcb1-dbg libxcomposite1-dbg libxcursor1-dbg libxdamage1-dbg
119 libxdmcp6-dbg libxext6-dbg libxfixes3-dbg libxi6-dbg libxinerama1-dbg
120 libxrandr2-dbg libxrender1-dbg libxtst6-dbg zlib1g-dbg"
122 # arm cross toolchain packages needed to build chrome on arm
123 arm_list
="libc6-armel-cross libc6-dev-armel-cross libgcc1-armel-cross
124 libgomp1-armel-cross linux-libc-dev-armel-cross
125 libgcc1-dbg-armel-cross libgomp1-dbg-armel-cross
126 binutils-arm-linux-gnueabi cpp-arm-linux-gnueabi
127 gcc-arm-linux-gnueabi g++-arm-linux-gnueabi
128 libmudflap0-dbg-armel-cross"
131 # Some package names have changed over time
132 if package_exists ttf-mscorefonts-installer
; then
133 dev_list
="${dev_list} ttf-mscorefonts-installer"
135 dev_list
="${dev_list} msttcorefonts"
137 if package_exists libnspr4-dbg
; then
138 dbg_list
="${dbg_list} libnspr4-dbg libnss3-dbg"
139 lib_list
="${lib_list} libnspr4 libnss3"
141 dbg_list
="${dbg_list} libnspr4-0d-dbg libnss3-1d-dbg"
142 lib_list
="${lib_list} libnspr4-0d libnss3-1d"
144 if package_exists libjpeg-dev
; then
145 dev_list
="${dev_list} libjpeg-dev"
147 dev_list
="${dev_list} libjpeg62-dev"
149 if package_exists libudev1
; then
150 dev_list
="${dev_list} libudev1"
152 dev_list
="${dev_list} libudev0"
154 if package_exists libbrlapi0.6
; then
155 dev_list
="${dev_list} libbrlapi0.6"
157 dev_list
="${dev_list} libbrlapi0.5"
161 # Some packages are only needed, if the distribution actually supports
163 if package_exists appmenu-gtk
; then
164 lib_list
="$lib_list appmenu-gtk"
167 # Waits for the user to press 'Y' or 'N'. Either uppercase of lowercase is
168 # accepted. Returns 0 for 'Y' and 1 for 'N'. If an optional parameter has
169 # been provided to yes_no(), the function also accepts RETURN as a user input.
170 # The parameter specifies the exit code that should be returned in that case.
171 # The function will echo the user's selection followed by a newline character.
172 # Users can abort the function by pressing CTRL-C. This will call "exit 1".
174 if [ 0 -ne "${do_default-0}" ] ; then
179 c
="$(trap 'stty echo -iuclc icanon 2>/dev/null' EXIT INT TERM QUIT
180 stty -echo iuclc -icanon 2>/dev/null
181 dd count=1 bs=1 2>/dev/null | od -An -tx1)"
183 " 0a") if [ -n "$1" ]; then
184 [ $1 -eq 0 ] && echo "Y" ||
echo "N"
194 "") echo "Aborted" >&2
197 *) # The user pressed an unrecognized key. As we are not echoing
198 # any incorrect user input, alert the user by ringing the bell.
199 (tput bel
) 2>/dev
/null
205 if test "$do_inst_syms" = ""
207 echo "This script installs all tools and libraries needed to build Chromium."
209 echo "For most of the libraries, it can also install debugging symbols, which"
210 echo "will allow you to debug code in the system libraries. Most developers"
211 echo "won't need these symbols."
212 echo -n "Do you want me to install them for you (y/N) "
217 if test "$do_inst_syms" = "1"; then
218 echo "Installing debugging symbols."
220 echo "Skipping installation of debugging symbols."
224 # When cross building for arm on 64-bit systems the host binaries
225 # that are part of v8 need to be compiled with -m32 which means
226 # that basic multilib support is needed.
227 if [ "$(uname -m)" = "x86_64" ]; then
228 arm_list
="$arm_list g++-multilib"
231 if test "$do_inst_arm" = "1"; then
233 if test "$DISTRIB_CODENAME" != "precise"; then
234 echo "ERROR: Installing the ARM cross toolchain is only available on" \
235 "Ubuntu precise." >&2
238 echo "Installing ARM cross toolchain."
240 echo "Skipping installation of ARM cross toolchain."
246 # We initially run "apt-get" with the --reinstall option and parse its output.
247 # This way, we can find all the packages that need to be newly installed
248 # without accidentally promoting any packages from "auto" to "manual".
249 # We then re-run "apt-get" with just the list of missing packages.
250 echo "Finding missing packages..."
251 packages
="${dev_list} ${lib_list} ${dbg_list} ${arm_list}"
252 # Intentionally leaving $packages unquoted so it's more readable.
253 echo "Packages required: " $packages
255 new_list_cmd
="sudo apt-get install --reinstall $(echo $packages)"
256 if new_list
="$(yes n | LANGUAGE=en LANG=C $new_list_cmd)"; then
257 # We probably never hit this following line.
258 echo "No missing packages, and the packages are up-to-date."
259 elif [ $?
-eq 1 ]; then
260 # We expect apt-get to have exit status of 1.
261 # This indicates that we cancelled the install with "yes n|".
262 new_list
=$
(echo "$new_list" |
263 sed -e '1,/The following NEW packages will be installed:/d;s/^ //;t;d')
264 new_list
=$
(echo "$new_list" |
sed 's/ *$//')
265 if [ -z "$new_list" ] ; then
266 echo "No missing packages, and the packages are up-to-date."
268 echo "Installing missing packages: $new_list."
269 sudo apt-get
install ${do_quietly-} ${new_list}
273 # An apt-get exit status of 100 indicates that a real error has occurred.
275 # I am intentionally leaving out the '"'s around new_list_cmd,
276 # as this makes it easier to cut and paste the output
277 echo "The following command failed: " ${new_list_cmd}
279 echo "It produces the following output:"
280 yes n |
$new_list_cmd || true
282 echo "You will have to install the above packages yourself."
287 # Install the Chrome OS default fonts. This must go after running
288 # apt-get, since install-chromeos-fonts depends on curl.
289 if test "$do_inst_chromeos_fonts" != "0"; then
291 echo "Installing Chrome OS fonts."
292 dir
=`echo $0 | sed -r -e 's/\/[^/]+$//'`
293 if ! sudo
$dir/linux
/install-chromeos-fonts.py
; then
294 echo "ERROR: The installation of the Chrome OS default fonts failed."
295 if [ `stat -f -c %T $dir` == "nfs" ]; then
296 echo "The reason is that your repo is installed on a remote file system."
298 echo "This is expected if your repo is installed on a remote file system."
300 echo "It is recommended to install your repo on a local file system."
301 echo "You can skip the installation of the Chrome OS default founts with"
302 echo "the command line option: --no-chromeos-fonts."
306 echo "Skipping installation of Chrome OS fonts."
309 # Install 32bit backwards compatibility support for 64bit systems
310 if [ "$(uname -m)" = "x86_64" ]; then
311 if test "$do_inst_lib32" != "1"
313 echo "NOTE: If you were expecting the option to install 32bit libs,"
314 echo "please run with the --lib32 flag."
316 echo "Installation complete."
319 # This conditional statement has been added to deprecate and eventually
320 # remove support for 32bit libraries on 64bit systems. But for the time
321 # being, we still have to support a few legacy systems (e.g. bots), where
322 # this feature is needed.
323 # We only even give the user the option to install these libraries, if
324 # they explicitly requested doing so by setting the --lib32 command line
326 # And even then, we interactively ask them one more time whether they are
328 # In order for that to work, we must reset the ${do_inst_lib32} variable.
329 # There are other ways to achieve the same goal. But resetting the
330 # variable is the best way to document the intended behavior -- and to
331 # allow us to gradually deprecate and then remove the obsolete code.
337 echo "We no longer recommend that you use this script to install"
338 echo "32bit libraries on a 64bit system. Instead, consider using the"
339 echo "install-chroot.sh script to help you set up a 32bit environment"
340 echo "for building and testing 32bit versions of Chrome."
342 echo "The code for installing 32bit libraries on a 64bit system is"
343 echo "unmaintained and might not work with modern versions of Ubuntu"
346 echo -n "Are you sure you want to proceed (y/N) "
350 if test "$do_inst_lib32" != "1"
355 # Standard 32bit compatibility libraries
356 echo "First, installing the limited existing 32-bit support..."
357 cmp_list
="ia32-libs lib32asound2-dev lib32stdc++6 lib32z1
358 lib32z1-dev libc6-dev-i386 libc6-i386 g++-multilib"
359 if [ -n "`apt-cache search lib32readline-gplv2-dev 2>/dev/null`" ]; then
360 cmp_list
="${cmp_list} lib32readline-gplv2-dev"
362 cmp_list
="${cmp_list} lib32readline5-dev"
364 sudo apt-get
install ${do_quietly-} $cmp_list
366 tmp
=/tmp
/install-32bit.$$
367 trap 'rm -rf "${tmp}"' EXIT INT TERM QUIT
368 mkdir
-p "${tmp}/apt/lists/partial" "${tmp}/cache" "${tmp}/partial"
369 touch "${tmp}/status"
371 [ -r /etc
/apt
/apt.conf
] && cp /etc
/apt
/apt.conf
"${tmp}/apt/"
372 cat >>"${tmp}/apt/apt.conf" <<EOF
373 Apt::Architecture "i386";
374 Dir::Cache "${tmp}/cache";
375 Dir::Cache::Archives "${tmp}/";
376 Dir::State::Lists "${tmp}/apt/lists/";
377 Dir::State::status "${tmp}/status";
380 # Download 32bit packages
381 echo "Computing list of available 32bit packages..."
382 sudo apt-get
-c="${tmp}/apt/apt.conf" update
384 echo "Downloading available 32bit packages..."
385 sudo apt-get
-c="${tmp}/apt/apt.conf" \
386 --yes --download-only --force-yes --reinstall install \
387 ${lib_list} ${dbg_list}
389 # Open packages, remove everything that is not a library, move the
390 # library to a lib32 directory and package everything as a *.deb file.
391 echo "Repackaging and installing 32bit packages for use on 64bit systems..."
392 for i
in ${lib_list} ${dbg_list}; do
393 orig
="$(echo "${tmp}/${i}"_*_i386.deb)"
394 compat
="$(echo "${orig}" |
395 sed -e 's,\(_[^_/]*_\)i386\(.deb\),-ia32\1amd64\2,')"
396 rm -rf "${tmp}/staging"
397 msg
="$(fakeroot -u sh -exc '
398 # Unpack 32bit Debian archive
400 mkdir -p "'"${tmp}"'/staging
/dpkg
/DEBIAN
"
401 cd "'"${tmp}"'/staging
"
403 tar Cfx dpkg data.tar*
404 tar zCfx dpkg/DEBIAN control.tar.gz
406 # Create a posix extended regular expression fragment that will
407 # recognize the includes which have changed. Should be rare,
408 # will almost always be empty.
409 includes=`sed -n -e "s
/^
[0-9a-z]* //g
" \
410 -e "\
,usr
/include
/,p
" dpkg/DEBIAN/md5sums |
411 xargs -n 1 -I FILE /bin/sh -c \
412 "cmp -s dpkg
/FILE
/FILE ||
echo FILE
" |
416 # If empty, set it to not match anything.
417 test -z "$includes" && includes="^
//"
419 # Turn the conflicts into an extended RE for removal from the
421 conflicts=`sed -n -e "/Conflicts
/s
/Conflicts
: *//;T
;s
/, */|
/g
;p
" \
424 # Rename package, change architecture, remove conflicts and dependencies
426 -e "/Package
/s
/$
/-ia32/" \
427 -e "/Architecture
/s
/:.
*$
/: amd64
/" \
428 -e "/Depends
/s
/:.
*/: ia32-libs
/" \
429 -e "/Provides
/s
/($conflicts)(, *)?
//g
;T1
;s
/, *$
//;:1" \
434 # Only keep files that live in "lib
" directories or the includes
437 -e "/\
/lib64\
//d
" -e "/\
/.?bin\
//d
" \
438 -e "\
,$includes,s
,[ /]include
/,&32/,g
;s
,include
/32/,include32
/,g
" \
439 -e "s
, lib
/, lib32
/,g
" \
440 -e "s
,/lib
/,/lib32
/,g
" \
442 -e "\
,^
/usr
/lib32
/debug\
(.
*/lib32\
),s
,^
/usr
/lib32
/debug
,/usr
/lib
/debug
," \
445 # Re-run ldconfig after installation/removal
446 { echo "#!/bin/sh"; echo "[ \"x\$1\" = xconfigure ]&&ldconfig||:"; } \
447 >dpkg
/DEBIAN
/postinst
448 { echo "#!/bin/sh"; echo "[ \"x\$1\" = xremove ]&&ldconfig||:"; } \
450 chmod 755 dpkg
/DEBIAN
/postinst dpkg
/DEBIAN
/postrm
452 # Remove any other control files
453 find dpkg
/DEBIAN
-mindepth 1 "(" -name control
-o -name md5sums
-o \
454 -name postinst
-o -name postrm
")" -o -print |
457 # Remove any files/dirs that live outside of "lib" directories,
458 # or are not in our list of changed includes.
459 find dpkg
-mindepth 1 -regextype posix-extended \
460 "(" -name DEBIAN
-o -name lib
-o -regex "dpkg/($includes)" ")" \
461 -prune -o -print |
tac |
462 xargs -r -n 1 sh
-c "rm \$0 2>/dev/null || rmdir \$0 2>/dev/null || : "
463 find dpkg
-name lib64
-o -name bin
-o -name "?bin" |
464 tac |
xargs -r rm -rf
466 # Remove any symbolic links that were broken by the above steps.
467 find -L dpkg
-type l
-print |
tac |
xargs -r rm -rf
469 # Rename lib to lib32, but keep debug symbols in /usr/lib/debug/usr/lib32
470 # That is where gdb looks for them.
471 find dpkg
-type d
-o -path "*/lib/*" -print |
472 xargs -r -n 1 sh
-c "
473 i=\$(echo \"\${0}\" |
474 sed -e s,/lib/,/lib32/,g \
475 -e s,/usr/lib32/debug\\\\\(.*/lib32\\\\\),/usr/lib/debug\\\\1,);
476 mkdir -p \"\${i%/*}\";
477 mv \"\${0}\" \"\${i}\""
479 # Rename include to include32.
480 [ -d "dpkg/usr/include" ] && mv "dpkg/usr/include" "dpkg/usr/include32"
482 # Prune any empty directories
483 find dpkg
-type d |
tac |
xargs -r -n 1 rmdir 2>/dev
/null ||
:
485 # Create our own Debian package
487 dpkg
--build staging
/dpkg .
' 2>&1)"
488 compat="$(eval echo $(echo "${compat}" |
489 sed -e 's
,_
[^_
/]*_amd64.deb
,_
*_amd64.deb
,'))"
490 [ -r "${compat}" ] || {
492 echo "Failed to build new Debian archive!" >&2
496 msg="$(sudo dpkg -i "${compat}" 2>&1)" && {
497 echo "Installed ${compat##*/}"
500 echo "Skipped ${compat##*/}"
504 # Add symbolic links for developing 32bit code
505 echo "Adding missing symbolic links, enabling 32bit code development..."
506 for i in $(find /lib32 /usr/lib32 -maxdepth 1 -name \*.so.\* |
507 sed -e 's
/[.
]so
[.
][0-9].
*/.so
/' |
509 [ "x${i##*/}" = "xld-linux.so" ] && continue
510 [ -r "$i" ] && continue
511 j="$(ls "$i."* | sed -e 's
/.
*[.
]so
[.
]\
([^.
]*\
)$
/\
1/;t
;d
' |
512 sort -n | tail -n 1)"
513 [ -r "$i.$j" ] || continue
514 sudo ln -s "${i##*/}.$j" "$i"