commit f4c428a8580ffefe579bfab736a171aa706bb303
author Tor Norbye <tnorbye@google.com> Fri Jan 04 21:03:51 2019 -0800
committer Tor Norbye <tnorbye@google.com> Sat Jan 12 08:56:00 2019 -0800
tree 01c23e2c5d870af08a7bd4a43222ac956cd33502
parent 23e2c08a167e11c47695941df048356c121e748f

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

car-lib/Android.bp

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: {