// Copyright (C) 2007 The Android Open Source Project
|
//
|
// Licensed under the Apache License, Version 2.0 (the "License");
|
// you may not use this file except in compliance with the License.
|
// You may obtain a copy of the License at
|
//
|
// http://www.apache.org/licenses/LICENSE-2.0
|
//
|
// Unless required by applicable law or agreed to in writing, software
|
// distributed under the License is distributed on an "AS IS" BASIS,
|
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
// See the License for the specific language governing permissions and
|
// limitations under the License.
|
|
//
|
// Definitions for building the Android core library and associated tests.
|
//
|
|
// The Android core library provides low-level APIs for use by the rest of the
|
// Android software stack. It is made up of various parts, some of which can be
|
// found in libcore/ and other parts that can be found in various external/
|
// directories. See the "core-system-modules" definition for the parts.
|
|
// libcore has some sub-directories that follow a common structure:
|
// e.g. dalvik, dom, harmony-tests, json, jsr166-tests, luni, libart, ojluni,
|
// support, xml, xmlpull.
|
//
|
// The structure of these is generally:
|
//
|
// src/
|
// main/ # To be shipped on every device.
|
// java/ # Java source for library code.
|
// native/ # C/C++ source for library code.
|
// resources/ # Support files.
|
// test/ # Built only on demand, for testing.
|
// java/ # Java source for tests.
|
// native/ # C/C++ source for tests (rare).
|
// resources/ # Support files.
|
//
|
// All subdirectories are optional.
|
|
build = [
|
"openjdk_java_files.bp",
|
"non_openjdk_java_files.bp",
|
]
|
|
// The Java files and their associated resources.
|
core_resource_dirs = [
|
"luni/src/main/java",
|
"ojluni/src/main/resources/",
|
]
|
|
// The source files that go into core-oj.
|
filegroup {
|
name: "core_oj_java_files",
|
srcs: [":openjdk_java_files"],
|
}
|
|
// OpenJDK source is not annotated with @hide so we need this separate
|
// filegroup for just the parts that contribute to the API.
|
filegroup {
|
name: "core_oj_api_files",
|
srcs: [":openjdk_javadoc_files"],
|
}
|
|
// The source files that go into core-libart.
|
filegroup {
|
name: "core_libart_java_files",
|
srcs: [
|
":non_openjdk_java_files",
|
":android_icu4j_src_files",
|
],
|
}
|
|
// Some parts of libart are not annotated with @hide so we need this separate
|
// filegroup for just the parts that contribute to the API.
|
filegroup {
|
name: "core_libart_api_files",
|
srcs: [
|
":non_openjdk_javadoc_files",
|
":android_icu4j_src_files",
|
],
|
}
|
|
// The set of files for the core library that have been marked up with @hide
|
// for the public SDK APIs. Used from frameworks/base/ to indicate the source
|
// files for inclusion in the public SDK docs.
|
filegroup {
|
name: "core_public_api_files",
|
srcs: [
|
":core_oj_api_files",
|
":core_libart_api_files",
|
":conscrypt_public_api_files",
|
],
|
}
|
|
// The set of files for the core library that have been marked up with @hide and
|
// API-related annotations. Note that this includes the intra-core and
|
// core-platform APIs as well as the public APIs.
|
//
|
// Some source files in :core_oj_api_files and :openjdk_mmodule_extra_files are
|
// annotated by applying annotations to the .annotated.java stubs files in
|
// ojluni/annotated/mmodules and rather than in the original source. See the comments
|
// in openjdk_java_files.bp for more details.
|
filegroup {
|
name: "core_api_files",
|
srcs: [
|
":apache-xml_api_files",
|
":bouncycastle_java_files",
|
":conscrypt_java_files",
|
":core_oj_api_files",
|
":core_libart_api_files",
|
":okhttp_api_files",
|
":openjdk_mmodule_extra_files",
|
],
|
}
|
|
java_defaults {
|
name: "libcore_java_defaults",
|
javacflags: [
|
//"-Xlint:all",
|
//"-Xlint:-serial,-deprecation,-unchecked",
|
],
|
dxflags: ["--core-library"],
|
errorprone: {
|
javacflags: [
|
"-Xep:MissingOverride:OFF", // Ignore missing @Override.
|
"-Xep:ConstantOverflow:WARN", // Known constant overflow in SplittableRandom
|
],
|
},
|
}
|
|
//
|
// Build for the target (device).
|
//
|
|
// Rule generating resource lib for android_icu4j.
|
// In the downstream branch master-icu-dev, the resource files are generated.
|
// This rule can't be moved external/icu because soong enforces that no_standard_libs:true can only
|
// be used in libcore/ or development/
|
java_library {
|
name: "android_icu4j_resources_lib",
|
java_resources: [":android_icu4j_resources"],
|
no_standard_libs: true,
|
system_modules: "none",
|
}
|
|
// A target used to bootstrap compilation for the core library.
|
// See core-all-system-modules for more details.
|
java_library {
|
name: "core-all",
|
defaults: ["libcore_java_defaults"],
|
|
srcs: [
|
":core_oj_java_files",
|
":core_libart_java_files",
|
":openjdk_lambda_stub_files",
|
],
|
|
no_standard_libs: true,
|
system_modules: "none",
|
openjdk9: {
|
srcs: ["luni/src/module/java/module-info.java"],
|
javacflags: ["--patch-module=java.base=."],
|
},
|
|
java_resource_dirs: core_resource_dirs,
|
static_libs: ["android_icu4j_resources_lib"],
|
java_version: "1.9",
|
|
installable: false,
|
}
|
|
// A system modules definition for use by core library targets only. It only
|
// contains the core-all jar, which contains the classes that end up in core-oj,
|
// core-libart as well as the lambda stubs needed to compile Java lambda code.
|
// It does not contain other parts of core library like conscrypt, bouncycastle,
|
// etc. This system_modules definition is used to bootstrap compilation for
|
// other parts of the core library like core-oj, core-libart, conscrypt,
|
// bouncycastle, etc.
|
//
|
// If you want to compile against the entire core library implementation, for
|
// example to build core library tests, see "core-system-modules" instead.
|
java_system_modules {
|
name: "core-all-system-modules",
|
libs: ["core-all"],
|
}
|
|
// Contains the parts of core library associated with OpenJDK.
|
java_library {
|
name: "core-oj",
|
defaults: ["libcore_java_defaults"],
|
installable: true,
|
hostdex: true,
|
|
srcs: [":core_oj_java_files"],
|
java_resource_dirs: core_resource_dirs,
|
|
no_standard_libs: true,
|
libs: ["core-all"],
|
system_modules: "core-all-system-modules",
|
openjdk9: {
|
javacflags: ["--patch-module=java.base=."],
|
},
|
|
jacoco: {
|
exclude_filter: [
|
"java.lang.Class",
|
"java.lang.Long",
|
"java.lang.Number",
|
"java.lang.Object",
|
"java.lang.String",
|
"java.lang.invoke.MethodHandle",
|
"java.lang.ref.Reference",
|
"java.lang.reflect.Proxy",
|
"java.util.AbstractMap",
|
"java.util.HashMap",
|
"java.util.HashMap$Node",
|
"java.util.Map",
|
],
|
},
|
|
notice: "ojluni/NOTICE",
|
|
}
|
|
// Contains parts of core library not associated with OpenJDK. Contains not
|
// just java.*, javax.* code but also android.icu.*, android.system.* and
|
// various internal libcore.* packages.
|
java_library {
|
name: "core-libart",
|
defaults: ["libcore_java_defaults"],
|
installable: true,
|
hostdex: true,
|
|
srcs: [":core_libart_java_files"],
|
static_libs: ["android_icu4j_resources_lib"],
|
java_version: "1.9",
|
|
no_standard_libs: true,
|
libs: ["core-all"],
|
system_modules: "core-all-system-modules",
|
openjdk9: {
|
javacflags: ["--patch-module=java.base=."],
|
},
|
|
jacoco: {
|
exclude_filter: [
|
"java.lang.DexCache",
|
"dalvik.system.ClassExt",
|
],
|
},
|
|
required: [
|
// Device files put in /system.
|
"tzdata",
|
"tz_version",
|
// Files used to simulate the /system and runtime APEX dir
|
// structure on host.
|
"tzdata_host",
|
"tzdata_host_runtime_apex",
|
"tzlookup.xml_host_runtime_apex",
|
"tz_version_host",
|
"tz_version_host_runtime_apex",
|
],
|
}
|
|
// Provided solely to contribute information about which hidden parts of the
|
// core-oj API are used by apps.
|
java_library {
|
name: "core-oj-hiddenapi",
|
defaults: ["libcore_java_defaults"],
|
compile_dex: true,
|
|
srcs: [":openjdk_hiddenapi_javadoc_files"],
|
|
no_standard_libs: true,
|
libs: ["core-all"],
|
system_modules: "core-all-system-modules",
|
openjdk9: {
|
javacflags: ["--patch-module=java.base=."],
|
},
|
}
|
|
//
|
// Guaranteed unstripped versions of core-oj and core-libart.
|
//
|
// The build system may or may not strip the core-oj and core-libart jars,
|
// but these will not be stripped. See b/24535627.
|
//
|
|
java_library {
|
name: "core-oj-testdex",
|
installable: true,
|
static_libs: ["core-oj"],
|
no_standard_libs: true,
|
libs: ["core-all"],
|
system_modules: "core-all-system-modules",
|
dxflags: ["--core-library"],
|
dex_preopt: {
|
enabled: false,
|
},
|
java_version: "1.9",
|
notice: "ojluni/NOTICE",
|
}
|
|
java_library {
|
name: "core-libart-testdex",
|
installable: true,
|
static_libs: ["core-libart"],
|
no_standard_libs: true,
|
libs: ["core-all"],
|
system_modules: "core-all-system-modules",
|
dxflags: ["--core-library"],
|
dex_preopt: {
|
enabled: false,
|
},
|
notice: "ojluni/NOTICE",
|
}
|
|
|
java_defaults {
|
name: "core_lambda_stubs_defaults",
|
defaults: ["libcore_java_defaults"],
|
hostdex: true,
|
|
no_standard_libs: true,
|
libs: ["core-all"],
|
system_modules: "core-all-system-modules",
|
openjdk9: {
|
javacflags: ["--patch-module=java.base=."],
|
},
|
|
notice: "ojluni/NOTICE",
|
|
installable: false,
|
include_srcs: true,
|
}
|
|
// Creates a jar that exists to satisfy javac when compiling source code that
|
// contains lambdas. This contains all classes / methods required by javac
|
// when generating invoke-dynamic lambda implementation code, even those that
|
// are also in the public SDK API from API level 26 onwards.
|
java_library {
|
name: "core-lambda-stubs",
|
defaults: ["core_lambda_stubs_defaults"],
|
srcs: [
|
":openjdk_lambda_stub_files",
|
":openjdk_lambda_duplicate_stub_files",
|
],
|
}
|
|
// An alternative to core-lambda-stubs that omits openjdk_lambda_duplicate_stub_files
|
// because those classes are also part of the core library public SDK API
|
// (since API level 26).
|
java_library {
|
name: "core-lambda-stubs-for-system-modules",
|
defaults: ["core_lambda_stubs_defaults"],
|
srcs: [
|
":openjdk_lambda_stub_files",
|
],
|
}
|
|
// A system modules definition containing the implementations for the various
|
// parts that make up the core library.
|
//
|
// This system module is intended for use by tests that may need access to
|
// core library internals. It should not be generally used; most of the
|
// platform build should build against API stubs instead. See
|
// "core-platform-api-stubs-system-modules", which is the default used by the
|
// Android build.
|
//
|
// This module also includes lambda stubs for compiling source containing
|
// Java lambdas.
|
java_system_modules {
|
name: "core-system-modules",
|
libs: [
|
"core-oj",
|
"core-libart",
|
"bouncycastle",
|
"conscrypt",
|
"okhttp",
|
"apache-xml",
|
// This one is not on device but it's needed when javac compiles code
|
// containing lambdas.
|
"core-lambda-stubs-for-system-modules",
|
],
|
}
|
|
// Builds libcore test rules
|
java_library_static {
|
name: "core-test-rules",
|
hostdex: true,
|
srcs: [
|
"dalvik/test-rules/src/main/**/*.java",
|
"test-rules/src/main/**/*.java",
|
],
|
static_libs: ["junit"],
|
|
no_standard_libs: true,
|
libs: ["core-all"],
|
system_modules: "core-all-system-modules",
|
}
|
|
// Builds the core-tests-support library used by various tests.
|
java_library_static {
|
name: "core-tests-support",
|
hostdex: true,
|
srcs: ["support/src/test/java/**/*.java"],
|
|
no_framework_libs: true,
|
libs: ["junit"],
|
static_libs: [
|
"bouncycastle-unbundled",
|
"bouncycastle-bcpkix-unbundled",
|
"bouncycastle-ocsp-unbundled",
|
],
|
}
|
|
// Builds the jsr166-tests library.
|
java_test {
|
name: "jsr166-tests",
|
srcs: ["jsr166-tests/src/test/java/**/*.java"],
|
no_standard_libs: true,
|
libs: [
|
"core-all",
|
"junit",
|
],
|
system_modules: "core-all-system-modules",
|
}
|
|
// Builds a library just containing files from luni/src/test/filesystems
|
// for use in tests.
|
java_library {
|
name: "filesystemstest",
|
compile_dex: true,
|
srcs: ["luni/src/test/filesystems/src/**/*.java"],
|
java_resource_dirs: ["luni/src/test/filesystems/resources"],
|
no_framework_libs: true,
|
errorprone: {
|
javacflags: ["-Xep:MissingOverride:OFF"],
|
},
|
}
|
|
// Builds a library just containing files from luni/src/test/parameter_metadata
|
// for use in tests.
|
java_library {
|
name: "parameter-metadata-test",
|
compile_dex: true,
|
srcs: ["luni/src/test/parameter_metadata/src/**/*.java"],
|
no_framework_libs: true,
|
javacflags: ["-parameters"],
|
errorprone: {
|
javacflags: ["-Xep:MissingOverride:OFF"],
|
},
|
}
|
|
// Builds the core-tests library.
|
java_test {
|
name: "core-tests",
|
defaults: ["libcore_java_defaults"],
|
hostdex: true,
|
srcs: [
|
"dalvik/src/test/java/**/*.java",
|
"dalvik/test-rules/src/test/java/**/*.java",
|
"dom/src/test/java/**/*.java",
|
"harmony-tests/src/test/java/**/*.java",
|
"json/src/test/java/**/*.java",
|
"luni/src/test/java/**/*.java",
|
"test-rules/src/test/java/**/*.java",
|
"xml/src/test/java/**/*.java",
|
],
|
exclude_srcs: [
|
"luni/src/test/java/libcore/java/util/zip/Zip64Test.java",
|
"luni/src/test/java/libcore/java/util/zip/Zip64FileTest.java",
|
],
|
|
java_resource_dirs: [
|
"*/src/test/java",
|
"*/src/test/resources",
|
],
|
exclude_java_resource_dirs: [
|
"ojluni/src/test/java",
|
"ojluni/src/test/resources",
|
],
|
|
java_resources: [
|
":filesystemstest",
|
":parameter-metadata-test",
|
],
|
|
no_standard_libs: true,
|
libs: [
|
"core-all",
|
"okhttp",
|
"bouncycastle",
|
],
|
system_modules: "core-all-system-modules",
|
|
static_libs: [
|
"archive-patcher",
|
"core-test-rules",
|
"core-tests-support",
|
"junit-params",
|
"mockftpserver",
|
"mockito-target",
|
"mockwebserver",
|
"nist-pkix-tests",
|
"slf4j-jdk14",
|
"sqlite-jdbc",
|
"tzdata-testing",
|
"truth-prebuilt",
|
],
|
|
errorprone: {
|
javacflags: [
|
"-Xep:TryFailThrowable:ERROR",
|
"-Xep:ComparisonOutOfRange:ERROR",
|
],
|
},
|
|
test_config: "AndroidTest-core-tests.xml",
|
}
|
|
// Builds the core-ojtests library that contains test code from OpenJDK.
|
java_test {
|
name: "core-ojtests",
|
defaults: ["libcore_java_defaults"],
|
hostdex: true,
|
|
srcs: [
|
"ojluni/src/test/java/**/*.java",
|
],
|
java_resource_dirs: [
|
"ojluni/src/test/java",
|
"ojluni/src/test/resources",
|
],
|
|
no_standard_libs: true,
|
libs: [
|
"core-all",
|
"okhttp",
|
"bouncycastle",
|
],
|
system_modules: "core-all-system-modules",
|
|
static_libs: ["testng"],
|
|
// ojluni/src/test/java/util/stream/{bootlib,boottest}
|
// contains tests that are in packages from java.base;
|
// By default, OpenJDK 9's javac will only compile such
|
// code if it's declared to also be in java.base at
|
// compile time.
|
//
|
// For now, we use --patch-module to put all sources
|
// and dependencies from this make target into java.base;
|
// other source directories in this make target are in
|
// packages not from java.base; if this becomes a problem
|
// in future, this could be addressed eg. by splitting
|
// boot{lib,test} out into a separate make target,
|
// deleting those tests or moving them to a different
|
// package.
|
patch_module: "java.base",
|
}
|
|
// Builds the core-ojtests-public library. Excludes any private API tests.
|
// Like core-ojtests but smaller.
|
java_test {
|
name: "core-ojtests-public",
|
defaults: ["libcore_java_defaults"],
|
srcs: [
|
"ojluni/src/test/java/**/*.java",
|
],
|
// Filter out the following:
|
// 1.) DeserializeMethodTest and SerializedLambdaTest, because they depends on stub classes
|
// and won't actually run, and
|
// 2.) util/stream/boot*. Those directories contain classes in the package java.util.stream;
|
// excluding them means we don't need patch_module: "java.base"
|
exclude_srcs: [
|
"**/DeserializeMethodTest.java",
|
"**/SerializedLambdaTest.java",
|
"ojluni/src/test/java/util/stream/boot*/**/*",
|
],
|
java_resource_dirs: [
|
"ojluni/src/test/java",
|
"ojluni/src/test/resources",
|
// Include source code as part of JAR
|
"ojluni/src/test/dist",
|
],
|
|
no_standard_libs: true,
|
libs: [
|
"core-all",
|
"bouncycastle",
|
"okhttp",
|
"testng",
|
],
|
system_modules: "core-all-system-modules",
|
}
|
|
// Exports annotated stubs source files in ojluni/annotations/sdk to make them
|
// available to metalava. Used for nullability annotations in OpenJDK source.
|
droiddoc_exported_dir {
|
name: "ojluni-annotated-sdk-stubs",
|
path: "ojluni/annotations/sdk",
|
}
|
droiddoc_exported_dir {
|
name: "ojluni-annotated-nullability-stubs",
|
path: "ojluni/annotations/sdk/nullability",
|
}
|
|
// Exports annotated stubs source files in ojluni/annotations/mmodules to make
|
// them available to metalava. Used for core platform API and intra-code API
|
// annotations in OpenJDK source.
|
droiddoc_exported_dir {
|
name: "ojluni-annotated-mmodule-stubs",
|
path: "ojluni/annotations/mmodule",
|
}
|
|
// A file containing the list of tags that are "known" to us from the OpenJdk
|
// source code and so should not cause an error or warning.
|
filegroup {
|
name: "known-oj-tags",
|
srcs: [
|
"known_oj_tags.txt",
|
],
|
}
|
|
// Generates stubs for the parts of the public SDK API provided by the core
|
// library.
|
//
|
// Only for use by core.current.stubs target below.
|
droidstubs {
|
name: "core-current-stubs-gen",
|
srcs: [":core_api_files"],
|
java_version: "1.9",
|
installable: false,
|
no_framework_libs: true,
|
args: " --exclude-annotations "
|
+ "--hide-annotation libcore.api.Hide",
|
merge_inclusion_annotations_dirs: ["ojluni-annotated-mmodule-stubs"],
|
}
|
|
// A stubs target containing the parts of the public SDK API provided by the
|
// core library.
|
//
|
// Don't use this directly, use "sdk_version: core_current".
|
java_library {
|
name: "core.current.stubs",
|
srcs: [":core-current-stubs-gen"],
|
errorprone: {
|
javacflags: [
|
"-Xep:MissingOverride:OFF",
|
],
|
},
|
openjdk9: {
|
javacflags: ["--patch-module=java.base=."],
|
},
|
no_standard_libs: true,
|
system_modules: "none",
|
|
dist: {
|
targets: [
|
"sdk",
|
"win_sdk",
|
],
|
},
|
}
|
|
// Target for validating nullability annotations for correctness and
|
// completeness. To check that there are no nullability errors:
|
// make core-current-stubs-nullability-validation
|
// To check that there are only the expected nullability warnings:
|
// make core-current-stubs-nullability-validation-check-nullability-warnings
|
// To update the the list of known expected nullability warnings:
|
// make core-current-stubs-nullability-validation-update-nullability-warnings
|
droidstubs {
|
name: "core-current-stubs-nullability-validation",
|
srcs: [":core_api_files"],
|
installable: false,
|
no_framework_libs: true,
|
annotations_enabled: true,
|
args: "--hide-annotation libcore.api.Hide " +
|
"--validate-nullability-from-merged-stubs ",
|
merge_inclusion_annotations_dirs: ["ojluni-annotated-mmodule-stubs"],
|
merge_annotations_dirs: [
|
"metalava-manual",
|
// N.B. Stubs in this filegroup will be validated:
|
"ojluni-annotated-nullability-stubs",
|
],
|
// The list of classes which have nullability annotations included in the source.
|
// (This is in addition to those which have annotations in the merged stubs.)
|
validate_nullability_from_list: "nullability_annotated_classes.txt",
|
// The expected set of warnings about missing annotations:
|
check_nullability_warnings: "nullability_warnings.txt",
|
}
|
|
// A host library containing time zone related classes. Used for
|
// host-side tools and tests that have to deal with Android
|
// time zone data.
|
java_library_host {
|
name: "timezone-host",
|
srcs: [":timezone_host_files"],
|
}
|
