1// Copyright 2014 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 5package org.chromium.base.library_loader; 6 7public 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/base/library_loader/NativeLibraries.java 17 * 18 * This file is used to build base.jar, which is the library 19 * jar used by chromium projects. However, the 20 * corresponding NativeLibraries.class file will _not_ be part 21 * of the final base.jar. 22 * 23 * o .../$PROJECT/native_libraries_java/NativeLibraries.java 24 * 25 * This file is used to build an 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 'base.jar', and could not be specialized 36 * for every chromium program. This, however, doesn't apply to arrays of 37 * strings, which can be defined as final. 38 * 39 * This exotic scheme is used to avoid injecting project-specific, or 40 * even build-specific, values into the base layer. E.g. this is 41 * how the component build is supported on Android without modifying 42 * the sources of each and every Chromium-based target. 43 */ 44 45#if defined(ENABLE_CHROMIUM_LINKER_LIBRARY_IN_ZIP_FILE) && \ 46 !defined(ENABLE_CHROMIUM_LINKER) 47#error "Must have ENABLE_CHROMIUM_LINKER to enable library in zip file" 48#endif 49 50 // Set to true to enable the use of the Chromium Linker. 51#if defined(ENABLE_CHROMIUM_LINKER) 52 public static boolean USE_LINKER = true; 53#else 54 public static boolean USE_LINKER = false; 55#endif 56 57#if defined(ENABLE_CHROMIUM_LINKER_LIBRARY_IN_ZIP_FILE) 58 public static boolean USE_LIBRARY_IN_ZIP_FILE = true; 59#else 60 public static boolean USE_LIBRARY_IN_ZIP_FILE = false; 61#endif 62 63#if defined(ENABLE_CHROMIUM_LINKER_TESTS) 64 public static boolean ENABLE_LINKER_TESTS = true; 65#else 66 public static boolean ENABLE_LINKER_TESTS = false; 67#endif 68 69 // This is the list of native libraries to be loaded (in the correct order) 70 // by LibraryLoader.java. The base java library is compiled with no 71 // array defined, and then the build system creates a version of the file 72 // with the real list of libraries required (which changes based upon which 73 // .apk is being built). 74 // TODO(cjhopman): This is public since it is referenced by ChromeNativeTestActivity.java 75 // directly. The two ways of library loading should be refactored into one. 76 public static final String[] LIBRARIES = 77#if defined(NATIVE_LIBRARIES_LIST) 78 NATIVE_LIBRARIES_LIST; 79#else 80 {}; 81#endif 82 83 // This is the expected version of the 'main' native library, which is the one that 84 // implements the initial set of base JNI functions including 85 // base::android::nativeGetVersionName() 86 static String VERSION_NUMBER = 87#if defined(NATIVE_LIBRARIES_VERSION_NUMBER) 88 NATIVE_LIBRARIES_VERSION_NUMBER; 89#else 90 ""; 91#endif 92} 93