Updating RenderScript

For the latest version of this doc, please make sure to visit:
Android RenderScript Prebuilts Doc

Updating LLVM Libraries

Loop over llvm, clang, compiler-rt (in this order):

1. Do a squashed merge of aosp/dev to aosp/master.

   repo start update .
   git fetch aosp dev
   git merge --squash aosp/dev
   git commit -a
   repo upload .
   

2. Test everything before submitting the patch from the previous step.

3. Grab the squashed commit and replay it in aosp/dev.

   repo sync .
   git remote update
   git branch -D clean_master
   git checkout -b clean_master aosp/master
   git checkout working_dev
   

   Use -s ours to ensure that we skip the squashed set of changes.
   If/when we forget this, we have to do it later.

   git merge -s ours clean_master
   git push aosp refs/heads/working_dev:refs/heads/dev
   git branch -D clean_master
   

4. Clean up after our working branch.

   git checkout --detach
   git branch -D working_dev
   

This works better because we can keep full history in aosp/dev, while
maintaining easy reverts/commits through aosp/master.

Generating New Prebuilts

1. Set RS_LLVM_PREBUILTS_VERSION in build/core/clang/config.mk to the latest
   prebuilts generated for this rebase, or to the latest platform version if no
   new prebuilts were generated.
2. Iteratively attempt to build the platform and fix any API differences in
   frameworks/compile/slang, and/or frameworks/compile/libbcc. This may entail
   updating the various snapshots of Bitcode Readers/Writers.

3. Update RenderScript prebuilts.

   cd $ANDROID_BUILD_TOP/frameworks/rs
   ./update_rs_prebuilts.sh
   

4. The prebuilts get copied to prebuilts/sdk, so we must upload the
   relevant bits from there.

   cd $ANDROID_BUILD_TOP/prebuilts/sdk
   git commit -a
   repo upload .
   

5. Submit CLs.

Testing Checklist

1. Go to external/llvm and run ./android_test.sh (no known failures
   as of 2015-10-08).
2. Ensure successful build for all architectures: 32- and 64- bit ARM, x86 and
   Mips.
3. Run 32- and 64- bit RenderScript CTS at least for ARM and AArch64.
4. Test RenderScript apps: RsTest, ImageProcessing, and finally
   RSTest_Compatlib in compatibility mode.
5. Test old APKs with rebased tools: grab the above apps from a different tree
   (i.e. without the rebase), push them to a device with the rebased tools, and
   test.
   This ensures that the rebased BitcodeReader can read the output of old
   BitcodeWriters.
6. Test new APKs on an old device: test freshly built APKs for
   RSTest_V{11,14,16}, and ImageProcessing_2 on an old device (say Manta) and
   ensure they pass.
   This ensures that the rebase did not break the 2.9 and 3.2 BitcodeWriters.

Checklist for CLs

The following projects will almost always have CLs as a part of the rebase.
Depending on the changes in LLVM, there might be updates to other projects as
well.

• External projects

• external/clang

• external/compiler-rt
• external/llvm
• frameworks/compile/mclinker

• RenderScript projects

• frameworks/compile/libbcc

• frameworks/compile/slang
• frameworks/rs

• Prebuilts

• prebuilts/sdk

• CTS tests

• cts/tests/tests/renderscript

• cts/tests/tests/renderscriptlegacy
• cts/tests/tests/rscpp