OLD | NEW |
| (Empty) |
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. | |
4 | |
5 package org.chromium.content.app; | |
6 | |
7 public class NativeLibraries { | |
8 /** | |
9 * IMPORTANT NOTE: The variables defined here must _not_ be 'final'. | |
10 * | |
11 * The reason for this is very subtle: | |
12 * | |
13 * - This template is used to generate several distinct, but similar | |
14 * files used in different contexts: | |
15 * | |
16 * o .../gen/templates/org/chromium/content/app/NativeLibraries.java | |
17 * | |
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. | |
22 * | |
23 * o .../$PROJECT/native_libraries_java/NativeLibraries.java | |
24 * | |
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. | |
29 * | |
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. | |
33 * | |
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. | |
37 * | |
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. | |
42 */ | |
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; | |
46 #else | |
47 public static boolean USE_LINKER = false; | |
48 #endif | |
49 | |
50 #if defined(ENABLE_CONTENT_LINKER_TESTS) | |
51 public static boolean ENABLE_LINKER_TESTS = true; | |
52 #else | |
53 public static boolean ENABLE_LINKER_TESTS = false; | |
54 #endif | |
55 | |
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 ChromeNativeTest
Activity.java | |
62 // directly. The two ways of library loading should be refactored into one. | |
63 public static final String[] LIBRARIES | |
64 #include <native_libraries_array.h> | |
65 ; | |
66 // This is the expected version of the 'main' native library, which is the o
ne that | |
67 // implements the initial set of content JNI functions including | |
68 // content::nativeGetVersionName() | |
69 // Note(aberent): This is logically final, but making it final breaks the bu
ild, since it | |
70 // lets other Java components read its value at compile time rather than at
run time, hence | |
71 // reading it from the wrong class file. | |
72 static String VERSION_NUMBER | |
73 #include <native_libraries_version.h> | |
74 ; | |
75 } | |
OLD | NEW |