android_bootable_recovery/updater_sample

SystemUpdaterSample

This app demonstrates how to use Android system updates APIs to install OTA updates. It contains a sample client for update_engine to install A/B (seamless) updates and a sample of applying non-A/B updates using recovery.

A/B (seamless) update is available since Android Nougat (API 24), but this sample targets the latest android.

Running on a device

The commands expected to be run from $ANDROID_BUILD_TOP.

1. Compile the app $ mmma bootable/recovery/updater_sample.
2. Install the app to the device using $ adb install <APK_PATH>.
3. Add update config files.

Update Config file

Directory can be found in logs or on UI. Usually json config files are located in /data/user/0/com.example.android.systemupdatersample/files/configs/. Example file is located at res/raw/sample.json.

Development

• Create a UI with list of configs, current version, control buttons, progress bar and log viewer
• Add PayloadSpec and PayloadSpecs for working with update zip file
• Add UpdateConfig for working with json config files
• Add applying non-streaming update
• Add applying streaming update
• Prepare streaming update (partially downloading package)
• Add tests for MainActivity
• Add stop/reset the update
• Verify system partition checksum for package
• HAL compatibility check
• Change partition demo
• Add non-A/B updates demo

Running tests

1. Build $ mmma bootable/recovery/updater_sample/
2. Install app $ adb install $OUT/system/app/SystemUpdaterSample/SystemUpdaterSample.apk
3. Install tests $ adb install $OUT/testcases/SystemUpdaterSampleTests/SystemUpdaterSampleTests.apk
4. Run tests $ adb shell am instrument -w com.example.android.systemupdatersample.tests/android.support.test.runner.AndroidJUnitRunner
5. Run a test file

   $ adb shell am instrument \
     -w com.example.android.systemupdatersample.tests/android.support.test.runner.AndroidJUnitRunner \
     -c com.example.android.systemupdatersample.util.PayloadSpecsTest
   

Getting access to update_engine API and read/write access to /data

Run adb shell as a root, and set SELinux mode to permissive (0):

$ adb root
$ adb shell
# setenforce 0
# getenforce