[automerger skipped] DO NOT MERGE - Merge Android 13 am: 7cc831d7fe -s ours am: 78a260e2d7 -s ours

am skip reason: Merged-In I9d92e3acb02e8063f7969d480be1593f66aaac30 with SHA-1 60afa40378 is already in history

Original change: https://android-review.googlesource.com/c/toolchain/pgo-profiles/+/2186985

Change-Id: Ie2af40c859be7aaf2225076bc69d01d4d4b75988
Signed-off-by: Automerger Merge Worker <android-build-automerger-merge-worker@system.gserviceaccount.com>
tree: f1bef5e13d9953ab8617f57296c754c6c8983380
  1. pgo/
  2. scripts/
  3. .gitignore
  4. METADATA
  5. OWNERS
  6. README.md
README.md

Android PGO Profiles

For the latest version of this doc, please make sure to visit: Android PGO Profiles

Getting the necessary dependencies

First, you need to install python-pip, as well as 2 packages from it.

$ sudo apt-get install python-pip
$ sudo pip install --upgrade google-api-python-client
$ sudo pip install --upgrade oauth2client

Updating PGO Profiles

We only update profiles in the Android release branch, so this script should be run directly from that location. The following is a sample command line for updating the PGO profiles:

$ python toolchain/pgo-profiles/scripts/update_profiles.py -b <BUG_NUMBER> --add-do-not-merge <BUILD_ID> ALL --profdata-suffix <YYYY-MM-DD>
$ repo upload --cbr toolchain/pgo-profiles/
# Each separate profile will be uploaded as a single patch, so that it can get appropriate reviews.

Note that you need to change that command to supply 3 pieces of information:

  • BUG_NUMBER: The buganizer bug number that should be part of the commit message. For Android R, that bug number is 150254950.
  • BUILD_ID: The build id from which to extract the PGO profiles. You should check go/ab for the given release branch.
  • YYYY-MM-DD: The date of the build that the profiles come from (to keep it easier to check for stale profiles).

More Information

PGO-related questions should be sent to the Android LLVM team's public list: android-llvm@googlegroups.com