5484533fba
metalava now accepts the --sdk-extensions-info flag. The argument is a file containing metadata regarding extension SDKs; the SdkExtensions module defines such a file. Update the droidstub targets to point to this file. Bug: 228828986 Test: m sdk dist Change-Id: I3a5d92c640d9b22add416a20dbec3c8e352ba963
481 lines
14 KiB
Plaintext
481 lines
14 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
|
|
// - The javac compilation is done by java_library modules
|
|
//
|
|
// The metalava conversion is also responsible for creating API signature files
|
|
// and comparing them against the checked in API signature, and also checking compatibility
|
|
// with the latest frozen API signature.
|
|
|
|
/////////////////////////////////////////////////////////////////////
|
|
// These modules provide source files for the stub libraries
|
|
/////////////////////////////////////////////////////////////////////
|
|
|
|
droidstubs {
|
|
name: "api-stubs-docs-non-updatable",
|
|
defaults: [
|
|
"android-non-updatable-stubs-defaults",
|
|
"module-classpath-stubs-defaults",
|
|
],
|
|
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: ":android-non-updatable-incompatibilities.api.public.latest",
|
|
},
|
|
api_lint: {
|
|
enabled: true,
|
|
new_since: ":android.api.public.latest",
|
|
},
|
|
},
|
|
dists: [
|
|
{
|
|
targets: ["sdk"],
|
|
dir: "apistubs/android/public/api",
|
|
dest: "android-non-updatable.txt",
|
|
tag: ".api.txt",
|
|
},
|
|
{
|
|
targets: ["sdk"],
|
|
dir: "apistubs/android/public/api",
|
|
dest: "android-non-updatable-removed.txt",
|
|
tag: ".removed-api.txt",
|
|
},
|
|
],
|
|
}
|
|
|
|
priv_apps = " --show-annotation android.annotation.SystemApi\\(" +
|
|
"client=android.annotation.SystemApi.Client.PRIVILEGED_APPS" +
|
|
"\\)"
|
|
|
|
priv_apps_in_stubs = " --show-for-stub-purposes-annotation android.annotation.SystemApi\\(" +
|
|
"client=android.annotation.SystemApi.Client.PRIVILEGED_APPS" +
|
|
"\\)"
|
|
|
|
test = " --show-annotation android.annotation.TestApi"
|
|
|
|
module_libs = " --show-annotation android.annotation.SystemApi\\(" +
|
|
"client=android.annotation.SystemApi.Client.MODULE_LIBRARIES" +
|
|
"\\)"
|
|
|
|
droidstubs {
|
|
name: "system-api-stubs-docs-non-updatable",
|
|
defaults: [
|
|
"android-non-updatable-stubs-defaults",
|
|
"module-classpath-stubs-defaults",
|
|
],
|
|
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: ":android-non-updatable-incompatibilities.api.system.latest",
|
|
},
|
|
api_lint: {
|
|
enabled: true,
|
|
new_since: ":android.api.system.latest",
|
|
baseline_file: "core/api/system-lint-baseline.txt",
|
|
},
|
|
},
|
|
dists: [
|
|
{
|
|
targets: ["sdk"],
|
|
dir: "apistubs/android/system/api",
|
|
dest: "android-non-updatable.txt",
|
|
tag: ".api.txt",
|
|
},
|
|
{
|
|
targets: ["sdk"],
|
|
dir: "apistubs/android/system/api",
|
|
dest: "android-non-updatable-removed.txt",
|
|
tag: ".removed-api.txt",
|
|
},
|
|
],
|
|
}
|
|
|
|
droidstubs {
|
|
name: "test-api-stubs-docs-non-updatable",
|
|
defaults: [
|
|
"android-non-updatable-stubs-defaults",
|
|
"module-classpath-stubs-defaults",
|
|
],
|
|
args: metalava_framework_docs_args + test + priv_apps_in_stubs,
|
|
check_api: {
|
|
current: {
|
|
api_file: "core/api/test-current.txt",
|
|
removed_api_file: "core/api/test-removed.txt",
|
|
},
|
|
api_lint: {
|
|
enabled: true,
|
|
baseline_file: "core/api/test-lint-baseline.txt",
|
|
},
|
|
},
|
|
dists: [
|
|
{
|
|
targets: ["sdk"],
|
|
dir: "apistubs/android/test/api",
|
|
dest: "android.txt",
|
|
tag: ".api.txt",
|
|
},
|
|
{
|
|
targets: ["sdk"],
|
|
dir: "apistubs/android/test/api",
|
|
dest: "removed.txt",
|
|
tag: ".removed-api.txt",
|
|
},
|
|
{
|
|
targets: ["sdk"],
|
|
dir: "apistubs/android/test/api",
|
|
dest: "android-non-updatable.txt",
|
|
tag: ".api.txt",
|
|
},
|
|
{
|
|
targets: ["sdk"],
|
|
dir: "apistubs/android/test/api",
|
|
dest: "android-non-updatable-removed.txt",
|
|
tag: ".removed-api.txt",
|
|
},
|
|
],
|
|
}
|
|
|
|
droidstubs {
|
|
name: "module-lib-api-stubs-docs-non-updatable",
|
|
defaults: [
|
|
"android-non-updatable-stubs-defaults",
|
|
"module-classpath-stubs-defaults",
|
|
],
|
|
args: metalava_framework_docs_args + priv_apps_in_stubs + 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",
|
|
baseline_file: ":android-non-updatable-incompatibilities.api.module-lib.latest",
|
|
},
|
|
api_lint: {
|
|
enabled: true,
|
|
new_since: ":android.api.module-lib.latest",
|
|
baseline_file: "core/api/module-lib-lint-baseline.txt",
|
|
},
|
|
},
|
|
dists: [
|
|
{
|
|
targets: ["sdk"],
|
|
dir: "apistubs/android/module-lib/api",
|
|
dest: "android-non-updatable.txt",
|
|
tag: ".api.txt",
|
|
},
|
|
{
|
|
targets: ["sdk"],
|
|
dir: "apistubs/android/module-lib/api",
|
|
dest: "android-non-updatable-removed.txt",
|
|
tag: ".removed-api.txt",
|
|
},
|
|
],
|
|
}
|
|
|
|
/////////////////////////////////////////////////////////////////////
|
|
// android_*_stubs_current modules are the stubs libraries compiled
|
|
// from stub sources
|
|
/////////////////////////////////////////////////////////////////////
|
|
|
|
java_defaults {
|
|
name: "android.jar_defaults",
|
|
sdk_version: "none",
|
|
system_modules: "none",
|
|
java_version: "1.8",
|
|
compile_dex: true,
|
|
defaults_visibility: ["//visibility:private"],
|
|
visibility: ["//visibility:public"],
|
|
}
|
|
|
|
java_defaults {
|
|
name: "android-non-updatable_defaults_stubs_current",
|
|
libs: ["stub-annotations"],
|
|
static_libs: ["framework-res-package-jar"], // Export package of framework-res
|
|
sdk_version: "none",
|
|
system_modules: "none",
|
|
java_version: "1.8",
|
|
compile_dex: true,
|
|
dist: {
|
|
targets: ["sdk"],
|
|
tag: ".jar",
|
|
dest: "android-non-updatable.jar",
|
|
},
|
|
defaults_visibility: ["//visibility:private"],
|
|
visibility: ["//visibility:private"],
|
|
}
|
|
|
|
java_library {
|
|
name: "android-non-updatable.stubs",
|
|
defaults: ["android-non-updatable_defaults_stubs_current"],
|
|
srcs: [":api-stubs-docs-non-updatable"],
|
|
libs: ["all-modules-public-stubs"],
|
|
dist: {
|
|
dir: "apistubs/android/public",
|
|
},
|
|
}
|
|
|
|
java_library {
|
|
name: "android-non-updatable.stubs.system",
|
|
defaults: ["android-non-updatable_defaults_stubs_current"],
|
|
srcs: [":system-api-stubs-docs-non-updatable"],
|
|
libs: ["all-modules-system-stubs"],
|
|
dist: {
|
|
dir: "apistubs/android/system",
|
|
},
|
|
}
|
|
|
|
java_library {
|
|
name: "android-non-updatable.stubs.module_lib",
|
|
defaults: ["android-non-updatable_defaults_stubs_current"],
|
|
srcs: [":module-lib-api-stubs-docs-non-updatable"],
|
|
libs: [
|
|
"sdk_module-lib_current_framework-tethering",
|
|
"sdk_module-lib_current_framework-connectivity-t",
|
|
"sdk_public_current_framework-bluetooth",
|
|
// NOTE: The below can be removed once the prebuilt stub contains bluetooth.
|
|
"sdk_system_current_android",
|
|
// NOTE: The below can be removed once the prebuilt stub contains IKE.
|
|
"sdk_system_current_android.net.ipsec.ike",
|
|
],
|
|
dist: {
|
|
dir: "apistubs/android/module-lib",
|
|
},
|
|
}
|
|
|
|
java_library {
|
|
name: "android-non-updatable.stubs.test",
|
|
defaults: ["android-non-updatable_defaults_stubs_current"],
|
|
srcs: [":test-api-stubs-docs-non-updatable"],
|
|
libs: ["all-modules-system-stubs"],
|
|
dist: {
|
|
dir: "apistubs/android/test",
|
|
},
|
|
}
|
|
|
|
java_defaults {
|
|
name: "android_stubs_dists_default",
|
|
dist: {
|
|
targets: ["sdk"],
|
|
tag: ".jar",
|
|
dest: "android.jar",
|
|
},
|
|
defaults_visibility: ["//frameworks/base/services"],
|
|
}
|
|
|
|
java_library {
|
|
name: "android_stubs_current",
|
|
static_libs: [
|
|
"all-modules-public-stubs",
|
|
"android-non-updatable.stubs",
|
|
"private-stub-annotations-jar",
|
|
],
|
|
defaults: ["android.jar_defaults"],
|
|
}
|
|
|
|
java_library {
|
|
name: "android_system_stubs_current",
|
|
static_libs: [
|
|
"all-modules-system-stubs",
|
|
"android-non-updatable.stubs.system",
|
|
"private-stub-annotations-jar",
|
|
],
|
|
defaults: [
|
|
"android.jar_defaults",
|
|
"android_stubs_dists_default",
|
|
],
|
|
dist: {
|
|
dir: "apistubs/android/system",
|
|
},
|
|
dists: [
|
|
{
|
|
// Legacy dist path
|
|
targets: ["sdk"],
|
|
tag: ".jar",
|
|
dest: "android_system.jar",
|
|
},
|
|
],
|
|
}
|
|
|
|
java_library {
|
|
name: "android_test_stubs_current",
|
|
// Modules do not have test APIs, but we want to include their SystemApis, like we include
|
|
// the SystemApi of framework-non-updatable-sources.
|
|
static_libs: [
|
|
"all-modules-system-stubs",
|
|
"android-non-updatable.stubs.test",
|
|
"private-stub-annotations-jar",
|
|
],
|
|
defaults: [
|
|
"android.jar_defaults",
|
|
"android_stubs_dists_default",
|
|
],
|
|
dist: {
|
|
dir: "apistubs/android/test",
|
|
},
|
|
}
|
|
|
|
java_library {
|
|
name: "android_module_lib_stubs_current",
|
|
defaults: [
|
|
"android.jar_defaults",
|
|
"android_stubs_dists_default",
|
|
],
|
|
static_libs: [
|
|
"android-non-updatable.stubs.module_lib",
|
|
"art.module.public.api.stubs.module_lib",
|
|
"i18n.module.public.api.stubs",
|
|
],
|
|
dist: {
|
|
dir: "apistubs/android/module-lib",
|
|
},
|
|
}
|
|
|
|
java_library {
|
|
name: "android_system_server_stubs_current",
|
|
defaults: ["android_stubs_dists_default"],
|
|
srcs: [":services-non-updatable-stubs"],
|
|
installable: false,
|
|
static_libs: [
|
|
"android_module_lib_stubs_current",
|
|
],
|
|
sdk_version: "none",
|
|
system_modules: "none",
|
|
java_version: "1.8",
|
|
dist: {
|
|
dir: "apistubs/android/system-server",
|
|
},
|
|
}
|
|
|
|
////////////////////////////////////////////////////////////////////////
|
|
// api-versions.xml generation, for public and system. This API database
|
|
// also contains the android.test.* APIs.
|
|
////////////////////////////////////////////////////////////////////////
|
|
|
|
java_library {
|
|
name: "android_stubs_current_with_test_libs",
|
|
static_libs: [
|
|
"android_stubs_current",
|
|
"android.test.base.stubs",
|
|
"android.test.mock.stubs",
|
|
"android.test.runner.stubs",
|
|
],
|
|
defaults: ["android.jar_defaults"],
|
|
visibility: [
|
|
"//visibility:override",
|
|
"//visibility:private",
|
|
],
|
|
}
|
|
|
|
java_library {
|
|
name: "android_system_stubs_current_with_test_libs",
|
|
static_libs: [
|
|
"android_system_stubs_current",
|
|
"android.test.base.stubs.system",
|
|
"android.test.mock.stubs.system",
|
|
"android.test.runner.stubs.system",
|
|
],
|
|
defaults: ["android.jar_defaults"],
|
|
visibility: [
|
|
"//visibility:override",
|
|
"//visibility:private",
|
|
],
|
|
}
|
|
|
|
droidstubs {
|
|
name: "api_versions_public",
|
|
srcs: [":android_stubs_current_with_test_libs{.jar}"],
|
|
generate_stubs: false,
|
|
api_levels_annotations_enabled: true,
|
|
api_levels_annotations_dirs: [
|
|
"sdk-dir",
|
|
"api-versions-jars-dir",
|
|
],
|
|
extensions_info_file: ":sdk-extensions-info",
|
|
}
|
|
|
|
droidstubs {
|
|
name: "api_versions_system",
|
|
srcs: [":android_system_stubs_current_with_test_libs{.jar}"],
|
|
generate_stubs: false,
|
|
api_levels_annotations_enabled: true,
|
|
api_levels_annotations_dirs: [
|
|
"sdk-dir",
|
|
"api-versions-jars-dir",
|
|
],
|
|
api_levels_sdk_type: "system",
|
|
extensions_info_file: ":sdk-extensions-info",
|
|
}
|
|
|
|
/////////////////////////////////////////////////////////////////////
|
|
// 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/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",
|
|
],
|
|
libs: ["framework-annotations-lib"],
|
|
installable: false,
|
|
sdk_version: "core_platform",
|
|
annotations_enabled: true,
|
|
previous_api: ":android.api.public.latest",
|
|
merge_annotations_dirs: [
|
|
"metalava-manual",
|
|
],
|
|
args: priv_apps,
|
|
visibility: ["//visibility:private"],
|
|
}
|
|
|
|
java_library {
|
|
name: "hwbinder.stubs",
|
|
sdk_version: "core_current",
|
|
libs: ["framework-annotations-lib"],
|
|
srcs: [
|
|
":hwbinder-stubs-docs",
|
|
],
|
|
visibility: ["//visibility:public"],
|
|
}
|