xref: /aosp_15_r20/prebuilts/runtime/mainline/README.md (revision 924841fff420cd6b931e1027ee46b85e0a18fe17)
1Prebuilts of APIs from platform and other Mainline modules that the ART Module
2needs.
3
4These prebuilts should reflect the APIs in Android 12 (version 31), which is the
5earliest release that may take an update of the ART Module. Hence updating the
6prebuilts to newer versions needs to be done with care. Prebuilts that are part
7of the NDK are generally safe since they are annotated to provide a version 31
8compatible ABI.
9
10To update:
11
121. Submit the changes that need to go into the prebuilts.
13
142. Wait for new builds on branches `aosp-main` and/or `aosp-main-throttled`,
15   depending on which prebuilts are required. See `update.py` for details about
16   which branches and targets are used for what.
17
18   In general `mainline_modules_sdks-trunk_staging-userdebug` is the slowest
19   build to complete, so look for that to be on the safe side.
20
213. Edit the list returned by `install_entries` in `update.py` in this directory
22   to only cover the updates you need (this change shouldn't be submitted).
23
244. Run:
25
26   ```
27   prebuilts/runtime/mainline/update.py \
28     --aosp-main-build <build id> --aosp-main-throttled-build <build id>
29   ```
30
31   where the two `<build id>` are the builds from step #2.
32
33   The script will download, extract and put the right prebuilts in the right
34   places in `prebuilts/runtime`, `prebuilts/module_sdk/conscrypt`, and/or
35   `prebuilts/module_sdk/StatsD`. However, some prebuilts may not have
36   corresponding CI builds so they may not be complete - see `update.py` for
37   details.
38
395. Make sure that riscv64 still works.
40
41   That architecture is currently not included in the SDK builds in CI (cf.
42   b/286551985). Either revert riscv64-related changes, or update them as well
43   following the process in README_riscv64.md.
44
456. Try to further minimize the updates in the created CLs and ensure they are
46   safe. This usually means reverting some prebuilts back to their old contents,
47   and reverting specific hunks in the `Android.bp` files. Also, please improve
48   the autogenerated CL descriptions to make them more accurate and describe the
49   reason for the update. Please avoid doing any other changes - in particular
50   there must be no local change in any prebuilt file (not counting
51   `Android.bp`'s). [email protected] is happy to help with reviews.
52
53Note that the script takes a `--local-dist` argument that you can use to test
54with prebuilts from a local build in another tree. However, CLs created that way
55should not be submitted.
56