Moving build_aar.py to new location

webrtc/build/android/build_aar.py

-#!/usr/bin/env python
-
-# Copyright (c) 2017 The WebRTC project authors. All Rights Reserved.
-#
-# Use of this source code is governed by a BSD-style license
-# that can be found in the LICENSE file in the root of the source
-# tree. An additional intellectual property rights grant can be found
-# in the file PATENTS.  All contributing project authors may
-# be found in the AUTHORS file in the root of the source tree.
-
-"""Script to generate libwebrtc.aar for distribution.
-
-The script has to be run from the root src folder.
-./webrtc/build/android/build_aar.py
-
-.aar-file is just a zip-archive containing the files of the library. The file
-structure generated by this script looks like this:
- - AndroidManifest.xml
- - classes.jar
- - libs/
-   - armeabi-v7a/
-     - libjingle_peerconnection_so.so
-   - x86/
-     - libjingle_peerconnection_so.so
-"""
-
-import argparse
-import logging
-import os
-import shutil
-import subprocess
-import sys
-import tempfile
-import zipfile
-
-
-DEFAULT_ARCHS = ['armeabi-v7a', 'x86']
-NEEDED_SO_FILES = ['libjingle_peerconnection_so.so']
-JAR_FILE = 'lib.java/webrtc/sdk/android/libwebrtc.jar'
-MANIFEST_FILE = 'webrtc/sdk/android/AndroidManifest.xml'
-TARGETS = [
-  'webrtc/sdk/android:libwebrtc',
-  'webrtc/sdk/android:libjingle_peerconnection_so',
-]
-
-
-def _ParseArgs():
-  parser = argparse.ArgumentParser(description='libwebrtc.aar generator.')
-  parser.add_argument('--output', default='libwebrtc.aar',
-      help='Output file of the script.')
-  parser.add_argument('--arch', action='append', default=[],
-      help='Architectures to build. Defaults to ' + str(DEFAULT_ARCHS))
-  parser.add_argument('--use-goma', action='store_true', default=False,
-      help='Use goma.')
-  parser.add_argument('--verbose', action='store_true', default=False,
-      help='Debug logging.')
-  return parser.parse_args()
-
-
-def _RunGN(args):
-  cmd = ['gn']
-  cmd.extend(args)
-  logging.debug('Running: %r', cmd)
-  subprocess.check_call(cmd)
-
-
-def _RunNinja(output_directory, args):
-  cmd = ['ninja', '-C', output_directory]
-  cmd.extend(args)
-  logging.debug('Running: %r', cmd)
-  subprocess.check_call(cmd)
-
-
-def _EncodeForGN(value):
-  """Encodes value as a GN literal."""
-  if type(value) is str:
-    return '"' + value + '"'
-  elif type(value) is bool:
-    return repr(value).lower()
-  else:
-    return repr(value)
-
-
-def _GetOutputDirectory(tmp_dir, arch):
-  """Returns the GN output directory for the target architecture."""
-  return os.path.join(tmp_dir, arch)
-
-
-def _GetTargetCpu(arch):
-  """Returns target_cpu for the GN build with the given architecture."""
-  if arch in ['armeabi', 'armeabi-v7a']:
-    return 'arm'
-  elif arch == 'x86':
-    return 'x86'
-  else:
-    raise Exception('Unknown arch: ' + arch)
-
-
-def _GetArmVersion(arch):
-  """Returns arm_version for the GN build with the given architecture."""
-  if arch == 'armeabi':
-    return 6
-  elif arch == 'armeabi-v7a':
-    return 7
-  elif arch == 'x86':
-    return None
-  else:
-    raise Exception('Unknown arch: ' + arch)
-
-
-def Build(tmp_dir, arch, use_goma):
-  """Generates target architecture using GN and builds it using ninja."""
-  logging.info('Building: %s', arch)
-  output_directory = _GetOutputDirectory(tmp_dir, arch)
-  gn_args = {
-    'target_os': 'android',
-    'is_debug': False,
-    'is_component_build': False,
-    'target_cpu': _GetTargetCpu(arch),
-    'use_goma': use_goma
-  }
-  arm_version = _GetArmVersion(arch)
-  if arm_version:
-    gn_args['arm_version'] = arm_version
-  gn_args_str = '--args=' + ' '.join([
-      k + '=' + _EncodeForGN(v) for k, v in gn_args.items()])
-
-  _RunGN(['gen', output_directory, gn_args_str])
-
-  ninja_args = TARGETS
-  if use_goma:
-    ninja_args.extend(['-j', '1024'])
-  _RunNinja(output_directory, ninja_args)
-
-
-def CollectCommon(aar_file, tmp_dir, arch):
-  """Collects architecture independent files into the .aar-archive."""
-  logging.info('Collecting common files.')
-  output_directory = _GetOutputDirectory(tmp_dir, arch)
-  aar_file.write(MANIFEST_FILE, 'AndroidManifest.xml')
-  aar_file.write(os.path.join(output_directory, JAR_FILE), 'classes.jar')
-
-
-def Collect(aar_file, tmp_dir, arch):
-  """Collects architecture specific files into the .aar-archive."""
-  logging.info('Collecting: %s', arch)
-  output_directory = _GetOutputDirectory(tmp_dir, arch)
-
-  abi_dir = os.path.join('jni', arch)
-  for so_file in NEEDED_SO_FILES:
-    aar_file.write(os.path.join(output_directory, so_file),
-                   os.path.join(abi_dir, so_file))
-
-
-def main():
-  args = _ParseArgs()
-  if not args.arch:
-    args.arch = DEFAULT_ARCHS
-
-  logging.basicConfig(level=logging.DEBUG if args.verbose else logging.INFO)
-
-  tmp_dir = tempfile.mkdtemp()
-
-  for arch in args.arch:
-    Build(tmp_dir, arch, args.use_goma)
-
-  with zipfile.ZipFile(args.output, 'w') as aar_file:
-    # Architecture doesn't matter here, arbitrarily using the first one.
-    CollectCommon(aar_file, tmp_dir, args.arch[0])
-    for arch in args.arch:
-      Collect(aar_file, tmp_dir, arch)
-
-  shutil.rmtree(tmp_dir, True)
-
-
-if __name__ == '__main__':
-  sys.exit(main())