Functions
	compile_fn (api, checkout_root, _ignore)

	copy_build_products (api, _ignore, dst)

Variables
str	DOCKER_IMAGE = 'gcr.io/skia-public/emsdk-base:3.1.26_v2'

str	INNER_BUILD_SCRIPT = '/SRC/skia/infra/pathkit/build_pathkit.sh'

list	PATHKIT_BUILD_PRODUCTS

Function Documentation

◆ compile_fn()

build.pathkit.compile_fn	(	api,
		checkout_root,
		_ignore
	)

Definition at line 8 of file pathkit.py.

def compile_fn(api, checkout_root, _ignore):
  out_dir = api.vars.cache_dir.join('docker', 'pathkit')
  configuration = api.vars.builder_cfg.get('configuration', '')
  target_arch   = api.vars.builder_cfg.get('target_arch',   '')
 
  # We want to make sure the directories exist and were created by chrome-bot,
  # because if that isn't the case, docker will make them and they will be
  # owned by root, which causes mysterious failures. To mitigate this risk
  # further, we don't use the same out_dir as everyone else (thus the _ignore)
  # param. Instead, we use a "pathkit" subdirectory in the "docker" named_cache.
  api.file.ensure_directory('mkdirs out_dir', out_dir, mode=0o777)
 
  # This uses the emscriptem sdk docker image and says "run the
  # build_pathkit.sh helper script in there". Additionally, it binds two
  # folders: the Skia checkout to /SRC and the output directory to /OUT
  # The called helper script will make the compile happen and put the
  # output in the right spot.  The neat thing is that since the Skia checkout
  # (and, by extension, the build script) is not a part of the image, but
  # bound in at runtime, we don't have to re-build the image, except when the
  # toolchain changes.
  # Of note, the wasm build doesn't re-use any intermediate steps from the
  # previous builds, so it's essentially a build from scratch every time.
  cmd = ['docker', 'run', '--rm', '--volume', '%s:/SRC' % checkout_root,
         '--volume', '%s:/OUT' % out_dir,
         DOCKER_IMAGE, INNER_BUILD_SCRIPT]
  if configuration == 'Debug':
    cmd.append('debug') # It defaults to Release
  if target_arch == 'asmjs':
    cmd.append('asm.js') # It defaults to WASM
  # Override DOCKER_CONFIG set by Kitchen.
  env = {'DOCKER_CONFIG': '/home/chrome-bot/.docker'}
  with api.env(env):
    api.run(
        api.step,
        'Build PathKit with Docker',
        cmd=cmd)
 
 

◆ copy_build_products()

build.pathkit.copy_build_products	(	api,
		_ignore,
		dst
	)

Definition at line 51 of file pathkit.py.

def copy_build_products(api, _ignore, dst):
  out_dir = api.vars.cache_dir.join('docker', 'pathkit')
  # We don't use the normal copy_listed_files because it uses
  # shutil.move, which attempts to delete the previous file, which
  # doesn't work because the docker created outputs are read-only and
  # owned by root (aka only docker images). It's likely safe to change
  # the shutil.move in the original script to a non-deleting thing
  # (like copy or copyfile), but there's some subtle behavior differences
  # especially with directories, that kjlubick felt it best not to risk it.
  script = api.build.resource('copy_build_products_no_delete.py')
  api.step(
      name='copy wasm output',
      cmd=['python3', script, out_dir, dst, ','.join(PATHKIT_BUILD_PRODUCTS)],
      infra_step=True)

Variable Documentation

◆ DOCKER_IMAGE

str build.pathkit.DOCKER_IMAGE = 'gcr.io/skia-public/emsdk-base:3.1.26_v2'

Definition at line 5 of file pathkit.py.

◆ INNER_BUILD_SCRIPT

str build.pathkit.INNER_BUILD_SCRIPT = '/SRC/skia/infra/pathkit/build_pathkit.sh'

Definition at line 6 of file pathkit.py.

◆ PATHKIT_BUILD_PRODUCTS

list build.pathkit.PATHKIT_BUILD_PRODUCTS

Initial value:

=  [
  'pathkit.*'
]

Definition at line 46 of file pathkit.py.

Functions