1 // Copyright 2013 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.
5 package org.chromium.content.app;
7 public class NativeLibraries {
9 * IMPORTANT NOTE: The variables defined here must _not_ be 'final'.
11 * The reason for this is very subtle:
13 * - This template is used to generate several distinct, but similar
14 * files used in different contexts:
16 * o .../gen/templates/org/chromium/content/app/NativeLibraries.java
18 * This file is used to build content.jar, which is the library
19 * jar used by several content-based projects. However, the
20 * corresponding NativeLibraries.class file will _not_ be part
21 * of the final content.jar.
23 * o .../$PROJECT/native_libraries_java/NativeLibraries.java
25 * This file is used to build a content-based APK (e.g. $PROJECT
26 * could be 'content_shell_apk'). Its content will depend on
27 * this target's specific build configuration, and differ from
28 * the source file above.
30 * - During the final link, all .jar files are linked together into
31 * a single .dex file, and the second version of NativeLibraries.class
32 * will be put into the final output file, and used at runtime.
34 * - If the variables were defined as 'final', their value would be
35 * optimized out inside of 'content.jar', and could not be specialized
36 * for every content-based program.
38 * This exotic scheme is used to avoid injecting project-specific, or
39 * even build-specific, values into the content layer. E.g. this is
40 * how the component build is supported on Android without modifying
41 * the sources of each and every Chromium-based target.
43 // Set to true to enable the use of the content Linker.
44 #if defined(ENABLE_CONTENT_LINKER)
45 public static boolean USE_LINKER = true;
47 public static boolean USE_LINKER = false;
50 #if defined(ENABLE_CONTENT_LINKER_TESTS)
51 public static boolean ENABLE_LINKER_TESTS = true;
53 public static boolean ENABLE_LINKER_TESTS = false;
56 // This is the list of native libraries to be loaded (in the correct order)
57 // by LibraryLoader.java. The content java library is compiled with no
58 // array defined, and then the build system creates a version of the file
59 // with the real list of libraries required (which changes based upon which
60 // .apk is being built).
61 // TODO(cjhopman): This is public since it is referenced by ChromeNativeTestActivity.java
62 // directly. The two ways of library loading should be refactored into one.
63 public static String[] libraries
64 #include <native_libraries_array.h>