Zhomart Mukhamejanov
f4d280ce40
SampleUpdater app was tested manually on a device. There are unit tests for utility classes. SampleUpdater app demonstrates how to use Android Update Engine to apply A/B (seamless) update. This CL contains demo of non-stream update using async update_engine, which is accessed directly from an activity. This app also shows logs from update_engine on the UI. Instructions can be found in `README.md`. - Create a UI with list of configs, current version, control buttons and a progress bar - Add PayloadSpec and PayloadSpecs for working with update zip file - Add UpdateConfig for working with json config files - Add applying non-streaming update Test: tested manually and unit tests for utilities Change-Id: I05d4a46ad9cf8b334c9c60c7dd4da486dac0400a Signed-off-by: Zhomart Mukhamejanov <zhomart@google.com>
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.
- Compile the app
$ mmma bootable/recovery/sample_updater. - Install the app to the device using
$ adb install <APK_PATH>. - 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
PayloadSpecandPayloadSpecsfor working with update zip file - Add
UpdateConfigfor 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
- Build
$ mmma bootable/recovery/sample_updater/ - Install app
$ adb install $OUT/system/app/SystemUpdaterSample/SystemUpdaterSample.apk - Install tests
$ adb install $OUT/testcases/SystemUpdaterSampleTests/SystemUpdaterSampleTests.apk - Run tests
$ adb shell am instrument -w com.example.android.systemupdatersample.tests/android.support.test.runner.AndroidJUnitRunner - 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