74 lines
2.6 KiB
Markdown
74 lines
2.6 KiB
Markdown
|
# 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](https://developer.android.com/studio/run/emulator-commandline#common) as needed. E.g.
|
||
|
|
* to wipe user data: ./run_local_avd.sh -wipe-data
|
||
|
|
* to cold boot: ./run_local_avd.sh -no-snapshot-load
|