Google Git
Sign in
android / device / generic / car / refs/heads/main / . / tools
tree: 877d2f87c60c28344c849f3b56283347166d6226 [path history] [tgz]
  1. x86_64/
  2. aaos-sys-img2-1.xml
  3. create_avd_config.sh
  4. git_clone_projects.sh
  5. mk_car_avd.sh
  6. pack_avd_img.sh
  7. README.md
  8. remount.sh
  9. run_local_avd.sh
  10. test_pack_avd_img.sh
  11. test_run_local_avd.sh
tools/README.md

AAOS car AVD tools

This folder contains scripts to help you to build, run and share car AVD images. We intentailly keep this on the AOSP main trunk for vairous branches from Android 10.

Download the tools

  • To clone the tool only: git_clone_projects.sh
  • Link it into an Android source tree, e.g.:
ln -s $HOME/avd/car/tools $ANDROID_BUILD_TOP/device/generic/car/tools

Build an AVD image

This builds AOSP car x86_64 userdebug AVD.

. device/generic/car/tools/mk_car_avd.sh

Pack an AVD image

The standard way to pack an AVD image is to build emu_img_zip target. Whereas this script is just for a quick validation on other host via Android Emulator during development. Which can pack necessary image files to $HOME/Downloads/x86_64

device/generic/car/tools/test_pack_avd_img.sh
  • You can use it as an example to create your own script for an AVD target by pack_avd_img.sh.
  • pack_avd_img.sh contains brief descriptions of each file needed.
  • AVD device profile example: x86_64/devices.xml
  • SDK addon xml example: aaos-sys-img2-1.xml
    • You should edit the xml, e.g. ZIP_FILE_SIZE, SHASUM, zip url & etc. accordingly.

Start an AVD

New AVD config

To create a clean local AVD config and run with the latest Android Emulator engine from the SDK.

device/generic/car/tools/test_run_local_avd.sh

To run the existing AVD config.

device/generic/car/tools/run_local_avd.sh

Multiple AVDs

run_local_avd.sh allows you to setup and run multiple AVDs. You can crease a script for each of them. e.g.

AVD_IMAGE_DIR=$HOME/avd/aosp_car_x86_64/x86_64 \
  WORKDIR=$HOME/avd/aosp_car_x86_64 \
  ABI="x86_64" \
  $SCRIPT_DIR/tools/run_local_avd.sh
  • Deleting the WORKDIR will let the script create it from scratch next time as the 1st run.

Change the config

The default AVD config.ini are created as the following default settings at the 1st run. You can also change them at the 1st run, e.g.

ANDROID_SDK_ROOT="/Users/$USER/Library/Android/sdk" \
  WORKDIR="$HOME/avd/aosp_car_x86_64" \
  AVD_IMAGE_DIR="$HOME/avd/aosp_car_x86_64/x86_64" \
  ABI="x86_64" \
  DISPLAY_DENSITY=213 \
  DISPLAY_WIDTH=1920 \
  DISPLAY_HEIGHT=1080 \
  RAM_MB=3584 \
  ./run_local_avd.sh

The AVD can also be changed by editing the AVD config.ini directily, e.g. at:

$WORKDIR/.android/avd/my_car_avd_x86_64.avd/config.ini

Android Emulator startup options

You can append Android Emulator Command-line startup options as needed. E.g.

  • to wipe user data: ./run_local_avd.sh -wipe-data
  • to cold boot: ./run_local_avd.sh -no-snapshot-load