Switch car-lib over from doclava to metalava
The platform API files are about to switch to signature
file format v2, which doclava cannot parse, so updating
this build to using API check via metalava instead of
doclava.
Note: Metalava checks for additional API and docs problems which
doclava did not; some of these are errors which would fail the
build. Therefore, we turn off these warnings until the source
code is fixed.
Test: make docs
Bug: 122724077
Exempt-From-Owner-Approval: Large-scale tooling change
Change-Id: Ib7cab01e85e7032ffbc7cf03771a59b8f2bfd46d
diff --git a/car-lib/Android.bp b/car-lib/Android.bp
index c037284..6a0c561 100644
--- a/car-lib/Android.bp
+++ b/car-lib/Android.bp
@@ -71,7 +71,7 @@
installable: true,
}
-doc_defaults {
+stubs_defaults {
name: "android.car-docs-default",
srcs: [
"src/**/*.java",
@@ -80,7 +80,6 @@
libs: [
"android.car",
],
- custom_template: "droiddoc-templates-sdk",
product_variables: {
pdk: {
enabled: false,
@@ -121,13 +120,13 @@
],
}
-droiddoc {
+droidstubs {
name: "android.car-stubs-docs",
defaults: ["android.car-docs-default"],
api_tag_name: "ANDROID_CAR",
api_filename: "api.txt",
removed_api_filename: "removed.txt",
- args: "-hide 113 -hide 110 -nodocs -stubpackages android.car* ",
+ args: "--hide DeprecationMismatch --hide UnavailableSymbol --hide HiddenTypedefConstant --hide ReferencesHidden --no-docs --stub-packages android.car* ",
installable: false,
check_api: {
last_released: {
@@ -147,14 +146,14 @@
},
}
-droiddoc {
+droidstubs {
name: "android.car-system-stubs-docs",
defaults: ["android.car-docs-default"],
api_tag_name: "ANDROID_CAR_SYSTEM",
api_filename: "api.txt",
removed_api_filename: "removed.txt",
- args: "-hide 113 -hide 110 -nodocs -stubpackages android.car* " +
- "-showAnnotation android.annotation.SystemApi ",
+ args: "--hide DeprecationMismatch --hide UnavailableSymbol --hide HiddenTypedefConstant --hide ReferencesHidden --no-docs --stub-packages android.car* " +
+ "--show-annotation android.annotation.SystemApi ",
installable: false,
check_api: {
last_released: {
@@ -174,14 +173,14 @@
},
}
-droiddoc {
+droidstubs {
name: "android.car-test-stubs-docs",
defaults: ["android.car-docs-default"],
api_tag_name: "ANDROID_CAR_SYSTEM",
api_filename: "api.txt",
removed_api_filename: "removed.txt",
- args: "-hide 113 -hide 110 -nodocs -stubpackages android.car* " +
- "-showAnnotation android.annotation.TestApi ",
+ args: "--hide DeprecationMismatch --hide UnavailableSymbol --hide HiddenTypedefConstant --hide ReferencesHidden --no-docs --stub-packages android.car* " +
+ "--show-annotation android.annotation.TestApi ",
installable: false,
check_api: {
current: {
@@ -194,7 +193,7 @@
},
}
-droiddoc {
+droidstubs {
name: "android.car-stub-docs",
srcs: [
"src/**/*.java",
@@ -204,8 +203,7 @@
],
api_tag_name: "ANDROID_CAR_STUB",
api_filename: "api.txt",
- custom_template: "droiddoc-templates-sdk",
- args: "-nodocs -stubpackages android.car* ",
+ args: "--hide DeprecationMismatch --hide UnavailableSymbol --hide HiddenTypedefConstant --hide ReferencesHidden --no-docs --stub-packages android.car* ",
installable: false,
product_variables: {
pdk: {