build/java.gypi

   1 # Copyright (c) 2012 The Chromium Authors. All rights reserved.
   2 # Use of this source code is governed by a BSD-style license that can be
   3 # found in the LICENSE file.
   4
   5 # This file is meant to be included into a target to provide a rule
   6 # to build Java in a consistent manner.
   7 #
   8 # To use this, create a gyp target with the following form:
   9 # {
  10 #   'target_name': 'my-package_java',
  11 #   'type': 'none',
  12 #   'variables': {
  13 #     'java_in_dir': 'path/to/package/root',
  14 #   },
  15 #   'includes': ['path/to/this/gypi/file'],
  16 # }
  17 #
  18 # Required variables:
  19 #  java_in_dir - The top-level java directory. The src should be in
  20 #    <java_in_dir>/src.
  21 # Optional/automatic variables:
  22 #  add_to_dependents_classpaths - Set to 0 if the resulting jar file should not
  23 #    be added to its dependents' classpaths.
  24 #  additional_input_paths - These paths will be included in the 'inputs' list to
  25 #    ensure that this target is rebuilt when one of these paths changes.
  26 #  additional_src_dirs - Additional directories with .java files to be compiled
  27 #    and included in the output of this target.
  28 #  generated_src_dirs - Same as additional_src_dirs except used for .java files
  29 #    that are generated at build time. This should be set automatically by a
  30 #    target's dependencies. The .java files in these directories are not
  31 #    included in the 'inputs' list (unlike additional_src_dirs).
  32 #  input_jars_paths - The path to jars to be included in the classpath. This
  33 #    should be filled automatically by depending on the appropriate targets.
  34 #  javac_includes - A list of specific files to include. This is by default
  35 #    empty, which leads to inclusion of all files specified. May include
  36 #    wildcard, and supports '**/' for recursive path wildcards, ie.:
  37 #    '**/MyFileRegardlessOfDirectory.java', '**/IncludedPrefix*.java'.
  38 #  has_java_resources - Set to 1 if the java target contains an
  39 #    Android-compatible resources folder named res.  If 1, R_package and
  40 #    R_package_relpath must also be set.
  41 #  R_package - The java package in which the R class (which maps resources to
  42 #    integer IDs) should be generated, e.g. org.chromium.content.
  43 #  R_package_relpath - Same as R_package, but replace each '.' with '/'.
  44 #  res_extra_dirs - A list of extra directories containing Android resources.
  45 #    These directories may be generated at build time.
  46 #  res_extra_files - A list of the files in res_extra_dirs.
  47 #  never_lint - Set to 1 to not run lint on this target.
  48
  49 {
  50   'dependencies': [
  51     '<(DEPTH)/build/android/setup.gyp:build_output_dirs'
  52   ],
  53   'variables': {
  54     'add_to_dependents_classpaths%': 1,
  55     'android_jar': '<(android_sdk)/android.jar',
  56     'input_jars_paths': [ '<(android_jar)' ],
  57     'additional_src_dirs': [],
  58     'javac_includes': [],
  59     'jar_name': '<(_target_name).jar',
  60     'jar_dir': '<(PRODUCT_DIR)/lib.java',
  61     'jar_path': '<(intermediate_dir)/<(jar_name)',
  62     'jar_final_path': '<(jar_dir)/<(jar_name)',
  63     'jar_excluded_classes': [ '*/R.class', '*/R##*.class' ],
  64     'instr_stamp': '<(intermediate_dir)/instr.stamp',
  65     'additional_input_paths': [],
  66     'dex_path': '<(PRODUCT_DIR)/lib.java/<(_target_name).dex.jar',
  67     'main_dex_list_path': '<(intermediate_dir)/main_dex_list.txt',
  68     'generated_src_dirs': ['>@(generated_R_dirs)'],
  69     'generated_R_dirs': [],
  70     'has_java_resources%': 0,
  71     'res_extra_dirs': [],
  72     'res_extra_files': [],
  73     'res_v14_skip%': 0,
  74     'resource_input_paths': ['>@(res_extra_files)'],
  75     'intermediate_dir': '<(SHARED_INTERMEDIATE_DIR)/<(_target_name)',
  76     'compile_stamp': '<(intermediate_dir)/compile.stamp',
  77     'lint_stamp': '<(intermediate_dir)/lint.stamp',
  78     'lint_result': '<(intermediate_dir)/lint_result.xml',
  79     'lint_config': '<(intermediate_dir)/lint_config.xml',
  80     'never_lint%': 0,
  81     'findbugs_stamp': '<(intermediate_dir)/findbugs.stamp',
  82     'run_findbugs%': 0,
  83     'java_in_dir_suffix%': '/src',
  84     'proguard_config%': '',
  85     'proguard_preprocess%': '0',
  86     'variables': {
  87       'variables': {
  88         'proguard_preprocess%': 0,
  89         'emma_never_instrument%': 0,
  90       },
  91       'conditions': [
  92         ['proguard_preprocess == 1', {
  93           'javac_jar_path': '<(intermediate_dir)/<(_target_name).pre.jar'
  94         }, {
  95           'javac_jar_path': '<(jar_path)'
  96         }],
  97         ['chromium_code != 0 and emma_coverage != 0 and emma_never_instrument == 0', {
  98           'emma_instrument': 1,
  99         }, {
 100           'emma_instrument': 0,
 101         }],
 102       ],
 103     },
 104     'emma_instrument': '<(emma_instrument)',
 105     'javac_jar_path': '<(javac_jar_path)',
 106     'conditions': [
 107       ['chromium_code == 0', {
 108         'enable_errorprone': 0,
 109       }],
 110     ],
 111     'enable_errorprone%': 0,
 112     'errorprone_exe_path': '<(PRODUCT_DIR)/bin.java/chromium_errorprone',
 113   },
 114   'conditions': [
 115     ['add_to_dependents_classpaths == 1', {
 116       # This all_dependent_settings is used for java targets only. This will add the
 117       # jar path to the classpath of dependent java targets.
 118       'all_dependent_settings': {
 119         'variables': {
 120           'input_jars_paths': ['<(jar_final_path)'],
 121           'library_dexed_jars_paths': ['<(dex_path)'],
 122           'main_dex_list_paths': ['<(main_dex_list_path)'],
 123         },
 124       },
 125     }],
 126     ['has_java_resources == 1', {
 127       'variables': {
 128         'resource_dir': '<(java_in_dir)/res',
 129         'res_input_dirs': ['<(resource_dir)', '<@(res_extra_dirs)'],
 130         'resource_input_paths': ['<!@(find <(resource_dir) -type f)'],
 131
 132         'R_dir': '<(intermediate_dir)/java_R',
 133         'R_text_file': '<(R_dir)/R.txt',
 134
 135         'generated_src_dirs': ['<(R_dir)'],
 136         'additional_input_paths': ['<(resource_zip_path)', ],
 137
 138         'dependencies_res_zip_paths': [],
 139         'resource_zip_path': '<(PRODUCT_DIR)/res.java/<(_target_name).zip',
 140       },
 141       'all_dependent_settings': {
 142         'variables': {
 143           # Dependent libraries include this target's R.java file via
 144           # generated_R_dirs.
 145           'generated_R_dirs': ['<(R_dir)'],
 146
 147           # Dependent libraries and apks include this target's resources via
 148           # dependencies_res_zip_paths.
 149           'additional_input_paths': ['<(resource_zip_path)'],
 150           'dependencies_res_zip_paths': ['<(resource_zip_path)'],
 151
 152           # additional_res_packages and additional_R_text_files are used to
 153           # create this packages R.java files when building the APK.
 154           'additional_res_packages': ['<(R_package)'],
 155           'additional_R_text_files': ['<(R_text_file)'],
 156         },
 157       },
 158       'actions': [
 159         # Generate R.java and crunch image resources.
 160         {
 161           'action_name': 'process_resources',
 162           'message': 'processing resources for <(_target_name)',
 163           'variables': {
 164             'android_manifest': '<(DEPTH)/build/android/AndroidManifest.xml',
 165             # Write the inputs list to a file, so that its mtime is updated when
 166             # the list of inputs changes.
 167             'inputs_list_file': '>|(java_resources.<(_target_name).gypcmd >@(resource_input_paths))',
 168             'process_resources_options': [],
 169             'conditions': [
 170               ['res_v14_skip == 1', {
 171                 'process_resources_options': ['--v14-skip']
 172               }],
 173             ],
 174           },
 175           'inputs': [
 176             '<(DEPTH)/build/android/gyp/util/build_utils.py',
 177             '<(DEPTH)/build/android/gyp/process_resources.py',
 178             '<(DEPTH)/build/android/gyp/generate_v14_compatible_resources.py',
 179             '>@(resource_input_paths)',
 180             '>@(dependencies_res_zip_paths)',
 181             '>(inputs_list_file)',
 182           ],
 183           'outputs': [
 184             '<(resource_zip_path)',
 185           ],
 186           'action': [
 187             'python', '<(DEPTH)/build/android/gyp/process_resources.py',
 188             '--android-sdk', '<(android_sdk)',
 189             '--aapt-path', '<(android_aapt_path)',
 190             # Need to generate onResourcesLoaded() in R.java, so could be used in java lib.
 191             '--shared-resources',
 192
 193             '--android-manifest', '<(android_manifest)',
 194             '--custom-package', '<(R_package)',
 195
 196             '--dependencies-res-zips', '>(dependencies_res_zip_paths)',
 197             '--resource-dirs', '<(res_input_dirs)',
 198
 199             '--R-dir', '<(R_dir)',
 200             '--resource-zip-out', '<(resource_zip_path)',
 201
 202             '<@(process_resources_options)',
 203           ],
 204         },
 205       ],
 206     }],
 207     ['proguard_preprocess == 1', {
 208       'actions': [
 209         {
 210           'action_name': 'proguard_<(_target_name)',
 211           'message': 'Proguard preprocessing <(_target_name) jar',
 212           'inputs': [
 213             '<(DEPTH)/third_party/proguard/lib/proguard.jar',
 214             '<(DEPTH)/build/android/gyp/util/build_utils.py',
 215             '<(DEPTH)/build/android/gyp/proguard.py',
 216             '<(javac_jar_path)',
 217             '<(proguard_config)',
 218           ],
 219           'outputs': [
 220             '<(jar_path)',
 221           ],
 222           'action': [
 223             'python', '<(DEPTH)/build/android/gyp/proguard.py',
 224             '--proguard-path=<(DEPTH)/third_party/proguard/lib/proguard.jar',
 225             '--input-path=<(javac_jar_path)',
 226             '--output-path=<(jar_path)',
 227             '--proguard-config=<(proguard_config)',
 228             '--classpath=<(android_sdk_jar) >(input_jars_paths)',
 229           ]
 230         },
 231       ],
 232     }],
 233     ['run_findbugs == 1', {
 234       'actions': [
 235         {
 236           'action_name': 'findbugs_<(_target_name)',
 237           'message': 'Running findbugs on <(_target_name)',
 238           'variables': {
 239             'additional_findbugs_args': [],
 240             'findbugs_verbose%': 0,
 241           },
 242           'conditions': [
 243             ['findbugs_verbose == 1', {
 244               'variables': {
 245                 'additional_findbugs_args+': ['-vv'],
 246               },
 247             }],
 248           ],
 249           'inputs': [
 250             '<(DEPTH)/build/android/findbugs_diff.py',
 251             '<(DEPTH)/build/android/findbugs_filter/findbugs_exclude.xml',
 252             '<(DEPTH)/build/android/pylib/utils/findbugs.py',
 253             '>@(input_jars_paths)',
 254             '<(jar_final_path)',
 255             '<(compile_stamp)',
 256           ],
 257           'outputs': [
 258             '<(findbugs_stamp)',
 259           ],
 260           'action': [
 261             'python', '<(DEPTH)/build/android/findbugs_diff.py',
 262             '--auxclasspath-gyp', '>(input_jars_paths)',
 263             '--stamp', '<(findbugs_stamp)',
 264             '<@(additional_findbugs_args)',
 265             '<(jar_final_path)',
 266           ],
 267         },
 268       ],
 269     }],
 270     ['enable_errorprone == 1', {
 271       'dependencies': [
 272         '<(DEPTH)/third_party/errorprone/errorprone.gyp:require_errorprone',
 273       ],
 274     }],
 275   ],
 276   'actions': [
 277     {
 278       'action_name': 'javac_<(_target_name)',
 279       'message': 'Compiling <(_target_name) java sources',
 280       'variables': {
 281         'extra_args': [],
 282         'extra_inputs': [],
 283         'java_sources': ['>!@(find >(java_in_dir)>(java_in_dir_suffix) >(additional_src_dirs) -name "*.java")'],
 284         'conditions': [
 285           ['enable_errorprone == 1', {
 286             'extra_inputs': [
 287               '<(errorprone_exe_path)',
 288             ],
 289             'extra_args': [ '--use-errorprone-path=<(errorprone_exe_path)' ],
 290           }],
 291         ],
 292       },
 293       'inputs': [
 294         '<(DEPTH)/build/android/gyp/util/build_utils.py',
 295         '<(DEPTH)/build/android/gyp/javac.py',
 296         '>@(java_sources)',
 297         '>@(input_jars_paths)',
 298         '>@(additional_input_paths)',
 299         '<@(extra_inputs)',
 300       ],
 301       'outputs': [
 302         '<(compile_stamp)',
 303         '<(javac_jar_path)',
 304       ],
 305       'action': [
 306         'python', '<(DEPTH)/build/android/gyp/javac.py',
 307         '--bootclasspath=<(android_sdk_jar)',
 308         '--classpath=>(input_jars_paths)',
 309         '--src-gendirs=>(generated_src_dirs)',
 310         '--javac-includes=<(javac_includes)',
 311         '--chromium-code=<(chromium_code)',
 312         '--jar-path=<(javac_jar_path)',
 313         '--jar-excluded-classes=<(jar_excluded_classes)',
 314         '--stamp=<(compile_stamp)',
 315         '>@(java_sources)',
 316         '<@(extra_args)',
 317       ]
 318     },
 319     {
 320       'action_name': 'main_dex_list_for_<(_target_name)',
 321       'variables': {
 322         'jar_path': '<(javac_jar_path)',
 323         'output_path': '<(main_dex_list_path)',
 324       },
 325       'includes': [ 'android/main_dex_action.gypi' ],
 326     },
 327     {
 328       'action_name': 'instr_jar_<(_target_name)',
 329       'message': 'Instrumenting <(_target_name) jar',
 330       'variables': {
 331         'input_path': '<(jar_path)',
 332         'output_path': '<(jar_final_path)',
 333         'stamp_path': '<(instr_stamp)',
 334         'instr_type': 'jar',
 335       },
 336       'outputs': [
 337         '<(jar_final_path)',
 338       ],
 339       'inputs': [
 340         '<(jar_path)',
 341       ],
 342       'includes': [ 'android/instr_action.gypi' ],
 343     },
 344     {
 345       'variables': {
 346         'src_dirs': [
 347           '<(java_in_dir)<(java_in_dir_suffix)',
 348           '>@(additional_src_dirs)',
 349         ],
 350         'stamp_path': '<(lint_stamp)',
 351         'result_path': '<(lint_result)',
 352         'config_path': '<(lint_config)',
 353         'lint_jar_path': '<(jar_final_path)',
 354       },
 355       'inputs': [
 356         '<(jar_final_path)',
 357         '<(compile_stamp)',
 358       ],
 359       'outputs': [
 360         '<(lint_stamp)',
 361       ],
 362       'includes': [ 'android/lint_action.gypi' ],
 363     },
 364     {
 365       'action_name': 'jar_toc_<(_target_name)',
 366       'message': 'Creating <(_target_name) jar.TOC',
 367       'inputs': [
 368         '<(DEPTH)/build/android/gyp/util/build_utils.py',
 369         '<(DEPTH)/build/android/gyp/util/md5_check.py',
 370         '<(DEPTH)/build/android/gyp/jar_toc.py',
 371         '<(jar_final_path)',
 372       ],
 373       'outputs': [
 374         '<(jar_final_path).TOC',
 375       ],
 376       'action': [
 377         'python', '<(DEPTH)/build/android/gyp/jar_toc.py',
 378         '--jar-path=<(jar_final_path)',
 379         '--toc-path=<(jar_final_path).TOC',
 380       ]
 381     },
 382     {
 383       'action_name': 'dex_<(_target_name)',
 384       'variables': {
 385         'conditions': [
 386           ['emma_instrument != 0', {
 387             'dex_no_locals': 1,
 388           }],
 389         ],
 390         'dex_input_paths': [ '<(jar_final_path)' ],
 391         'output_path': '<(dex_path)',
 392       },
 393       'includes': [ 'android/dex_action.gypi' ],
 394     },
 395   ],
 396 }