We're working on moving the libcore classes away from srcs and into the
classpath, and ignoring classes on the classpath will cause incorrect
API signatures once that happens (several libcore classes appear in
public API signatures).

Keep the docs building in the same way they were before. They will be
addressed in separate CLs.

Bug: 173606718
Test: m checkapi
Change-Id: I471327c3657662d7a093e9baa2fb6e08d640f895

This removes the i18n source from the non-updatable stubs which removes
them from the frameworks/base/core/api files too. The API is still
protected by both the build and Gerrit review as the API is specified
in the external/icu/android_icu4j/api/public/ directory.

The i18n stubs source is used instead of the implementation source for
generating the JavaDoc. That revealed a minor issue with metalava which
is fixed in this topic.

The i18n stubs library was statically included alongside the conscrypt
stubs library so it will still appear in the monolothic android.jar.

Bug: 174344410
Test: m offline-sdk-docs
      - check that i18n classes are present
      m android_stubs_current android_system_stubs_current android_test_stubs_current
      - check that i18n classes are present in each jar
      m droid
Change-Id: I744c8bac54a8a5518ca0eca2a7700abbfa0997f4

Change-Id: Ic5c3bfeb67c6e1b9b2b3c6275ea4badbef8536d3

Uses an output tag to access the doctag_files exposed by the
art.module.public.api java_sdk_library. This ensures that the doctags
will be available from the ART prebuilts as well.

Bug: 168301990
Test: Built offline-sdk-docs with and without the change and
      diffed them. The only difference was the timestamp.js
      file.
Change-Id: Ibd51899e4aeb9b11727a54644330bbbe8b7e86a7

Bug: 168301990
Test: Built offline-sdk-docs with and without the change and
      diffed them. There were some changes other than the timestamp.js
      file. With these changes classes that implemented the
      Object.equals(Object) method had some extra documentation that
      explained that the parameter could be null. The reason for this
      change is that the stubs generated with this change includes
      android.annotation.Nullable whereas previously they included
      androidx.annotation.Nullable. The change is a very minor
      improvement over what is currently uploaded to
      developer.android.com/reference so not worth backporting.
      Diffed api/public/current.txt against
      frameworks/base/api/current.txt and made sure that the latter was
      a superset of the former and there were no differences in the area
      that overlapped.
Change-Id: I3767948b4659b18b813c8eed66258af98ac4a241

This moves the android.media.audio.common, android.media.permission and
android.media.soundtrigger_middleware AIDL files to a their own
separate aidl_interface module for Java.

Previously, because of how the framework JAR is configured, those
files were automatically compiled into it and we had to disable Java
for this target, creating a discrepancy between C++ and Java, which
would require us to similarly diverge any dependent targets if we want
cross-language support.

As part of this change, we also had to switch from using the
FileDescriptor type to ParcelFileDescriptor, as this is the only type
supported outside of the framework JAR and is also the recommended
practice.

Test: Manual verification of basic soundtrigger functionality.
Change-Id: Ib65c19dd7c7f5433cfa527fa74bb61ac677f5cf5

`create_stubs: false` is the default behavior in soong as of
https://r.android.com/1380730

Test: m docs
Bug: 144248501
Bug: 143136634
Change-Id: If13de5c0a4071b032bc460f5c57e27819b33051d

Reason for revert: breaking several builds downstream
Reverted Changes:
Ia5767debc:Enable metalava sandbox in StubLibraries.bp and Ap...
I7256d29f1:Add sandbox property to the javadoc rule.
Ia69440800:Only report a violation when the file exists.

Change-Id: I5651212314fd39b7ba404936dee416f566c682c9

Test: built entire topic with and without RBE_METALAVA.
Change-Id: Ia5767debc713a420b8d008943903238413d0816d

Avoids direct access to the stub sources and instead access them via
tags passed to the java_sdk_library.

Bug: 155164730
Test: m checkapi
Merged-In: I93dfb8bfac60bd7ab628292667c8d7a9d5e8eb82
Change-Id: I93dfb8bfac60bd7ab628292667c8d7a9d5e8eb82
(cherry picked from commit e55d4e3b)

Avoids direct access to the stub sources and instead access them via
tags passed to the java_sdk_library.

Bug: 155164730
Test: m checkapi
Change-Id: I93dfb8bfac60bd7ab628292667c8d7a9d5e8eb82

There were two different filegroups referencing the same last released
APIs. Delete the manually defined one and switch references over to use
the one defined by prebuilt_apis.

Bug: 155197156
Test: m
Change-Id: Ib15d2c08e6400546ca03de6bfd4e5cbcc938c992
Merged-In: Ib15d2c08e6400546ca03de6bfd4e5cbcc938c992

SystemApi no longer has the process parameter. Fixing the last remaining
place where the parameter was still used.

Bug: 155531519
Test: m
Merged-In: I4b1395b3a6e17ff8ce634059f8787c1b6392b1b9
(cherry picked from commit 92514d5b)
Change-Id: I4b1395b3a6e17ff8ce634059f8787c1b6392b1b9

There were two different filegroups referencing the same last released
APIs. Delete the manually defined one and switch references over to use
the one defined by prebuilt_apis.

Bug: 155197156
Test: m
Change-Id: Ib15d2c08e6400546ca03de6bfd4e5cbcc938c992

SystemApi no longer has the process parameter. Fixing the last remaining
place where the parameter was still used.

Bug: 155531519
Test: m
Change-Id: I4b1395b3a6e17ff8ce634059f8787c1b6392b1b9

Renamed conscrypt-module-public-api-stubs-source to
conscrypt.module.public.api.stubs.source to match the format of the
name created by java_sdk_library.

This is in preparation for switching to use java_sdk_library to
generate conscrypt's public API.

Bug: 153443117
Bug: 153306490
Test: m nothing
Merged-In: I26ad21cf74ad3600de250df8e84deec65b91b3f9
Change-Id: I26ad21cf74ad3600de250df8e84deec65b91b3f9
(cherry picked from commit 29adf462)

Avoids an extra aggregation step in the creation of the API sources.

Bug: 153306490
Test: m nothing
Bug: 142935992
Merged-In: Ia15c3ceb9fc59e7945687536c60ce265ec95781e
Change-Id: Ia15c3ceb9fc59e7945687536c60ce265ec95781e
(cherry picked from commit 5c89e70a)

These would cause these actions (and any that depended upon them) to
re-run during every incremental build. These now produce warnings:

ninja: output file missing after successful execution: out/soong/.intermediates/frameworks/base/ds-ref-navtree-docs/android_common/ds-ref-navtree-docs-proofrerad.txt

It turns out that the -proofread argument to doclava is ignored with the
following argument combinations:

 * -static -devsite
 * -navtreeonly

Test: m docs; m docs (nothing to do)
Change-Id: I21b939951f5a2f33914e9fc9414df8206091d262

Renamed conscrypt-module-public-api-stubs-source to
conscrypt.module.public.api.stubs.source to match the format of the
name created by java_sdk_library.

This is in preparation for switching to use java_sdk_library to
generate conscrypt's public API.

Bug: 153443117
Test: m nothing
Change-Id: I26ad21cf74ad3600de250df8e84deec65b91b3f9

Avoids an extra aggregation step in the creation of the API sources.

Test: m nothing
Bug: 142935992
Change-Id: Ia15c3ceb9fc59e7945687536c60ce265ec95781e

The ds-docs-switched genrule was producing 18947 lines of output,
including a single line with 266986 bytes.  Quiet all the tools
used in the genrule.

Test: m ds-docs-switched
Change-Id: I5549c34f6310469e7791b56190d5b7c1f386a5f7

Add compat_config to offline SDK docs for now, to generate the
compatibility changes documentation.

Test: m -j offline-sdk-docs
Bug: 144927670
Change-Id: I856a0972212cb23ff97800243671e9c8280d5287

The new annotation replaces existing two annotations in libcore/ and frameworks/base/. This helps avoid human confusion and allows better and correct tool support.

Bug: 145132366
Test: m
Change-Id: I9078b124ddf0273250c645fe17f27088092c8b18

frameworks/base/Android.bp became too big. Modularize it into multiple
files for better readability and extensibility.

droidstubs and java_library modules for API stub libraries are moved to
StubLibraries.bp.

droidstubs and droiddoc modules for API documents are moved to
ApiDocs.bp

Also, added some documentation to explain the roles of the many modules
and how they are related with each other.

Bug: N/A
Test: m

Exempt-From-Owner-Approval: cherry-pick from internal

Merged-In: I285e8c82078d5bd3ed85b0343db2f6375ce7ffb7
(cherry picked from commit 0d7e86d0)
Change-Id: I285e8c82078d5bd3ed85b0343db2f6375ce7ffb7

frameworks/base/Android.bp became too big. Modularize it into multiple
files for better readability and extensibility.

droidstubs and java_library modules for API stub libraries are moved to
StubLibraries.bp.

droidstubs and droiddoc modules for API documents are moved to
ApiDocs.bp

Also, added some documentation to explain the roles of the many modules
and how they are related with each other.

Bug: N/A
Test: m
Change-Id: I285e8c82078d5bd3ed85b0343db2f6375ce7ffb7