summaryrefslogtreecommitdiff
path: root/ApiDocs.bp
AgeCommit message (Collapse)Author
2021-07-27Pass metadata as AttributionSourceSource.Jeff Sharkey
These two PermissionManager methods are using AttributionSource as metadata only, and aren't interested in the remote caller enforcing that the claimed UID matches the caller, since they're not actually being used for permission enforcement. Thus we pass the metadata using the AttributionSourceState holder object and reconstruct on the remote side, entirely avoiding the enforceCallingUid() check. Bug: 193842956 Test: atest CtsPermission5TestCases Change-Id: I576b6feb8cc2b0586b4341268866d8027689293f
2021-05-11Merge "Apply the same filtering for docstubs and jarstubs" am: 46dff8e09f ↵Anton Hansson
am: 8f1928f4ca am: 9e8186aaaf Original change: https://android-review.googlesource.com/c/platform/frameworks/base/+/1700027 Change-Id: I83b173302f75d5536e47fcbb221fe806c691536a
2021-05-11Merge "Use filegroups for test-{base,mock,runner} srcs" am: af9b5f0a04 am: ↵Anton Hansson
06e56695cc am: 4eecbfcd41 Original change: https://android-review.googlesource.com/c/platform/frameworks/base/+/1700026 Change-Id: I5444e5d1028c8cf9cd3fa624e05ad5b102866d94
2021-05-10Apply the same filtering for docstubs and jarstubsAnton Hansson
A package filter was previously applied to just the jarstubs package, but not the docstubs. This lead to various internal classes appearing in the public documentation. Fix that to apply the same filter for both. This removes the following classes from the docs: android/telephony/PackageChangeReceiver com/android/net/module/util/CollectionUtils com/android/net/module/util/ConnectivityUtils com/android/net/module/util/NetworkCapabilitiesUtils com/android/net/module/util/NetworkIdentityUtils com/google/android/collect/Lists com/google/android/collect/Maps com/google/android/collect/Sets com/google/android/gles_jni/EGLConfigImpl com/google/android/gles_jni/EGLContextImpl com/google/android/gles_jni/EGLDisplayImpl com/google/android/gles_jni/EGLImpl com/google/android/gles_jni/EGLSurfaceImpl com/google/android/gles_jni/GLImpl com/google/android/util/AbstractMessageParser com/google/android/util/AbstractMessageParser$Acronym com/google/android/util/AbstractMessageParser$FlickrPhoto com/google/android/util/AbstractMessageParser$Format com/google/android/util/AbstractMessageParser$Html com/google/android/util/AbstractMessageParser$Link com/google/android/util/AbstractMessageParser$MusicTrack com/google/android/util/AbstractMessageParser$Part com/google/android/util/AbstractMessageParser$Photo com/google/android/util/AbstractMessageParser$Resources com/google/android/util/AbstractMessageParser$Smiley com/google/android/util/AbstractMessageParser$Token com/google/android/util/AbstractMessageParser$Token$Type com/google/android/util/AbstractMessageParser$TrieNode com/google/android/util/AbstractMessageParser$Video com/google/android/util/AbstractMessageParser$YouTubeVideo com/google/android/util/Procedure com/google/android/util/SmileyParser com/google/android/util/SmileyResources Bug: 187386774 Test: diff framework-doc-stubs/../api-versions.xml before and after Change-Id: I85b1485b4c5bc1b30a5d537e96d961382f298fb7
2021-05-10Use filegroups for test-{base,mock,runner} srcsAnton Hansson
This allows soong to infer the package of the given srcs, which in turns make it able to filter the inputs to metalava to exclude unwanted packages. This is part of a larger topic of changes intended to remove undesired classes from the public documentation. Bug: 187386774 Test: m Change-Id: I8196c306b743ce6ca8a6452d212f3d7c0b5b2b82
2021-05-10Merge "Add targets to build doc-stubs for non-updatable"Anton Hansson
2021-05-07Add targets to build doc-stubs for non-updatableAnton Hansson
Like the jar stubs, the doc stubs need modularization to avoid depending on module sources and instead being assembled by merging the doc stubs of the constituent modules. This will allow generating e.g. the lint database, annotation zips, and the documentation itself from prebuilts (which in turn allows mixing e.g. non-updatable R with the latest modules). Move the defaults for the non-updatable jar stubs to the shared bp file and reuse it for the non-updatable doc stubs, and add two targets for the public and the system stubs. Bug: 186197911 Test: m android-non-updatable-doc-stubs{,-system} Merged-In: Ic2cef748c42c141ea42b8cd7b4afd7ee78a1399d Change-Id: Ic2cef748c42c141ea42b8cd7b4afd7ee78a1399d
2021-05-07Add targets to build doc-stubs for non-updatableAnton Hansson
Like the jar stubs, the doc stubs need modularization to avoid depending on module sources and instead being assembled by merging the doc stubs of the constituent modules. This will allow generating e.g. the lint database, annotation zips, and the documentation itself from prebuilts (which in turn allows mixing e.g. non-updatable R with the latest modules). Move the defaults for the non-updatable jar stubs to the shared bp file and reuse it for the non-updatable doc stubs, and add two targets for the public and the system stubs. Bug: 186197911 Test: m android-non-updatable-doc-stubs{,-system} Change-Id: Ic2cef748c42c141ea42b8cd7b4afd7ee78a1399d
2021-05-05Merge "Remove --ignore-classes-on-classpath argument" am: c02168f5d1 am: ↵Anton Hansson
481ba3e20a am: 8bf15714d5 Original change: https://android-review.googlesource.com/c/platform/frameworks/base/+/1697265 Change-Id: I15a0a33b96f8a57ba7146166c458e92d397862fb
2021-05-05Remove --ignore-classes-on-classpath argumentAnton Hansson
This argument doesn't appear to alter the output. Bug: 186197911 Test: diff metadata.zip, stubs.srcjar, annotations.zip before and after Change-Id: I5147cf1f0658c78e5ab24952285c8fc1c036a55d
2021-03-31Delete framework-updatable-sources filegroupAnton Hansson
Inline these sources in the only place it is used. Test: presubmit Merged-In: I42e7044471262bf901b8c130a50e1a8a8170c600 Change-Id: I42e7044471262bf901b8c130a50e1a8a8170c600
2021-03-31Delete framework-updatable-sources filegroupAnton Hansson
Inline these sources in the only place it is used. Bug: 184125529 Test: presubmit Change-Id: I42e7044471262bf901b8c130a50e1a8a8170c600
2021-03-30Merge "Add framework-mime-sources to stubs generation" am: ba4eeb87dd am: ↵Anton Hansson
9c26127d17 am: 7e0527c567 Original change: https://android-review.googlesource.com/c/platform/frameworks/base/+/1655732 Change-Id: Id8119533bbd8320d81d0e8166086fd6565ba54b4
2021-03-30Merge "Add a shared filegroup for non-updatable stub sources" am: 4ffb28c5f3 ↵Anton Hansson
am: 4d79002c3c am: 916e38597d Original change: https://android-review.googlesource.com/c/platform/frameworks/base/+/1655731 Change-Id: I1ac2e12c782acac9087ff741676406557a19859e
2021-03-30Merge "Add **/package.html to docs srcs" am: f68b61fcee am: 28f3de76c3 am: ↵Anton Hansson
9f04baf35c Original change: https://android-review.googlesource.com/c/platform/frameworks/base/+/1655730 Change-Id: I2f65ea1516f747b49f75d857a0e7f16a66649e94
2021-03-30Add framework-mime-sources to stubs generationAnton Hansson
It was used in the docs stubs generation but it doesn't have its own (jar) stub generation. Add it to the shared non-updatable sources for consistency. The only class in these sources is @hide, so it makes no immediate difference. Test: diff android_stubs_current artifact before/after Change-Id: I33e75623d8d71da362fb16befb78c8c7596fa400
2021-03-30Add a shared filegroup for non-updatable stub sourcesAnton Hansson
It is always a mistake to add something to the stub sources but not the doc stub sources. Test: m Change-Id: I6b76f5d2c7f0adc01b8a9eb141f2f34d9c2d2967
2021-03-30Add **/package.html to docs srcsAnton Hansson
It is being used implicitly at the moment, make it explicit instead. r.android.com/1305139 added this to the other droidstubs. Bug: 153703940 Test: diff soong intermediates for framework-doc-stubs before and after Change-Id: I708cfd02b9096b0245fddbbfb46893d912edd197
2020-12-22Merge "Stop ignoring classes on the classpath for stubs" am: 61e082abdb am: ↵Anton Hansson
ab3f2d3aba am: 81bfcb40a3 Original change: https://android-review.googlesource.com/c/platform/frameworks/base/+/1533280 MUST ONLY BE SUBMITTED BY AUTOMERGER Change-Id: I814572df3ea32202a9f348901143d0b244dad56f
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-11Merge "Unbundle i18n API from android-non-updatable" am: 17e6d5b6a3 am: ↵Paul Duffin
3322b2800a am: f358ccece0 Original change: https://android-review.googlesource.com/c/platform/frameworks/base/+/1513291 MUST ONLY BE SUBMITTED BY AUTOMERGER Change-Id: I576e27b966d5e7b731a3f944bdee353e2cac9106
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-11-03Remove manual parceling from Interpolator and VolumeShaperYtai Ben-Tsvi
Change-Id: Ic5c3bfeb67c6e1b9b2b3c6275ea4badbef8536d3
2020-09-29Merge "Get ART public API doctag information from java_sdk_library" am: ↵Paul Duffin
08e7cbb0b5 am: ec334d86e0 am: c0ea6a6330 am: 0acdd44047 am: 23c51bd63b Original change: https://android-review.googlesource.com/c/platform/frameworks/base/+/1432683 Change-Id: If490ca0b4edd19766d1f86b6cb5ab0ef717f0a3e
2020-09-29Merge "Use ART stubs source generated by java_sdk_library" am: b996945678 ↵Paul Duffin
am: 54fa7623bc am: ad9299dcdb am: 471182f89e am: 860f8b380b Original change: https://android-review.googlesource.com/c/platform/frameworks/base/+/1428569 Change-Id: I530d440c283af2e592a13f08a694ec788b9adf29
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-09-22Separate AIDL packagesYtai Ben-Tsvi
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
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
generated by cgit v1.2.3 (git 2.25.1) at 2025-10-03 04:07:22 +0000