# 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': { # 'apk_name': 'MyPackage', # 'java_in_dir': 'path/to/package/root', # 'resource_dir': 'path/to/package/root/res', # }, # 'includes': ['path/to/this/gypi/file'], # } # # Required variables: # apk_name - The final apk will be named .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. # 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_lib_target - The target_name of the target which generates the final # shared library to be included in this apk. A stripped copy of the # library will be included in the apk. # 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. # java_strings_grd - The name of the grd file from which to generate localized # strings.xml files, if any. # library_manifest_paths'- Paths to additional AndroidManifest.xml files from # libraries. # use_content_linker - Enable the content dynamic linker that allows sharing the # RELRO section of the native libraries between the different processes. # enable_content_linker_tests - Enable the content dynamic linker test support # code. This allows a test APK to inject a Linker.TestRunner instance at # runtime. Should only be used by the content_linker_test_apk target!! { 'variables': { 'additional_input_paths': [], 'input_jars_paths': [], 'library_dexed_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_paths%': ['<(DEPTH)/build/android/empty_proguard.flags'], 'jar_name': 'chromium_apk_<(_target_name).jar', 'resource_dir%':'<(DEPTH)/build/android/ant/empty/res', 'R_package%':'', 'additional_R_text_files': [], 'additional_res_dirs': [], 'additional_res_packages': [], 'is_test_apk%': 0, 'java_strings_grd%': '', 'library_manifest_paths' : [], 'resource_input_paths': [], 'intermediate_dir': '<(PRODUCT_DIR)/<(_target_name)', 'asset_location%': '<(intermediate_dir)/assets', 'codegen_stamp': '<(intermediate_dir)/codegen.stamp', 'compile_input_paths': [], 'package_input_paths': [], 'ordered_libraries_file': '<(intermediate_dir)/native_libraries.json', # TODO(cjhopman): build/ shouldn't refer to content/. The libraryloader and # nativelibraries template should be moved out of content/ (to base/?). # http://crbug.com/225101 'native_libraries_template': '<(DEPTH)/content/public/android/java/templates/NativeLibraries.template', 'native_libraries_java_dir': '<(intermediate_dir)/native_libraries_java/', 'native_libraries_java_file': '<(native_libraries_java_dir)/NativeLibraries.java', 'native_libraries_java_stamp': '<(intermediate_dir)/native_libraries_java.stamp', 'native_libraries_template_data_dir': '<(intermediate_dir)/native_libraries/', 'native_libraries_template_data_file': '<(native_libraries_template_data_dir)/native_libraries_array.h', 'native_libraries_template_data_stamp': '<(intermediate_dir)/native_libraries_template_data.stamp', 'compile_stamp': '<(intermediate_dir)/compile.stamp', 'instr_stamp': '<(intermediate_dir)/instr.stamp', 'jar_stamp': '<(intermediate_dir)/jar.stamp', 'obfuscate_stamp': '<(intermediate_dir)/obfuscate.stamp', 'strip_stamp': '<(intermediate_dir)/strip.stamp', 'classes_dir': '<(intermediate_dir)/classes', 'classes_final_dir': '<(intermediate_dir)/classes_instr', 'javac_includes': [], 'jar_excluded_classes': [], 'jar_path': '<(PRODUCT_DIR)/lib.java/<(jar_name)', 'obfuscated_jar_path': '<(intermediate_dir)/obfuscated.jar', 'dex_path': '<(intermediate_dir)/classes.dex', 'emma_device_jar': '<(android_sdk_root)/tools/lib/emma_device.jar', 'android_manifest_path%': '<(java_in_dir)/AndroidManifest.xml', 'push_stamp': '<(intermediate_dir)/push.stamp', 'link_stamp': '<(intermediate_dir)/link.stamp', 'package_resources_stamp': '<(intermediate_dir)/package_resources.stamp', 'codegen_input_paths': [], 'unsigned_apk_path': '<(intermediate_dir)/<(apk_name)-unsigned.apk', 'final_apk_path%': '<(PRODUCT_DIR)/apks/<(apk_name).apk', 'incomplete_apk_path': '<(intermediate_dir)/<(apk_name)-incomplete.apk', 'source_dir': '<(java_in_dir)/src', 'apk_install_record': '<(intermediate_dir)/apk_install.record.stamp', 'device_intermediate_dir': '/data/local/tmp/chromium/<(_target_name)/<(CONFIGURATION_NAME)', 'symlink_script_host_path': '<(intermediate_dir)/create_symlinks.sh', 'symlink_script_device_path': '<(device_intermediate_dir)/create_symlinks.sh', 'create_standalone_apk%': 1, 'variables': { 'variables': { 'native_lib_target%': '', 'use_content_linker%': 0, 'enable_content_linker_tests%': 0, }, 'conditions': [ ['gyp_managed_install == 1 and native_lib_target != ""', { 'unsigned_standalone_apk_path': '<(intermediate_dir)/<(apk_name)-standalone-unsigned.apk', }, { 'unsigned_standalone_apk_path': '<(unsigned_apk_path)', }], ['gyp_managed_install == 1', { 'apk_package_native_libs_dir': '<(intermediate_dir)/libs.managed', }, { 'apk_package_native_libs_dir': '<(intermediate_dir)/libs', }], ], }, 'native_lib_target%': '', 'use_content_linker%': 0, 'enable_content_linker_tests%': 0, 'emma_instrument': '<(emma_coverage)', 'apk_package_native_libs_dir': '<(apk_package_native_libs_dir)', 'unsigned_standalone_apk_path': '<(unsigned_standalone_apk_path)', 'extra_native_libs': [], }, # 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)', }, }, 'conditions': [ ['resource_dir!=""', { 'variables': { 'resource_input_paths': [ '(android_product_extension)' ], 'package_input_paths': [ '<(apk_package_native_libs_dir)/<(android_app_abi)/gdbserver', ], }, 'copies': [ { # gdbserver is always copied into the APK's native libs dir. The ant # build scripts (apkbuilder task) will only include it in a debug # build. 'destination': '<(apk_package_native_libs_dir)/<(android_app_abi)', 'files': [ '<(android_gdbserver)', '<@(extra_native_libs)', ], }, ], 'actions': [ { 'variables': { 'conditions': [ ['use_content_linker == 1', { 'variables': { 'linker_input_libraries': [ '<(SHARED_LIB_DIR)/libcontent_android_linker.>(android_product_extension)', ], } }, { 'variables': { 'linker_input_libraries': [], }, }], ], 'input_libraries': [ '<@(native_libs_paths)', '<@(extra_native_libs)', '<@(linker_input_libraries)', ], }, 'includes': ['../build/android/write_ordered_libraries.gypi'], }, { 'action_name': 'native_libraries_template_data_<(_target_name)', 'message': 'Creating native_libraries_list.h for <(_target_name).', 'inputs': [ '<(DEPTH)/build/android/gyp/util/build_utils.py', '<(DEPTH)/build/android/gyp/create_native_libraries_header.py', '<(ordered_libraries_file)', ], 'outputs': [ '<(native_libraries_template_data_stamp)', ], 'action': [ 'python', '<(DEPTH)/build/android/gyp/create_native_libraries_header.py', '--ordered-libraries=<(ordered_libraries_file)', '--output=<(native_libraries_template_data_file)', '--stamp=<(native_libraries_template_data_stamp)', ], }, { 'action_name': 'native_libraries_<(_target_name)', 'variables': { 'conditions': [ ['use_content_linker == 1', { 'variables': { 'linker_gcc_preprocess_defines': [ '--defines', 'ENABLE_CONTENT_LINKER', ], } }, { 'variables': { 'linker_gcc_preprocess_defines': [], }, }], ['enable_content_linker_tests == 1', { 'variables': { 'linker_tests_gcc_preprocess_defines': [ '--defines', 'ENABLE_CONTENT_LINKER_TESTS', ], } }, { 'variables': { 'linker_tests_gcc_preprocess_defines': [], }, }], ], 'gcc_preprocess_defines': [ '<@(linker_gcc_preprocess_defines)', '<@(linker_tests_gcc_preprocess_defines)', ], }, 'message': 'Creating NativeLibraries.java for <(_target_name).', 'inputs': [ '<(DEPTH)/build/android/gyp/util/build_utils.py', '<(DEPTH)/build/android/gyp/gcc_preprocess.py', '<(native_libraries_template_data_stamp)', '<(native_libraries_template)', ], 'outputs': [ '<(native_libraries_java_stamp)', ], 'action': [ 'python', '<(DEPTH)/build/android/gyp/gcc_preprocess.py', '--include-path=<(native_libraries_template_data_dir)', '--output=<(native_libraries_java_file)', '--template=<(native_libraries_template)', '--stamp=<(native_libraries_java_stamp)', '<@(gcc_preprocess_defines)', ], }, { 'action_name': 'strip_native_libraries', 'variables': { 'ordered_libraries_file%': '<(ordered_libraries_file)', 'stripped_libraries_dir': '<(libraries_source_dir)', 'input_paths': [ '<@(native_libs_paths)', '<@(extra_native_libs)', ], 'stamp': '<(strip_stamp)' }, 'includes': ['../build/android/strip_native_libraries.gypi'], }, ], 'conditions': [ ['gyp_managed_install == 1', { 'variables': { 'libraries_top_dir': '<(intermediate_dir)/lib.stripped', 'libraries_source_dir': '<(libraries_top_dir)/lib/<(android_app_abi)', 'device_library_dir': '<(device_intermediate_dir)/lib.stripped', 'configuration_name': '<(CONFIGURATION_NAME)', }, 'dependencies': [ '<(DEPTH)/build/android/setup.gyp:get_build_device_configurations', ], 'actions': [ { 'includes': ['../build/android/push_libraries.gypi'], }, { 'action_name': 'create device library symlinks', 'message': 'Creating links on device for <(_target_name).', 'inputs': [ '<(DEPTH)/build/android/gyp/util/build_utils.py', '<(DEPTH)/build/android/gyp/create_device_library_links.py', '<(apk_install_record)', '<(build_device_config_path)', '<(ordered_libraries_file)', ], 'outputs': [ '<(link_stamp)' ], 'action': [ 'python', '<(DEPTH)/build/android/gyp/create_device_library_links.py', '--build-device-configuration=<(build_device_config_path)', '--libraries-json=<(ordered_libraries_file)', '--script-host-path=<(symlink_script_host_path)', '--script-device-path=<(symlink_script_device_path)', '--target-dir=<(device_library_dir)', '--apk=<(incomplete_apk_path)', '--stamp=<(link_stamp)', '--configuration-name=<(CONFIGURATION_NAME)', ], }, ], 'conditions': [ ['create_standalone_apk == 1', { 'actions': [ { 'action_name': 'create standalone APK', 'variables': { 'inputs': [ '<(ordered_libraries_file)', '<(strip_stamp)', ], 'input_apk_path': '<(unsigned_apk_path)', 'output_apk_path': '<(unsigned_standalone_apk_path)', 'libraries_top_dir%': '<(libraries_top_dir)', }, 'includes': [ 'android/create_standalone_apk_action.gypi' ], }, ], }], ], }, { # gyp_managed_install != 1 'variables': { 'libraries_source_dir': '<(apk_package_native_libs_dir)/<(android_app_abi)', 'package_input_paths': [ '<(strip_stamp)' ], }, }], ], }], # native_lib_target != '' ['gyp_managed_install == 0 or create_standalone_apk == 1', { 'actions': [ { 'action_name': 'finalize standalone apk', 'variables': { 'input_apk_path': '<(unsigned_standalone_apk_path)', 'output_apk_path': '<(final_apk_path)', }, 'includes': [ 'android/finalize_apk_action.gypi'] }, ], }], ['java_strings_grd != ""', { 'variables': { 'res_grit_dir': '<(SHARED_INTERMEDIATE_DIR)/<(package_name)_apk/res_grit', 'additional_res_dirs': ['<(res_grit_dir)'], # grit_grd_file is used by grit_action.gypi, included below. 'grit_grd_file': '<(java_in_dir)/strings/<(java_strings_grd)', 'resource_input_paths': [ '@(additional_input_paths)', '>@(codegen_input_paths)', '>@(library_manifest_paths)', '>@(resource_input_paths)', ], 'outputs': [ '<(codegen_stamp)', ], 'action': [ 'python', '<(DEPTH)/build/android/gyp/ant.py', '-quiet', '-DADDITIONAL_RES_DIRS=>(additional_res_dirs)', '-DADDITIONAL_RES_PACKAGES=>(additional_res_packages)', '-DADDITIONAL_R_TEXT_FILES=>(additional_R_text_files)', '-DANDROID_MANIFEST=<(android_manifest_path)', '-DANDROID_SDK_JAR=<(android_sdk_jar)', '-DANDROID_SDK_ROOT=<(android_sdk_root)', '-DANDROID_SDK_VERSION=<(android_sdk_version)', '-DANDROID_SDK_TOOLS=<(android_sdk_tools)', '-DLIBRARY_MANIFEST_PATHS=>(library_manifest_paths)', '-DOUT_DIR=<(intermediate_dir)', '-DRESOURCE_DIR=<(resource_dir)', '-DSTAMP=<(codegen_stamp)', '-Dbasedir=.', '-buildfile', '<(DEPTH)/build/android/ant/apk-codegen.xml', # Add list of inputs to the command line, so if inputs change # (e.g. if a Java file is removed), the command will be re-run. # TODO(newt): remove this once crbug.com/177552 is fixed in ninja. '-DTHIS_IS_IGNORED=>!(echo \'>(_inputs)\' | md5sum)', ], }, { 'action_name': 'javac_<(_target_name)', 'message': 'Compiling java for <(_target_name)', 'variables': { 'all_src_dirs': [ '<(java_in_dir)/src', '<(intermediate_dir)/gen', '>@(additional_src_dirs)', '>@(generated_src_dirs)', ], }, 'inputs': [ '<(DEPTH)/build/android/gyp/util/build_utils.py', '<(DEPTH)/build/android/gyp/javac.py', # 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)', '<(codegen_stamp)', '>@(compile_input_paths)', ], 'outputs': [ '<(compile_stamp)', ], 'action': [ 'python', '<(DEPTH)/build/android/gyp/javac.py', '--output-dir=<(classes_dir)', '--classpath=>(input_jars_paths) <(android_sdk_jar)', '--src-dirs=>(all_src_dirs)', '--javac-includes=<(javac_includes)', '--chromium-code=<(chromium_code)', '--stamp=<(compile_stamp)', # TODO(newt): remove this once http://crbug.com/177552 is fixed in ninja. '--ignore=>!(echo \'>(_inputs)\' | md5sum)', ], }, { 'action_name': 'instr_classes_<(_target_name)', 'message': 'Instrumenting <(_target_name) classes', 'variables': { 'input_path': '<(classes_dir)', 'output_path': '<(classes_final_dir)', 'stamp_path': '<(instr_stamp)', 'instr_type': 'classes', }, 'outputs': [ '<(instr_stamp)', ], 'inputs': [ '<(compile_stamp)', ], 'includes': [ 'android/instr_action.gypi' ], }, { 'action_name': 'jar_<(_target_name)', 'message': 'Creating <(_target_name) jar', 'inputs': [ '<(instr_stamp)', '<(DEPTH)/build/android/gyp/util/build_utils.py', '<(DEPTH)/build/android/gyp/util/md5_check.py', '<(DEPTH)/build/android/gyp/jar.py', ], 'outputs': [ '<(jar_stamp)', ], 'action': [ 'python', '<(DEPTH)/build/android/gyp/jar.py', '--classes-dir=<(classes_final_dir)', '--jar-path=<(jar_path)', '--excluded-classes=<(jar_excluded_classes)', '--stamp=<(jar_stamp)', # TODO(newt): remove this once http://crbug.com/177552 is fixed in ninja. '--ignore=>!(echo \'>(_inputs)\' | md5sum)', ] }, { 'action_name': 'ant_obfuscate_<(_target_name)', 'message': 'Obfuscating <(_target_name)', 'inputs': [ '<(DEPTH)/build/android/ant/apk-obfuscate.xml', '<(DEPTH)/build/android/ant/create-test-jar.js', '<(DEPTH)/build/android/gyp/util/build_utils.py', '<(DEPTH)/build/android/gyp/ant.py', '<(instr_stamp)', '>@(proguard_flags_paths)', ], 'outputs': [ '<(obfuscate_stamp)', ], 'action': [ 'python', '<(DEPTH)/build/android/gyp/ant.py', '-quiet', '-DADDITIONAL_SRC_DIRS=>(additional_src_dirs)', '-DANDROID_SDK_JAR=<(android_sdk_jar)', '-DANDROID_SDK_ROOT=<(android_sdk_root)', '-DANDROID_SDK_VERSION=<(android_sdk_version)', '-DANDROID_SDK_TOOLS=<(android_sdk_tools)', '-DAPK_NAME=<(apk_name)', '-DCREATE_TEST_JAR_PATH=<(DEPTH)/build/android/ant/create-test-jar.js', '-DCONFIGURATION_NAME=<(CONFIGURATION_NAME)', '-DGENERATED_SRC_DIRS=>(generated_src_dirs)', '-DINPUT_JARS_PATHS=>(input_jars_paths)', '-DIS_TEST_APK=<(is_test_apk)', '-DJAR_PATH=<(PRODUCT_DIR)/lib.java/<(jar_name)', '-DOBFUSCATED_JAR_PATH=<(obfuscated_jar_path)', '-DOUT_DIR=<(intermediate_dir)', '-DPROGUARD_ENABLED=<(proguard_enabled)', '-DPROGUARD_FLAGS=<(proguard_flags_paths)', '-DTEST_JAR_PATH=<(PRODUCT_DIR)/test.lib.java/<(apk_name).jar', '-DSTAMP=<(obfuscate_stamp)', '-Dbasedir=.', '-buildfile', '<(DEPTH)/build/android/ant/apk-obfuscate.xml', # Add list of inputs to the command line, so if inputs change # (e.g. if a Java file is removed), the command will be re-run. # TODO(newt): remove this once crbug.com/177552 is fixed in ninja. '-DTHIS_IS_IGNORED=>!(echo \'>(_inputs)\' | md5sum)', ], }, { 'action_name': 'dex_<(_target_name)', 'variables': { 'conditions': [ ['proguard_enabled == "true"', { 'input_paths': [ '<(obfuscate_stamp)' ], 'proguard_enabled_input_path': '<(obfuscated_jar_path)', }], ['emma_instrument != 0', { 'dex_no_locals': 1, }], ['emma_instrument != 0 and is_test_apk == 0', { 'dex_input_paths': [ '<(emma_device_jar)' ], }], ], 'input_paths': [ '<(instr_stamp)' ], 'dex_input_paths': [ '>@(library_dexed_jars_paths)' ], 'dex_generated_input_dirs': [ '<(classes_final_dir)' ], 'output_path': '<(dex_path)', }, 'includes': [ 'android/dex_action.gypi' ], }, { 'action_name': 'ant package resources', 'message': 'Packaging resources for <(_target_name) APK.', 'inputs': [ '<(DEPTH)/build/android/ant/apk-package-resources.xml', '<(DEPTH)/build/android/gyp/util/build_utils.py', '<(DEPTH)/build/android/gyp/ant.py', '<(android_manifest_path)', '<(codegen_stamp)', '>@(library_manifest_paths)', '>@(additional_input_paths)', ], 'conditions': [ ['is_test_apk == 1', { 'variables': { 'additional_res_dirs=': [], 'additional_res_packages=': [], } }], ], 'outputs': [ '<(package_resources_stamp)', ], 'action': [ 'python', '<(DEPTH)/build/android/gyp/ant.py', '-quiet', '-DADDITIONAL_RES_DIRS=>(additional_res_dirs)', '-DADDITIONAL_RES_PACKAGES=>(additional_res_packages)', '-DADDITIONAL_R_TEXT_FILES=>(additional_R_text_files)', '-DANDROID_SDK_JAR=<(android_sdk_jar)', '-DANDROID_SDK_ROOT=<(android_sdk_root)', '-DANDROID_SDK_TOOLS=<(android_sdk_tools)', '-DAPK_NAME=<(apk_name)', '-DAPP_MANIFEST_VERSION_CODE=<(app_manifest_version_code)', '-DAPP_MANIFEST_VERSION_NAME=<(app_manifest_version_name)', '-DASSET_DIR=<(asset_location)', '-DCONFIGURATION_NAME=<(CONFIGURATION_NAME)', '-DOUT_DIR=<(intermediate_dir)', '-DRESOURCE_DIR=<(resource_dir)', '-DSTAMP=<(package_resources_stamp)', '-Dbasedir=.', '-buildfile', '<(DEPTH)/build/android/ant/apk-package-resources.xml', # Add list of inputs to the command line, so if inputs change # (e.g. if a Java file is removed), the command will be re-run. # TODO(newt): remove this once crbug.com/177552 is fixed in ninja. '-DTHIS_IS_IGNORED=>!(echo \'>(_inputs)\' | md5sum)', ] }, { 'action_name': 'ant_package_<(_target_name)', 'message': 'Packaging <(_target_name).', 'inputs': [ '<(DEPTH)/build/android/ant/apk-package.xml', '<(DEPTH)/build/android/gyp/util/build_utils.py', '<(DEPTH)/build/android/gyp/ant.py', '<(dex_path)', '<(codegen_stamp)', '<(obfuscate_stamp)', '<(package_resources_stamp)', '>@(package_input_paths)', ], 'outputs': [ '<(unsigned_apk_path)', ], 'action': [ 'python', '<(DEPTH)/build/android/gyp/ant.py', '-quiet', '-DANDROID_SDK_ROOT=<(android_sdk_root)', '-DANDROID_SDK_TOOLS=<(android_sdk_tools)', '-DAPK_NAME=<(apk_name)', '-DCONFIGURATION_NAME=<(CONFIGURATION_NAME)', '-DNATIVE_LIBS_DIR=<(apk_package_native_libs_dir)', '-DOUT_DIR=<(intermediate_dir)', '-DSOURCE_DIR=<(source_dir)', '-DUNSIGNED_APK_PATH=<(unsigned_apk_path)', '-DEMMA_INSTRUMENT=<(emma_instrument)', '-DEMMA_DEVICE_JAR=<(emma_device_jar)', '-Dbasedir=.', '-buildfile', '<(DEPTH)/build/android/ant/apk-package.xml', # Add list of inputs to the command line, so if inputs change # (e.g. if a Java file is removed), the command will be re-run. # TODO(newt): remove this once crbug.com/177552 is fixed in ninja. '-DTHIS_IS_IGNORED=>!(echo \'>(_inputs)\' | md5sum)', ] }, ], }