platform_build/tools/finalization/README.md
Alex Buynytskyy 10411eeb71 DryRun scripts.
Bug: 323940469
Test: run locally
Ignore-AOSP-First: local changes first

Change-Id: Ia27924a01433e613496e9a624f93d385a08678a3
2024-03-19 19:06:16 +00:00

2.5 KiB

Finalization tools

This folder contains automation and CI scripts for finalizing Android before release.

Automation:

  1. Environment setup. Set values for varios finalization constants.
  2. Finalize VINTF. Prepare the branch for VINTF release.
  3. Finalize SDK. Prepare the branch for SDK release. SDK contains Android Java APIs and other stable APIs. Commonly referred as a 1st step.
  4. Finalize Android. 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.
  5. Finalize VINTF and submit. Do Finalize VINTF step, create CLs, organize them into topic and send to Gerrit.
  6. Finalize SDK and submit. Do Finalize SDK step, create CLs, organize them into topic and send to Gerrit.
  7. Finalize Android and submit. Do Finalize Android step, create CLs, organize them into topic and send to Gerrit.

CI:

Performed in build targets in Finalization branches.

  1. Finalization Step 0, git_main-fina-0-release. Test Finalize VINTF.
  2. Finalization Step 1, git_main-fina-1-release. Test Finalize VINTF, Finalize SDK.
  3. Finalization Step 2, git_main-fina-2-release. Test Finalize VINTF, Finalize SDK, and 2nd step/Finalize Android. Use local finalization to build and copy presubmits.
  4. Local finalization steps are done only during local testing or in the CI lab. Normally these steps use artifacts from other builds.

Utility:

Full cleanup. Remove all local changes and switch each project into head-less state. This is the best state to sync/rebase/finalize the branch.

Dry run:

Full cleanup. Remove all local changes and switch each project into head-less state. Also removes "DryRun" branches. SDK. Perform SDK finalization and upload the CLs to Gerrit. SDK and REL. Perform SDK finalization, plus all necessary changes to switch configuration to REL, and upload the CLs to Gerrit.