diff options
Diffstat (limited to 'Android.bp')
| -rw-r--r-- | Android.bp | 291 |
1 files changed, 291 insertions, 0 deletions
diff --git a/Android.bp b/Android.bp index 22fe23dc85ee..c7e9bf012430 100644 --- a/Android.bp +++ b/Android.bp @@ -854,6 +854,8 @@ optional_subdirs = [ "core/tests/utiltests/jni", ] +// TODO(b/77285514): remove this once the last few hidl interfaces have been +// updated to use hwbinder.stubs. java_library { name: "hwbinder", no_framework_libs: true, @@ -903,3 +905,292 @@ python_binary_host { "fontTools", ], } + +// TODO: Don't rely on this list once droiddoc can take a list of packages to document +frameworks_base_subdirs = [ + "core/java", + "graphics/java", + "location/java", + "media/java", + "media/mca/effect/java", + "media/mca/filterfw/java", + "media/mca/filterpacks/java", + "drm/java", + "opengl/java", + "sax/java", + "telecomm/java", + "telephony/java", + "wifi/java", + "lowpan/java", + "keystore/java", + "rs/java", +] + +packages_to_document = [ + "android", + "javax/microedition/khronos", + "org/apache/http/conn", + "org/apache/http/params", +] + +// The since flag (-since N.xml API_LEVEL) is used to add API Level information +// to the reference documentation. Must be in order of oldest to newest. +// +// Conscrypt (com.android.org.conscrypt) is an implementation detail and should +// not be referenced in the documentation. +framework_docs_args = "-android -manifest $(location core/res/AndroidManifest.xml) " + + "-hidePackage com.android.internal " + + "-hidePackage com.android.internal.util " + + "-hidePackage com.android.okhttp " + + "-hidePackage com.android.org.conscrypt " + + "-hidePackage com.android.server " + + "-since $(location 1/public/api/android.xml) 1 " + + "-since $(location 2/public/api/android.xml) 2 " + + "-since $(location 3/public/api/android.xml) 3 " + + "-since $(location 4/public/api/android.xml) 4 " + + "-since $(location 5/public/api/android.xml) 5 " + + "-since $(location 6/public/api/android.xml) 6 " + + "-since $(location 7/public/api/android.xml) 7 " + + "-since $(location 8/public/api/android.xml) 8 " + + "-since $(location 9/public/api/android.xml) 9 " + + "-since $(location 10/public/api/android.xml) 10 " + + "-since $(location 11/public/api/android.xml) 11 " + + "-since $(location 12/public/api/android.xml) 12 " + + "-since $(location 13/public/api/android.xml) 13 " + + "-since $(location 14/public/api/android.txt) 14 " + + "-since $(location 15/public/api/android.txt) 15 " + + "-since $(location 16/public/api/android.txt) 16 " + + "-since $(location 17/public/api/android.txt) 17 " + + "-since $(location 18/public/api/android.txt) 18 " + + "-since $(location 19/public/api/android.txt) 19 " + + "-since $(location 20/public/api/android.txt) 20 " + + "-since $(location 21/public/api/android.txt) 21 " + + "-since $(location 22/public/api/android.txt) 22 " + + "-since $(location 23/public/api/android.txt) 23 " + + "-since $(location 24/public/api/android.txt) 24 " + + "-since $(location 25/public/api/android.txt) 25 " + + "-since $(location 26/public/api/android.txt) 26 " + + "-since $(location 27/public/api/android.txt) 27 " + + "-since $(location 28/public/api/android.txt) 28 " + + "-werror -lerror -hide 111 -hide 113 -hide 125 -hide 126 -hide 127 -hide 128 " + + "-overview $(location core/java/overview.html) " + + // Federate Support Library references against local API file. + "-federate SupportLib https://developer.android.com " + + "-federationapi SupportLib $(location current/support-api.txt) " + +doc_defaults { + name: "framework-docs-default", + srcs: [ + ":opt-telephony-srcs", + ":opt-net-voip-srcs", + ":openjdk_javadoc_files", + ":non_openjdk_javadoc_files", + ":android_icu4j_src_files_for_docs", + ":gen-ojluni-jaif-annotated-srcs", + ], + exclude_srcs: [ + ":annotated_ojluni_files", + ], + srcs_lib: "framework", + srcs_lib_whitelist_dirs: frameworks_base_subdirs, + srcs_lib_whitelist_pkgs: packages_to_document, + libs: [ + "core-oj", + "core-libart", + "conscrypt", + "bouncycastle", + "okhttp", + "ext", + "framework", + "voip-common", + "android.test.mock", + ], + local_sourcepaths: frameworks_base_subdirs, + html_dirs: [ + "docs/html", + ], + knowntags: [ + "docs/knowntags.txt", + ":known-oj-tags", + ], + custom_template: "droiddoc-templates-sdk", + hdf: [ + "dac true", + "sdk.codename O", + "sdk.preview.version 1", + "sdk.version 7.0", + "sdk.rel.id 1", + "sdk.preview 0", + ], + resourcesdir: "docs/html/reference/images", + resourcesoutdir: "reference/android/images", + installable: false, +} + +droiddoc { + name: "api-stubs-docs", + defaults: ["framework-docs-default"], + arg_files: [ + "core/res/AndroidManifest.xml", + ":api-version-xml", + "core/java/overview.html", + ":current-support-api", + "api/current.txt", + ], + api_filename: "public_api.txt", + private_api_filename: "private.txt", + removed_api_filename: "removed.txt", + args: framework_docs_args + " -referenceonly -nodocs", + check_api: { + last_released: { + api_file: ":last-released-public-api", + removed_api_file: "api/removed.txt", + args: "-hide 2 -hide 3 -hide 4 -hide 5 -hide 6 -hide 24 -hide 25 -hide 26 -hide 27 " + + "-error 7 -error 8 -error 9 -error 10 -error 11 -error 12 -error 13 -error 14 -error 15 " + + "-error 16 -error 17 -error 18 -error 31", + }, + current: { + api_file: "api/current.txt", + removed_api_file: "api/removed.txt", + args: "-error 2 -error 3 -error 4 -error 5 -error 6 " + + "-error 7 -error 8 -error 9 -error 10 -error 11 -error 12 -error 13 -error 14 -error 15 " + + "-error 16 -error 17 -error 18 -error 19 -error 20 -error 21 -error 23 -error 24 " + + "-error 25 -error 26 -error 27", + }, + }, +} + +droiddoc { + name: "system-api-stubs-docs", + defaults: ["framework-docs-default"], + arg_files: [ + "core/res/AndroidManifest.xml", + ":api-version-xml", + "core/java/overview.html", + ":current-support-api", + "api/current.txt", + ], + api_tag_name: "SYSTEM", + api_filename: "system-api.txt", + removed_api_filename: "system-removed.txt", + exact_api_filename: "system-exact.txt", + args: framework_docs_args + " -referenceonly -showAnnotation android.annotation.SystemApi -nodocs", + check_api: { + last_released: { + api_file: ":last-released-system-api", + removed_api_file: "api/system-removed.txt", + args: "-hide 2 -hide 3 -hide 4 -hide 5 -hide 6 -hide 24 -hide 25 -hide 26 -hide 27 " + + "-error 7 -error 8 -error 9 -error 10 -error 11 -error 12 -error 13 -error 14 -error 15 " + + "-error 16 -error 17 -error 18 -error 31", + }, + current: { + api_file: "api/system-current.txt", + removed_api_file: "api/system-removed.txt", + args: "-error 2 -error 3 -error 4 -error 5 -error 6 " + + "-error 7 -error 8 -error 9 -error 10 -error 11 -error 12 -error 13 -error 14 -error 15 " + + "-error 16 -error 17 -error 18 -error 19 -error 20 -error 21 -error 23 -error 24 " + + "-error 25 -error 26 -error 27", + }, + }, +} + +droiddoc { + name: "test-api-stubs-docs", + defaults: ["framework-docs-default"], + arg_files: [ + "core/res/AndroidManifest.xml", + ":api-version-xml", + "core/java/overview.html", + ":current-support-api", + "api/current.txt", + ], + api_tag_name: "TEST", + api_filename: "test-api.txt", + removed_api_filename: "test-removed.txt", + exact_api_filename: "test-exact.txt", + args: framework_docs_args + " -referenceonly -showAnnotation android.annotation.TestApi -nodocs", + check_api: { + current: { + api_file: "api/test-current.txt", + removed_api_file: "api/test-removed.txt", + args: "-error 2 -error 3 -error 4 -error 5 -error 6 " + + "-error 7 -error 8 -error 9 -error 10 -error 11 -error 12 -error 13 -error 14 -error 15 " + + "-error 16 -error 17 -error 18 -error 19 -error 20 -error 21 -error 23 -error 24 " + + "-error 25 -error 26 -error 27", + }, + }, +} + +droiddoc { + name: "hwbinder-stubs-docs", + srcs: [ + "core/java/android/os/HidlSupport.java", + "core/java/android/annotation/IntDef.java", + "core/java/android/annotation/NonNull.java", + "core/java/android/annotation/SystemApi.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/RemoteException.java", + "core/java/android/util/AndroidException.java", + ], + custom_template: "droiddoc-templates-sdk", + installable: false, + no_framework_libs: true, + args: "-showAnnotation android.annotation.SystemApi -nodocs -stubsourceonly", +} + +java_library_static { + name: "hwbinder.stubs", + sdk_version: "core_current", + srcs: [ + ":hwbinder-stubs-docs", + ], +} + +droiddoc { + name: "hiddenapi-lists", + defaults: ["framework-docs-default"], + arg_files: [ + "core/res/AndroidManifest.xml", + ":api-version-xml", + "core/java/overview.html", + ":current-support-api", + ], + private_dex_api_filename: "private-dex.txt", + removed_dex_api_filename: "removed-dex.txt", + args: framework_docs_args + + " -referenceonly" + + " -nodocs" + + " -showUnannotated" + + " -showAnnotation android.annotation.SystemApi" + + " -showAnnotation android.annotation.TestApi", +} + +filegroup { + name: "apache-http-stubs-sources", + srcs: [ + "core/java/org/apache/http/conn/ConnectTimeoutException.java", + "core/java/org/apache/http/conn/scheme/HostNameResolver.java", + "core/java/org/apache/http/conn/scheme/LayeredSocketFactory.java", + "core/java/org/apache/http/conn/scheme/SocketFactory.java", + "core/java/org/apache/http/conn/ssl/AbstractVerifier.java", + "core/java/org/apache/http/conn/ssl/AllowAllHostnameVerifier.java", + "core/java/org/apache/http/conn/ssl/AndroidDistinguishedNameParser.java", + "core/java/org/apache/http/conn/ssl/BrowserCompatHostnameVerifier.java", + "core/java/org/apache/http/conn/ssl/SSLSocketFactory.java", + "core/java/org/apache/http/conn/ssl/StrictHostnameVerifier.java", + "core/java/org/apache/http/conn/ssl/X509HostnameVerifier.java", + "core/java/org/apache/http/params/CoreConnectionPNames.java", + "core/java/org/apache/http/params/HttpConnectionParams.java", + "core/java/org/apache/http/params/HttpParams.java", + "core/java/android/net/http/HttpResponseCache.java", + "core/java/android/net/http/SslCertificate.java", + "core/java/android/net/http/SslError.java", + "core/java/com/android/internal/util/HexDump.java", + ], +} |