Merge "floss: Refactor build script and merge bootstrapping" am: 00dde7204e... (69b01bd1) · Commits · e / os / android_packages_modules_Bluetooth

README.md

+26 −17

Original line number	Diff line number	Diff line
		@@ -14,8 +14,9 @@ Instructions for a Debian based distribution:

		You'll want to download some pre-requisite packages as well. If you're currently
		configured for AOSP development, you should have most required packages.
		Otherwise, you can use the following apt-get list or use the bootstrap script
		(see below) to get a list of packages missing on your system:
		Otherwise, you can use the following apt-get list or use the `--run-bootstrap`
		option on `build.py` (see below) to get a list of packages missing on your
		system:

		```sh
		sudo apt-get install repo git-core gnupg flex bison gperf build-essential \
		@@ -27,7 +28,7 @@ sudo apt-get install repo git-core gnupg flex bison gperf build-essential \
		libflatbuffers-dev libtinyxml2-dev \
		libglib2.0-dev libevent-dev libnss3-dev libdbus-1-dev \
		libprotobuf-dev ninja-build generate-ninja protobuf-compiler \
		libre2-9
		libre2-9 debmake
		```

		You will also need a recent-ish version of Rust and Cargo. Please follow the
		@@ -41,18 +42,22 @@ cd ~/fluoride
		git clone https://android.googlesource.com/platform/packages/modules/Bluetooth/system
		```

		### Use bootstrap.py
		### Using --run-bootstrap on build.py

		`bootstrap.py` is a helper script provided to set up your build environment. It
		will set up your build staging directory and also make sure you have all
		required system packages to build (should work on Debian and Ubuntu). You will
		still need to build some unpackaged dependencies.
		`build.py` is the helper script used to build Fluoride for Linux (i.e. Floss).
		It accepts a `--run-bootstrap` option that will set up your build staging
		directory and also make sure you have all required system packages to build
		(should work on Debian and Ubuntu). You will still need to build some unpackaged
		dependencies (like libchrome, modp_b64, googletest, etc).

		To use it:
		```sh
		./bootstrap.py --base-dir=path/to/staging/dir --bt-dir=path/to/bt/dir
		./build.py --run-bootstrap
		```

		This will install your bootstrapped build environment to `~/.floss`. If you want
		to change this, just pass in `--bootstrap-dir` to the script.

		### Build dependencies

		The following third-party dependencies are necessary but currently unavailable
		@@ -104,7 +109,7 @@ done

		### Rust dependencies

		Note: Handled by bootstrap script.
		Note: Handled by `--run-bootstrap` option.

		Run the following to install Rust dependencies:
		```
		@@ -113,7 +118,7 @@ cargo install cxxbridge-cmd

		### Stage your build environment

		Note: Handled by bootstrap script.
		Note: Handled by `--run-bootstrap` option.

		For host build, we depend on a few other repositories:
		* [Platform2](https://chromium.googlesource.com/chromiumos/platform2/)
		@@ -135,17 +140,18 @@ ln -s $(readlink -f ${PROTO_LOG_DIR}) ${STAGING_DIR}/external/proto_logging

		We provide a build script to automate building assuming you've staged your build
		environment already as above. At this point, make sure you have all the
		pre-requisites installed (i.e. bootstrap script and other dependencies above) or
		pre-requisites installed (i.e. bootstrap option and other dependencies above) or
		you will see failures. In addition, you may need to set a `--libdir=` if your
		libraries are not stored in `/usr/lib64` by default.
		libraries are not stored in `/usr/lib` by default.


		```sh
		./build.py --output ${OUTPUT_DIR} --platform-dir ${STAGING_DIR} --clang
		./build.py
		```

		This will build all targets to the output directory you've given. You can also
		build each stage separately (if you want to iterate on something specific):
		This will build all targets to the output directory at `--bootstrap-dir` (which
		defaults to `~/.floss`). You can also build each stage separately (if you want
		to iterate on something specific):

		* prepare - Generate the GN rules
		* tools - Generate host tools
		@@ -157,7 +163,10 @@ build each stage separately (if you want to iterate on something specific):
		You can choose to run only a specific stage by passing an arg via `--target`.

		Currently, Rust builds are a separate stage that uses Cargo to build. See
		[gd/rust/README.md](gd/rust/README.md) for more information.
		[gd/rust/README.md](gd/rust/README.md) for more information. If you are
		iterating on Rust code and want to add new crates, you may also want to use the
		`--no-vendored-rust` option (which will let you use crates.io instead of using
		a pre-populated vendored crates repo).

		### Run

bootstrap.py

deleted100755 → 0

+0 −243

Original line number	Diff line number	Diff line
		#!/usr/bin/env python3

		# Copyright 2021 Google, Inc.
		#
		# Licensed under the Apache License, Version 2.0 (the "License");
		# you may not use this file except in compliance with the License.
		# You may obtain a copy of the License at:
		#
		# http://www.apache.org/licenses/LICENSE-2.0
		#
		# Unless required by applicable law or agreed to in writing, software
		# distributed under the License is distributed on an "AS IS" BASIS,
		# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
		# See the License for the specific language governing permissions and
		# limitations under the License.
		""" Bootstrap script to help set up Linux build. """

		import argparse
		import os
		import subprocess

		PLATFORM2_GIT = 'https://chromium.googlesource.com/chromiumos/platform2'
		RUST_CRATES_GIT = 'https://chromium.googlesource.com/chromiumos/third_party/rust_crates'
		PROTO_LOGGING_GIT = 'https://android.googlesource.com/platform/frameworks/proto_logging'

		# List of packages required for linux build
		REQUIRED_APT_PACKAGES = [
		'bison',
		'build-essential',
		'curl',
		'flatbuffers-compiler',
		'flex',
		'g++-multilib',
		'gcc-multilib',
		'generate-ninja',
		'gnupg',
		'gperf',
		'libc++-dev',
		'libdbus-1-dev',
		'libevent-dev',
		'libevent-dev',
		'libflatbuffers-dev',
		'libflatbuffers1',
		'libgl1-mesa-dev',
		'libglib2.0-dev',
		'liblz4-tool',
		'libncurses5',
		'libnss3-dev',
		'libprotobuf-dev',
		'libre2-9',
		'libssl-dev',
		'libtinyxml2-dev',
		'libx11-dev',
		'libxml2-utils',
		'ninja-build',
		'openssl',
		'protobuf-compiler',
		'unzip',
		'x11proto-core-dev',
		'xsltproc',
		'zip',
		'zlib1g-dev',
		]

		# List of cargo packages required for linux build
		REQUIRED_CARGO_PACKAGES = ['cxxbridge-cmd']

		APT_PKG_LIST = ['apt', '-qq', 'list']
		CARGO_PKG_LIST = ['cargo', 'install', '--list']


		class Bootstrap():

		def __init__(self, base_dir, bt_dir):
		""" Construct bootstrapper.

		Args:
		base_dir: Where to stage everything.
		bt_dir: Where bluetooth source is kept (will be symlinked)
		"""
		self.base_dir = os.path.abspath(base_dir)
		self.bt_dir = os.path.abspath(bt_dir)

		if not os.path.isdir(self.base_dir):
		raise Exception('{} is not a valid directory'.format(self.base_dir))

		if not os.path.isdir(self.bt_dir):
		raise Exception('{} is not a valid directory'.format(self.bt_dir))

		self.git_dir = os.path.join(self.base_dir, 'repos')
		self.staging_dir = os.path.join(self.base_dir, 'staging')
		self.output_dir = os.path.join(self.base_dir, 'output')
		self.external_dir = os.path.join(self.base_dir, 'staging', 'external')

		self.dir_setup_complete = os.path.join(self.base_dir, '.setup-complete')

		def _setup_platform2(self):
		""" Set up platform2.

		This will check out all the git repos and symlink everything correctly.
		"""

		# If already set up, exit early
		if os.path.isfile(self.dir_setup_complete):
		print('{} is already set-up'.format(self.base_dir))
		return

		# Create all directories we will need to use
		for dirpath in [self.git_dir, self.staging_dir, self.output_dir, self.external_dir]:
		os.makedirs(dirpath)

		# Check out all repos in git directory
		for repo in [PLATFORM2_GIT, RUST_CRATES_GIT, PROTO_LOGGING_GIT]:
		subprocess.check_call(['git', 'clone', repo], cwd=self.git_dir)

		# Symlink things
		symlinks = [
		(os.path.join(self.git_dir, 'platform2', 'common-mk'), os.path.join(self.staging_dir, 'common-mk')),
		(os.path.join(self.git_dir, 'platform2', '.gn'), os.path.join(self.staging_dir, '.gn')),
		(os.path.join(self.bt_dir), os.path.join(self.staging_dir, 'bt')),
		(os.path.join(self.git_dir, 'rust_crates'), os.path.join(self.external_dir, 'rust')),
		(os.path.join(self.git_dir, 'proto_logging'), os.path.join(self.external_dir, 'proto_logging')),
		]

		# Create symlinks
		for pairs in symlinks:
		(src, dst) = pairs
		os.symlink(src, dst)

		# Write to setup complete file so we don't repeat this step
		with open(self.dir_setup_complete, 'w') as f:
		f.write('Setup complete.')

		def _pretty_print_install(self, install_cmd, packages, line_limit=80):
		""" Pretty print an install command.

		Args:
		install_cmd: Prefixed install command.
		packages: Enumerate packages and append them to install command.
		line_limit: Number of characters per line.

		Return:
		Array of lines to join and print.
		"""
		install = [install_cmd]
		line = ' '
		# Remainder needed = space + len(pkg) + space + \
		# Assuming 80 character lines, that's 80 - 3 = 77
		line_limit = line_limit - 3
		for pkg in packages:
		if len(line) + len(pkg) < line_limit:
		line = '{}{} '.format(line, pkg)
		else:
		install.append(line)
		line = ' {} '.format(pkg)

		if len(line) > 0:
		install.append(line)

		return install

		def _check_package_installed(self, package, cmd, predicate):
		"""Check that the given package is installed.

		Args:
		package: Check that this package is installed.
		cmd: Command prefix to check if installed (package appended to end)
		predicate: Function/lambda to check if package is installed based
		on output. Takes string output and returns boolean.

		Return:
		True if package is installed.
		"""
		try:
		output = subprocess.check_output(cmd + [package], stderr=subprocess.STDOUT)
		is_installed = predicate(output.decode('utf-8'))
		print(' {} is {}'.format(package, 'installed' if is_installed else 'missing'))

		return is_installed
		except Exception as e:
		print(e)
		return False

		def _print_missing_packages(self):
		"""Print any missing packages found via apt.

		This will find any missing packages necessary for build using apt and
		print it out as an apt-get install printf.
		"""
		print('Checking for any missing packages...')
		need_packages = []
		for pkg in REQUIRED_APT_PACKAGES:
		if not self._check_package_installed(pkg, APT_PKG_LIST, lambda output: 'installed' in output):
		need_packages.append(pkg)

		# No packages need to be installed
		if len(need_packages) == 0:
		print('All required packages are installed')
		return

		install = self._pretty_print_install('sudo apt-get install', need_packages)

		# Print all lines so they can be run in cmdline
		print('Missing system packages. Run the following command: ')
		print(' \\\n'.join(install))

		def _print_missing_rust_packages(self):
		"""Print any missing packages found via cargo.

		This will find any missing packages necessary for build using cargo and
		print it out as a cargo-install printf.
		"""
		print('Checking for any missing cargo packages...')
		need_packages = []

		for pkg in REQUIRED_CARGO_PACKAGES:
		if not self._check_package_installed(pkg, CARGO_PKG_LIST, lambda output: pkg in output):
		need_packages.append(pkg)

		# No packages to be installed
		if len(need_packages) == 0:
		print('All required cargo packages are installed')
		return

		install = self._pretty_print_install('cargo install', need_packages)
		print('Missing cargo packages. Run the following command: ')
		print(' \\\n'.join(install))

		def bootstrap(self):
		""" Bootstrap the Linux build."""
		self._setup_platform2()
		self._print_missing_packages()
		self._print_missing_rust_packages()


		if __name__ == '__main__':
		parser = argparse.ArgumentParser(description='Bootstrap Linux build')
		parser.add_argument('--base-dir', help='Where to create build directories.', required=True)
		parser.add_argument('--bt-dir', help='Path to packages/modules/Bluetooth/system', required=True)

		args = parser.parse_args()
		bootstrap = Bootstrap(args.base_dir, args.bt_dir)
		bootstrap.bootstrap()

build.py

+298 −39

File changed.

Preview size limit exceeded, changes collapsed.