490 lines
16 KiB
Plaintext
490 lines
16 KiB
Plaintext
// Copyright (C) 2019 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.
|
|
|
|
// How stubs are generated:
|
|
//
|
|
// raw source files --(metalava)--> stub source files --(javac)--> stub jar files
|
|
//
|
|
// The metalava conversion is done by droidstub modules *-api-stubs-docs.
|
|
// The javac compilation is done by java_library modules android_*_stubs_current.
|
|
// The metalava conversion is also responsible for creating API signature files
|
|
// and comparing them against the last API signature in api/*-current.txt files
|
|
// and also against the latest frozen API signature in prebuilts/sdk/*/*/api/android.txt
|
|
// files.
|
|
|
|
/////////////////////////////////////////////////////////////////////
|
|
// Common metalava configs
|
|
/////////////////////////////////////////////////////////////////////
|
|
|
|
packages_to_document = [
|
|
"android",
|
|
"dalvik",
|
|
"java",
|
|
"javax",
|
|
"junit",
|
|
"org.apache.http",
|
|
"org.json",
|
|
"org.w3c.dom",
|
|
"org.xml.sax",
|
|
"org.xmlpull",
|
|
]
|
|
|
|
stubs_defaults {
|
|
name: "metalava-base-api-stubs-default",
|
|
srcs: [
|
|
":framework-non-updatable-sources",
|
|
"core/java/**/*.logtags",
|
|
":opt-telephony-srcs",
|
|
":opt-net-voip-srcs",
|
|
":art.module.public.api{.public.stubs.source}",
|
|
":android_icu4j_public_api_files",
|
|
"**/package.html",
|
|
],
|
|
// TODO(b/147699819): remove below aidl includes.
|
|
aidl: {
|
|
local_include_dirs: ["telephony/java"],
|
|
},
|
|
// These are libs from framework-internal-utils that are required (i.e. being referenced)
|
|
// from framework-non-updatable-sources. Add more here when there's a need.
|
|
// DO NOT add the entire framework-internal-utils. It might cause unnecessary circular
|
|
// dependencies gets bigger.
|
|
libs: [
|
|
"android.hardware.cas-V1.2-java",
|
|
"android.hardware.health-V1.0-java-constants",
|
|
"android.hardware.radio-V1.5-java",
|
|
"android.hardware.thermal-V1.0-java-constants",
|
|
"android.hardware.thermal-V2.0-java",
|
|
"android.hardware.tv.input-V1.0-java-constants",
|
|
"android.hardware.tv.tuner-V1.0-java-constants",
|
|
"android.hardware.usb-V1.0-java-constants",
|
|
"android.hardware.usb-V1.1-java-constants",
|
|
"android.hardware.usb.gadget-V1.0-java",
|
|
"android.hardware.vibrator-V1.3-java",
|
|
"framework-protos",
|
|
],
|
|
high_mem: true, // Lots of sources => high memory use, see b/170701554
|
|
installable: false,
|
|
annotations_enabled: true,
|
|
previous_api: ":android.api.public.latest",
|
|
merge_annotations_dirs: [
|
|
"metalava-manual",
|
|
],
|
|
api_levels_annotations_enabled: false,
|
|
filter_packages: packages_to_document,
|
|
}
|
|
|
|
stubs_defaults {
|
|
name: "metalava-full-api-stubs-default",
|
|
defaults: ["metalava-base-api-stubs-default"],
|
|
srcs: [
|
|
":conscrypt.module.public.api{.public.stubs.source}",
|
|
":framework-updatable-sources",
|
|
],
|
|
sdk_version: "core_platform",
|
|
}
|
|
|
|
stubs_defaults {
|
|
name: "metalava-non-updatable-api-stubs-default",
|
|
defaults: ["metalava-base-api-stubs-default"],
|
|
sdk_version: "core_platform",
|
|
// There are a few classes from modules used as type arguments that
|
|
// need to be resolved by metalava. For now, we can use a previously
|
|
// finalized stub library to resolve them. If a new class gets added,
|
|
// this may be need to be revisited to use a manually maintained stub
|
|
// library with empty classes in order to resolve those references.
|
|
libs: ["sdk_system_30_android"],
|
|
aidl: {
|
|
local_include_dirs: ["apex/media/aidl/stable"],
|
|
},
|
|
}
|
|
|
|
/////////////////////////////////////////////////////////////////////
|
|
// *-api-stubs-docs modules providing source files for the stub libraries
|
|
/////////////////////////////////////////////////////////////////////
|
|
|
|
// api-stubs-docs, system-api-stubs-docs, and test-api-stubs-docs have APIs
|
|
// from the non-updatable part of the platform as well as from the updatable
|
|
// modules
|
|
droidstubs {
|
|
name: "api-stubs-docs",
|
|
defaults: ["metalava-full-api-stubs-default"],
|
|
arg_files: [
|
|
"core/res/AndroidManifest.xml",
|
|
],
|
|
args: metalava_framework_docs_args,
|
|
check_api: {
|
|
current: {
|
|
api_file: "api/current.txt",
|
|
removed_api_file: "api/removed.txt",
|
|
},
|
|
last_released: {
|
|
api_file: ":android.api.public.latest",
|
|
removed_api_file: ":removed.api.public.latest",
|
|
baseline_file: ":public-api-incompatibilities-with-last-released",
|
|
},
|
|
api_lint: {
|
|
enabled: true,
|
|
new_since: ":android.api.public.latest",
|
|
baseline_file: "api/lint-baseline.txt",
|
|
},
|
|
},
|
|
}
|
|
|
|
droidstubs {
|
|
name: "api-stubs-docs-non-updatable",
|
|
defaults: ["metalava-non-updatable-api-stubs-default"],
|
|
arg_files: ["core/res/AndroidManifest.xml"],
|
|
args: metalava_framework_docs_args,
|
|
check_api: {
|
|
current: {
|
|
api_file: "core/api/current.txt",
|
|
removed_api_file: "core/api/removed.txt",
|
|
},
|
|
last_released: {
|
|
api_file: ":android-non-updatable.api.public.latest",
|
|
removed_api_file: ":android-non-updatable-removed.api.public.latest",
|
|
baseline_file: ":public-api-incompatibilities-with-last-released",
|
|
},
|
|
api_lint: {
|
|
enabled: true,
|
|
new_since: ":android-non-updatable.api.public.latest",
|
|
},
|
|
},
|
|
}
|
|
|
|
priv_apps = " " +
|
|
"--show-annotation android.annotation.SystemApi\\(" +
|
|
"client=android.annotation.SystemApi.Client.PRIVILEGED_APPS" +
|
|
"\\) "
|
|
|
|
module_libs = " " +
|
|
" --show-annotation android.annotation.SystemApi\\(" +
|
|
"client=android.annotation.SystemApi.Client.MODULE_LIBRARIES" +
|
|
"\\)" +
|
|
" --show-for-stub-purposes-annotation android.annotation.SystemApi\\(" +
|
|
"client=android.annotation.SystemApi.Client.PRIVILEGED_APPS" +
|
|
"\\) "
|
|
|
|
droidstubs {
|
|
name: "system-api-stubs-docs",
|
|
defaults: ["metalava-full-api-stubs-default"],
|
|
arg_files: [
|
|
"core/res/AndroidManifest.xml",
|
|
],
|
|
args: metalava_framework_docs_args + priv_apps,
|
|
check_api: {
|
|
current: {
|
|
api_file: "api/system-current.txt",
|
|
removed_api_file: "api/system-removed.txt",
|
|
},
|
|
last_released: {
|
|
api_file: ":android.api.system.latest",
|
|
removed_api_file: ":removed.api.system.latest",
|
|
baseline_file: ":system-api-incompatibilities-with-last-released"
|
|
},
|
|
api_lint: {
|
|
enabled: true,
|
|
new_since: ":android.api.system.latest",
|
|
baseline_file: "api/system-lint-baseline.txt",
|
|
},
|
|
},
|
|
}
|
|
|
|
droidstubs {
|
|
name: "system-api-stubs-docs-non-updatable",
|
|
defaults: ["metalava-non-updatable-api-stubs-default"],
|
|
arg_files: ["core/res/AndroidManifest.xml"],
|
|
args: metalava_framework_docs_args + priv_apps,
|
|
check_api: {
|
|
current: {
|
|
api_file: "core/api/system-current.txt",
|
|
removed_api_file: "core/api/system-removed.txt",
|
|
},
|
|
last_released: {
|
|
api_file: ":android-non-updatable.api.system.latest",
|
|
removed_api_file: ":android-non-updatable-removed.api.system.latest",
|
|
baseline_file: ":system-api-incompatibilities-with-last-released"
|
|
},
|
|
api_lint: {
|
|
enabled: true,
|
|
new_since: ":android-non-updatable.api.system.latest",
|
|
baseline_file: "core/api/system-lint-baseline.txt",
|
|
},
|
|
},
|
|
}
|
|
|
|
droidstubs {
|
|
name: "test-api-stubs-docs",
|
|
defaults: ["metalava-non-updatable-api-stubs-default"],
|
|
arg_files: [
|
|
"core/res/AndroidManifest.xml",
|
|
],
|
|
args: metalava_framework_docs_args
|
|
+ " --show-annotation android.annotation.TestApi"
|
|
+ " --show-for-stub-purposes-annotation android.annotation.SystemApi\\("
|
|
+ "client=android.annotation.SystemApi.Client.PRIVILEGED_APPS"
|
|
+ "\\)",
|
|
check_api: {
|
|
current: {
|
|
api_file: "api/test-current.txt",
|
|
removed_api_file: "api/test-removed.txt",
|
|
},
|
|
api_lint: {
|
|
enabled: true,
|
|
baseline_file: "api/test-lint-baseline.txt",
|
|
},
|
|
},
|
|
dist: {
|
|
targets: ["sdk", "win_sdk"],
|
|
dir: "apistubs/android/test/api",
|
|
dest: "android.txt",
|
|
},
|
|
}
|
|
|
|
/////////////////////////////////////////////////////////////////////
|
|
// Following droidstub module for extra APIs for modules,
|
|
// namely @SystemApi(client=MODULE_LIBRARIES) APIs.
|
|
/////////////////////////////////////////////////////////////////////
|
|
|
|
droidstubs {
|
|
name: "module-lib-api-stubs-docs-non-updatable",
|
|
defaults: ["metalava-non-updatable-api-stubs-default"],
|
|
arg_files: ["core/res/AndroidManifest.xml"],
|
|
args: metalava_framework_docs_args + priv_apps + module_libs,
|
|
check_api: {
|
|
current: {
|
|
api_file: "core/api/module-lib-current.txt",
|
|
removed_api_file: "core/api/module-lib-removed.txt",
|
|
},
|
|
last_released: {
|
|
api_file: ":android-non-updatable.api.module-lib.latest",
|
|
removed_api_file: ":android-non-updatable-removed.api.module-lib.latest",
|
|
},
|
|
api_lint: {
|
|
enabled: true,
|
|
new_since: ":android-non-updatable.api.module-lib.latest",
|
|
},
|
|
},
|
|
}
|
|
|
|
/////////////////////////////////////////////////////////////////////
|
|
// android_*_stubs_current modules are the stubs libraries compiled
|
|
// from *-api-stubs-docs
|
|
/////////////////////////////////////////////////////////////////////
|
|
|
|
java_defaults {
|
|
name: "android_defaults_stubs_current",
|
|
libs: [ "stub-annotations" ],
|
|
static_libs: [
|
|
// License notices from art module
|
|
"art-notices-for-framework-stubs-jar",
|
|
"framework-res-package-jar", // Export package of framework-res
|
|
],
|
|
errorprone: {
|
|
javacflags: [
|
|
"-XepDisableAllChecks",
|
|
],
|
|
},
|
|
sdk_version: "none",
|
|
system_modules: "none",
|
|
java_version: "1.8",
|
|
compile_dex: true,
|
|
}
|
|
|
|
java_defaults {
|
|
name: "android_stubs_dists_default",
|
|
dist: {
|
|
targets: ["sdk", "win_sdk"],
|
|
tag: ".jar",
|
|
dest: "android.jar",
|
|
},
|
|
}
|
|
|
|
java_library_static {
|
|
name: "android_monolith_stubs_current",
|
|
srcs: [ ":api-stubs-docs" ],
|
|
static_libs: [ "private-stub-annotations-jar" ],
|
|
defaults: ["android_defaults_stubs_current"],
|
|
}
|
|
|
|
java_library_static {
|
|
name: "android_merged_stubs_current",
|
|
srcs: [ ":api-stubs-docs-non-updatable" ],
|
|
static_libs: [
|
|
"conscrypt.module.public.api.stubs",
|
|
"framework-media.stubs",
|
|
"framework-mediaprovider.stubs",
|
|
"framework-permission.stubs",
|
|
"framework-sdkextensions.stubs",
|
|
"framework-statsd.stubs",
|
|
"framework-tethering.stubs",
|
|
"framework-wifi.stubs",
|
|
"private-stub-annotations-jar",
|
|
],
|
|
defaults: ["android_defaults_stubs_current"],
|
|
}
|
|
|
|
java_library_static {
|
|
name: "android_stubs_current",
|
|
static_libs: ["android_merged_stubs_current"],
|
|
defaults: ["android_defaults_stubs_current"],
|
|
}
|
|
|
|
java_library_static {
|
|
name: "android_system_monolith_stubs_current",
|
|
srcs: [ ":system-api-stubs-docs" ],
|
|
static_libs: [ "private-stub-annotations-jar" ],
|
|
defaults: [
|
|
"android_defaults_stubs_current",
|
|
"android_stubs_dists_default",
|
|
],
|
|
dist: {
|
|
dir: "apistubs/android/system",
|
|
},
|
|
dists: [
|
|
{
|
|
// Legacy dist path
|
|
targets: ["sdk", "win_sdk"],
|
|
tag: ".jar",
|
|
dest: "android_system.jar",
|
|
},
|
|
],
|
|
}
|
|
|
|
java_library_static {
|
|
name: "android_system_merged_stubs_current",
|
|
srcs: [ ":system-api-stubs-docs-non-updatable" ],
|
|
static_libs: [
|
|
"conscrypt.module.public.api.stubs",
|
|
"framework-media.stubs.system",
|
|
"framework-mediaprovider.stubs.system",
|
|
"framework-permission.stubs.system",
|
|
"framework-sdkextensions.stubs.system",
|
|
"framework-statsd.stubs.system",
|
|
"framework-tethering.stubs.system",
|
|
"framework-wifi.stubs.system",
|
|
"private-stub-annotations-jar",
|
|
],
|
|
defaults: ["android_defaults_stubs_current"],
|
|
}
|
|
|
|
java_library_static {
|
|
name: "android_system_stubs_current",
|
|
static_libs: ["android_system_merged_stubs_current"],
|
|
defaults: ["android_defaults_stubs_current"],
|
|
}
|
|
|
|
java_library_static {
|
|
name: "android_test_stubs_current",
|
|
srcs: [ ":test-api-stubs-docs" ],
|
|
static_libs: [
|
|
// Modules do not have test APIs, but we want to include their SystemApis, like we include
|
|
// the SystemApi of framework-non-updatable-sources.
|
|
"conscrypt.module.public.api.stubs",
|
|
"framework-media.stubs.system",
|
|
"framework-mediaprovider.stubs.system",
|
|
"framework-permission.stubs.system",
|
|
"framework-sdkextensions.stubs.system",
|
|
"framework-statsd.stubs.system",
|
|
"framework-tethering.stubs.system",
|
|
"framework-wifi.stubs.system",
|
|
"private-stub-annotations-jar",
|
|
],
|
|
defaults: [
|
|
"android_defaults_stubs_current",
|
|
"android_stubs_dists_default",
|
|
],
|
|
dist: {
|
|
dir: "apistubs/android/test",
|
|
},
|
|
dists: [
|
|
{
|
|
// Legacy dist path
|
|
targets: ["sdk", "win_sdk"],
|
|
tag: ".jar",
|
|
dest: "android_test.jar",
|
|
},
|
|
],
|
|
}
|
|
|
|
java_library_static {
|
|
name: "android_module_lib_stubs_current",
|
|
srcs: [ ":module-lib-api-stubs-docs-non-updatable" ],
|
|
defaults: [
|
|
"android_defaults_stubs_current",
|
|
"android_stubs_dists_default",
|
|
],
|
|
libs: ["sdk_system_29_android"],
|
|
dist: {
|
|
dir: "apistubs/android/module-lib",
|
|
},
|
|
}
|
|
|
|
java_library_static {
|
|
name: "android_non_updatable_stubs_current",
|
|
srcs: [":api-stubs-docs-non-updatable"],
|
|
defaults: ["android_defaults_stubs_current"],
|
|
libs: ["sdk_system_29_android"],
|
|
}
|
|
|
|
java_library_static {
|
|
name: "android_system_non_updatable_stubs_current",
|
|
srcs: [":system-api-stubs-docs-non-updatable"],
|
|
defaults: ["android_defaults_stubs_current"],
|
|
libs: ["sdk_system_29_android"],
|
|
}
|
|
|
|
/////////////////////////////////////////////////////////////////////
|
|
// hwbinder.stubs provides APIs required for building HIDL Java
|
|
// libraries.
|
|
/////////////////////////////////////////////////////////////////////
|
|
|
|
droidstubs {
|
|
name: "hwbinder-stubs-docs",
|
|
srcs: [
|
|
"core/java/android/os/HidlSupport.java",
|
|
"core/java/android/annotation/IntDef.java",
|
|
"core/java/android/annotation/IntRange.java",
|
|
"core/java/android/annotation/NonNull.java",
|
|
"core/java/android/annotation/SystemApi.java",
|
|
"core/java/android/os/HidlMemory.java",
|
|
"core/java/android/os/HwBinder.java",
|
|
"core/java/android/os/HwBlob.java",
|
|
"core/java/android/os/HwParcel.java",
|
|
"core/java/android/os/IHwBinder.java",
|
|
"core/java/android/os/IHwInterface.java",
|
|
"core/java/android/os/DeadObjectException.java",
|
|
"core/java/android/os/DeadSystemException.java",
|
|
"core/java/android/os/NativeHandle.java",
|
|
"core/java/android/os/RemoteException.java",
|
|
"core/java/android/util/AndroidException.java",
|
|
],
|
|
installable: false,
|
|
sdk_version: "core_platform",
|
|
annotations_enabled: true,
|
|
previous_api: ":android.api.public.latest",
|
|
merge_annotations_dirs: [
|
|
"metalava-manual",
|
|
],
|
|
args: priv_apps,
|
|
}
|
|
|
|
java_library_static {
|
|
name: "hwbinder.stubs",
|
|
sdk_version: "core_current",
|
|
srcs: [
|
|
":hwbinder-stubs-docs",
|
|
],
|
|
}
|