tequilaOS/platform_build
2
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity
platform_build/tools/finalization/README.md

26 lines
2.5 KiB
Markdown
Raw Normal View History

Minor renaming and documentation. Bug: 276752264 Test: local run Change-Id: I75814313a81ca041fa1461e48733bd40a020b777
2023-04-06 23:14:34 +02:00
# Finalization tools
This folder contains automation and CI scripts for [finalizing](https://go/android-finalization) Android before release.
## Automation:
1. [Environment setup](./environment.sh). Set values for varios finalization constants.
Split finalization scripts between vFRC and sFRC. This splits out the AIDL/VNDK/sepolicy stuff from the SDK finalization. However, in CI, we still do the vFRC step as part of the first step. We'll probably want to do some of the following: - (maybe) add CI for the first step - a 'fina-0' branch - add a way to do SDK finalizatoin without VINTF finalization because after VINTF finalization is submitted, people will develop in-progress interfaces that aren't done yet - a lot of VINTF finalization is still not automated, so things like sepolicy and LL-NDK need to be added here. Ignore-AOSP-First: b/304316873#comment10 Bug: 314010935 Test: N/A Change-Id: I4831a14f5c5c3d757bd1d10a775d8cf4940d9a4a
2023-12-16 03:51:26 +01:00
1. [Finalize VINTF](./finalize-vintf-resources.sh). Prepare the branch for VINTF release.
1. [Finalize SDK](./finalize-sdk-resources.sh). Prepare the branch for SDK release. SDK contains Android Java APIs and other stable APIs. Commonly referred as a 1st step.
1. [Finalize Android](./finalize-sdk-rel.sh). Mark branch as "REL", i.e. prepares for Android release. Any signed build containing these changes will be considered an official Android Release. Referred as a 2nd finalization step.
Define step-0 for vintf finalization Define `vintf` state that have completed vintf finalization only. Only if FINAL_STATE is 'unfinalized' run the vintf finalization process to finalize vintf. The new step-0 only runs the vintf finalization. Ignore-AOSP-First: trunk-stable changes (b/304316873) Bug: 318883690 Test: build-step-0.sh && build/soong/soong_ui.bash \ --make-mode TARGET_PRODUCT=cf_x86_64_phone TARGET_RELEASE=fina_0 \ TARGET_BUILD_VARIANT=userdebug droid dist Change-Id: If3525f38204fa546744b9ccf8dc9e63711823abd
2024-01-31 08:56:10 +01:00
1. [Finalize VINTF and submit](./step-0.sh). Do Finalize VINTF step, create CLs, organize them into topic and send to Gerrit.
1. [Finalize SDK and submit](./step-1.sh). Do Finalize SDK step, create CLs, organize them into topic and send to Gerrit.
Split finalization scripts between vFRC and sFRC. This splits out the AIDL/VNDK/sepolicy stuff from the SDK finalization. However, in CI, we still do the vFRC step as part of the first step. We'll probably want to do some of the following: - (maybe) add CI for the first step - a 'fina-0' branch - add a way to do SDK finalizatoin without VINTF finalization because after VINTF finalization is submitted, people will develop in-progress interfaces that aren't done yet - a lot of VINTF finalization is still not automated, so things like sepolicy and LL-NDK need to be added here. Ignore-AOSP-First: b/304316873#comment10 Bug: 314010935 Test: N/A Change-Id: I4831a14f5c5c3d757bd1d10a775d8cf4940d9a4a
2023-12-16 03:51:26 +01:00
1. [Finalize Android and submit](./step-2.sh). Do [Finalize Android](./finalize-sdk-rel.sh) step, create CLs, organize them into topic and send to Gerrit.
Minor renaming and documentation. Bug: 276752264 Test: local run Change-Id: I75814313a81ca041fa1461e48733bd40a020b777
2023-04-06 23:14:34 +02:00
## CI:
Performed in build targets in Finalization branches.
Define step-0 for vintf finalization Define `vintf` state that have completed vintf finalization only. Only if FINAL_STATE is 'unfinalized' run the vintf finalization process to finalize vintf. The new step-0 only runs the vintf finalization. Ignore-AOSP-First: trunk-stable changes (b/304316873) Bug: 318883690 Test: build-step-0.sh && build/soong/soong_ui.bash \ --make-mode TARGET_PRODUCT=cf_x86_64_phone TARGET_RELEASE=fina_0 \ TARGET_BUILD_VARIANT=userdebug droid dist Change-Id: If3525f38204fa546744b9ccf8dc9e63711823abd
2024-01-31 08:56:10 +01:00
1. [Finalization Step 0, git_main-fina-0-release](https://android-build.corp.google.com/build_explorer/branch/git_main-fina-0-release). Test Finalize VINTF.
Split finalization scripts between vFRC and sFRC. This splits out the AIDL/VNDK/sepolicy stuff from the SDK finalization. However, in CI, we still do the vFRC step as part of the first step. We'll probably want to do some of the following: - (maybe) add CI for the first step - a 'fina-0' branch - add a way to do SDK finalizatoin without VINTF finalization because after VINTF finalization is submitted, people will develop in-progress interfaces that aren't done yet - a lot of VINTF finalization is still not automated, so things like sepolicy and LL-NDK need to be added here. Ignore-AOSP-First: b/304316873#comment10 Bug: 314010935 Test: N/A Change-Id: I4831a14f5c5c3d757bd1d10a775d8cf4940d9a4a
2023-12-16 03:51:26 +01:00
1. [Finalization Step 1, git_main-fina-1-release](https://android-build.corp.google.com/build_explorer/branch/git_main-fina-1-release). Test Finalize VINTF, Finalize SDK.
1. [Finalization Step 2, git_main-fina-2-release](https://android-build.corp.google.com/build_explorer/branch/git_main-fina-2-release). Test Finalize VINTF, Finalize SDK, and [2nd step/Finalize Android](./finalize-sdk-rel.sh). Use [local finalization](./localonly-steps.sh) to build and copy presubmits.
1. [Local finalization steps](./localonly-steps.sh) are done only during local testing or in the CI lab. Normally these steps use artifacts from other builds.
Minor renaming and documentation. Bug: 276752264 Test: local run Change-Id: I75814313a81ca041fa1461e48733bd40a020b777
2023-04-06 23:14:34 +02:00
## Utility:
[Full cleanup](./cleanup.sh). Remove all local changes and switch each project into head-less state. This is the best state to sync/rebase/finalize the branch.
DryRun scripts. Bug: 323940469 Test: run locally Ignore-AOSP-First: local changes first Change-Id: Ia27924a01433e613496e9a624f93d385a08678a3
2024-03-15 04:14:14 +01:00
## Dry run:
[Full cleanup](./dryrun-cleanup.sh). Remove all local changes and switch each project into head-less state. Also removes "DryRun" branches.
[SDK](./dryrun-step-1.sh). Perform SDK finalization and upload the CLs to Gerrit.
[SDK and REL](./dryrun-step-1-and-2.sh). Perform SDK finalization, plus all necessary changes to switch configuration to REL, and upload the CLs to Gerrit.
Reference in a new issue Copy permalink