StrixOS/build_soong
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Merge "Improve the docs about when to use introduced." into main am: 04e52144b6

Browse Source 
Original change: https://android-review.googlesource.com/c/platform/build/soong/+/2812358

Change-Id: I251332e390f2dd7044e61ce1924d2c8fc7dbeb0d
Signed-off-by: Automerger Merge Worker <android-build-automerger-merge-worker@system.gserviceaccount.com>
This commit is contained in:
Dan Albert
2024-09-11 23:09:54 +00:00
committed by Automerger Merge Worker
parent e24ae27939 04e52144b6
commit 4a229716c4
1 changed files with 11 additions and 6 deletions
Download Patch File Download Diff File Expand all files Collapse all files

17
docs/map_files.md
View File

@@ -88,12 +88,17 @@ but is useful when developing APIs for an unknown future release.
### introduced
Indicates the version in which an API was first introduced. For example,
`introduced=21` specifies that the API was first added (or first made public) in
API level 21. This tag can be applied to either a version definition or an
individual symbol. If applied to a version, all symbols contained in the version
will have the tag applied. An `introduced` tag on a symbol overrides the value
set for the version, if both are defined.
Indicates the version in which an API was first introduced in the NDK. For
example, `introduced=21` specifies that the API was first added (or first made
public) in API level 21. This tag can be applied to either a version definition
or an individual symbol. If applied to a version, all symbols contained in the
version will have the tag applied. An `introduced` tag on a symbol overrides the
value set for the version, if both are defined.
The `introduced` tag should only be used with NDK APIs. Other API surface tags
(such as `apex`) will override `introduced`. APIs that are in the NDK should
never use tags like `apex`, and APIs that are not in the NDK should never use
`introduced`.
Note: The map file alone does not contain all the information needed to
determine which API level an API was added in. The `first_version` property of