summaryrefslogtreecommitdiff
path: root/ApiDocs.bp
AgeCommit message (Collapse)Author
2020-12-21Stop ignoring classes on the classpath for stubsAnton Hansson
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
2020-12-10Unbundle i18n API from android-non-updatablePaul Duffin
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
2020-09-28Get ART public API doctag information from java_sdk_libraryPaul Duffin
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
2020-09-28Use ART stubs source generated by java_sdk_libraryPaul Duffin
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
2020-08-03Remove `create_stubs: false` from droiddocLiz Kammer
`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
2020-06-20Revert "Enable metalava sandbox in StubLibraries.bp and ApiDocs.bp."Ramy Medhat
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
2020-06-18Enable metalava sandbox in StubLibraries.bp and ApiDocs.bp.Ramy Medhat
Test: built entire topic with and without RBE_METALAVA. Change-Id: Ia5767debc713a420b8d008943903238413d0816d
2020-05-26Use tags to access conscrypt sourcesPaul Duffin
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
2020-05-04Change last-released filegroupAnton Hansson
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
2020-05-03Remove process parameter from SystemApiJiyong Park
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 92514d5b71ab01f4c3ba3882b3acbee768c03671) Change-Id: I4b1395b3a6e17ff8ce634059f8787c1b6392b1b9
2020-04-20Remove proofread files that aren't createdDan Willemsen
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
2020-04-09Rename conscrypt-module-public-api-stubs-sourcePaul Duffin
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
2020-03-26Reference libcore, conscrypt and icu sources directlyPaul Duffin
Avoids an extra aggregation step in the creation of the API sources. Test: m nothing Bug: 142935992 Change-Id: Ia15c3ceb9fc59e7945687536c60ce265ec95781e
2020-02-26Quiet ds-docs-switchedColin Cross
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
2020-02-03Build rules for compat config docs.atrost
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
2020-01-13Use android.compat.annotation.UnsupportedAppUsage everywhere.Artur Satayev
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
2019-12-22Separate modules for API docs and API stubsJiyong Park
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 0d7e86d03c8443cee90096ff0447fd50541d77c3) Change-Id: I285e8c82078d5bd3ed85b0343db2f6375ce7ffb7