blob: 6cacee1588bf0b499da8bc8ad665152af841b0ef [file] [log] [blame]
# Copyright (c) 2012 The Chromium Authors. All rights reserved.
# Use of this source code is governed by a BSD-style license that can be
# found in the LICENSE file.
# This file is meant to be included into a target to provide a rule
# to build Android APKs in a consistent manner.
#
# To use this, create a gyp target with the following form:
# {
# 'target_name': 'my_package_apk',
# 'type': 'none',
# 'variables': {
# 'package_name': 'my_package',
# 'apk_name': 'MyPackage',
# 'java_in_dir': 'path/to/package/root',
# 'resource_dir': 'res',
# },
# 'includes': ['path/to/this/gypi/file'],
# }
#
# Note that this assumes that there's an ant buildfile <package_name>_apk.xml in
# java_in_dir. So, if you have package_name="content_shell" and
# java_in_dir="content/shell/android/java" you should have a directory structure
# like:
#
# content/shell/android/java/content_shell_apk.xml
# content/shell/android/java/src/org/chromium/base/Foo.java
# content/shell/android/java/src/org/chromium/base/Bar.java
#
# Required variables:
# package_name - Used to name the intermediate output directory and in the
# names of some output files.
# apk_name - The final apk will be named <apk_name>.apk
# java_in_dir - The top-level java directory. The src should be in
# <java_in_dir>/src.
# Optional/automatic variables:
# additional_input_paths - These paths will be included in the 'inputs' list to
# ensure that this target is rebuilt when one of these paths changes.
# additional_res_dirs - Additional directories containing Android resources.
# additional_res_packages - Package names of the R.java files corresponding to
# each directory in additional_res_dirs.
# additional_src_dirs - Additional directories with .java files to be compiled
# and included in the output of this target.
# asset_location - The directory where assets are located (default:
# <PRODUCT_DIR>/<package_name>/assets).
# generated_src_dirs - Same as additional_src_dirs except used for .java files
# that are generated at build time. This should be set automatically by a
# target's dependencies. The .java files in these directories are not
# included in the 'inputs' list (unlike additional_src_dirs).
# input_jars_paths - The path to jars to be included in the classpath. This
# should be filled automatically by depending on the appropriate targets.
# is_test_apk - Set to 1 if building a test apk. This prevents resources from
# dependencies from being re-included.
# native_libs_paths - The path to any native library to be included in this
# target. This should be a path in <(SHARED_LIB_DIR). A stripped copy of
# the library will be included in the apk and symbolic links to the
# unstripped copy will be added to <(android_product_out) to enable native
# debugging.
# resource_dir - The directory for resources.
# R_package - A custom Java package to generate the resource file R.java in.
# By default, the package given in AndroidManifest.xml will be used.
{
'variables': {
'asset_location%': '',
'additional_input_paths': [],
'input_jars_paths': [],
'additional_src_dirs': [],
'generated_src_dirs': [],
'app_manifest_version_name%': '<(android_app_version_name)',
'app_manifest_version_code%': '<(android_app_version_code)',
'proguard_enabled%': 'false',
'proguard_flags%': '',
'native_libs_paths': [],
'jar_name%': 'chromium_apk_<(package_name).jar',
'resource_dir%':'',
'R_package%':'',
'additional_res_dirs': [],
'additional_res_packages': [],
'is_test_apk%': 0,
'conditions' : [
['OS == "lb_shell" and target_arch == "android"', {
'chromium_src_dir' : '<(ant_build_out)/../../../external/chromium',
},{
'chromium_src_dir' : '<(ant_build_out)/../..',
}],
],
},
'sources': [
'<@(native_libs_paths)'
],
# Pass the jar path to the apk's "fake" jar target. This would be better as
# direct_dependent_settings, but a variable set by a direct_dependent_settings
# cannot be lifted in a dependent to all_dependent_settings.
'all_dependent_settings': {
'variables': {
'apk_output_jar_path': '<(PRODUCT_DIR)/lib.java/<(jar_name)',
},
},
'rules': [
{
'rule_name': 'copy_and_strip_native_libraries',
'extension': 'so',
'variables': {
'stripped_library_path': '<(PRODUCT_DIR)/<(package_name)/libs/<(android_app_abi)/<(RULE_INPUT_ROOT).so',
},
'outputs': [
'<(stripped_library_path)',
],
# There is no way to do 2 actions for each source library in gyp. So to
# both strip the library and create the link in <(link_dir) a separate
# script is required.
'action': [
'<(DEPTH)/build/android/prepare_library_for_apk',
'<(android_strip)',
'<(RULE_INPUT_PATH)',
'<(stripped_library_path)',
],
},
],
'actions': [
{
# This action updates the timestamp of AndroidManifest.xml
# The aapt package step doesn't know to repackage APK resources
# if only the version code changes,
# while a change to a resource file will cause a repackage.
# Note that ninja only runs this action
# when <(android_app_version_code) changes.
'action_name': 'touch_manifest_for_apk_repackage',
'message': 'Touching AndroidManifest.xml',
'inputs': [],
'outputs': ['<(java_in_dir)/AndroidManifest.xml'],
'action': [
# -c to 'touch' means don't create any files.
# <(android_app_version_code) is not a file, this is just a way to
# have ninja consider it a dependency.
'touch', '-c', '<(java_in_dir)/AndroidManifest.xml', '<(android_app_version_code)'
],
},
{
'action_name': 'ant_<(package_name)_apk',
'message': 'Building <(package_name) apk.',
'inputs': [
'<(java_in_dir)/AndroidManifest.xml',
'<(DEPTH)/build/android/ant/chromium-apk.xml',
'<(DEPTH)/build/android/ant/common.xml',
'<(DEPTH)/build/android/ant/sdk-targets.xml',
# If there is a separate find for additional_src_dirs, it will find the
# wrong .java files when additional_src_dirs is empty.
'>!@(find >(java_in_dir) >(additional_src_dirs) -name "*.java")',
'>@(input_jars_paths)',
'>@(native_libs_paths)',
'>@(additional_input_paths)',
],
'conditions': [
['resource_dir!=""', {
'inputs': ['<!@(find <(java_in_dir)/<(resource_dir) -name "*")']
}],
['is_test_apk == 1', {
'variables': {
'additional_res_dirs=': [],
'additional_res_packages=': [],
}
}],
['proguard_enabled == "true" and proguard_flags != ""', {
'inputs': ['<(java_in_dir)/<(proguard_flags)']
}]
],
'outputs': [
'<(PRODUCT_DIR)/apks/<(apk_name).apk',
],
'action': [
'ant',
'-DAPP_ABI=<(android_app_abi)',
'-DANDROID_GDBSERVER=<(android_gdbserver)',
'-DANDROID_SDK=<(android_sdk)',
'-DANDROID_SDK_ROOT=<(android_sdk_root)',
'-DANDROID_SDK_TOOLS=<(android_sdk_tools)',
'-DANDROID_SDK_VERSION=<(android_sdk_version)',
'-DANDROID_TOOLCHAIN=<(android_toolchain)',
'-DCHROMIUM_SRC=<(chromium_src_dir)',
'-DCONFIGURATION_NAME=<(CONFIGURATION_NAME)',
'-DPRODUCT_DIR=<(ant_build_out)',
'-DAPK_NAME=<(apk_name)',
'-DASSET_DIR=<(asset_location)',
'-DADDITIONAL_SRC_DIRS=>(additional_src_dirs)',
'-DGENERATED_SRC_DIRS=>(generated_src_dirs)',
'-DINPUT_JARS_PATHS=>(input_jars_paths)',
'-DJAR_NAME=<(jar_name)',
'-DPACKAGE_NAME=<(package_name)',
'-DRESOURCE_DIR=<(resource_dir)',
'-DADDITIONAL_RES_DIRS=>(additional_res_dirs)',
'-DADDITIONAL_RES_PACKAGES=>(additional_res_packages)',
'-DAPP_MANIFEST_VERSION_NAME=<(app_manifest_version_name)',
'-DAPP_MANIFEST_VERSION_CODE=<(app_manifest_version_code)',
'-DPROGUARD_FLAGS=>(proguard_flags)',
'-DPROGUARD_ENABLED=>(proguard_enabled)',
'-Dbasedir=<(java_in_dir)',
'-buildfile',
'<(DEPTH)/build/android/ant/chromium-apk.xml',
# Specify CONFIGURATION_NAME as the target for ant to build. The
# buildfile will then build the appropriate SDK tools target.
'<(CONFIGURATION_NAME)',
]
},
],
'conditions': [
['R_package != ""', {
'variables': {
# We generate R.java in package R_package (in addition to the package
# listed in the AndroidManifest.xml, which is unavoidable).
'additional_res_dirs': ['<(DEPTH)/build/android/ant/empty/res'],
'additional_res_packages': ['<(R_package)'],
},
}],
],
}