Whale Shark - an AAOS device configuration for 64-bit-based Android Emulator hosts

🧑‍💻 About

This device configuration is intented to be run on Android Virtual Device (AVD) emulator hosts with a 64-bit CPU, such as the new MacBook generations with Apple Silicon processor (M1/M2/M3).

See also aosp-docker for a Docker-based tool chain and android-build-tools for additonal sync and flash scripts.

🛠️ Setup

Download AOSP repository

See manifest for setup of AOSP repository and dependencies.

⚙️ Build the product

This follows the normal AOSP approach, e.g.

1. source build/envsetup.sh
2. lunch whaleshark_emulator_arm64-trunk_staging-userdebug
3. make clobber (optionally, cleans target folder)
4. m -j$(nproc --all)
5. See compiled files at $AOSP_HOME/out/target/product/emulator_car64_arm64

Info: With Android 15, release flags have been introduced. See also aconfigs in ${AOSP_HOME}/build/release

✨ Flash the build

You can use the sync_remote_emulator_images.sh script from here to directly sync the emulator images to your $ANDROID_SDK_HOME/system-images folder.

🖥️ Android Virtual Device (AVD) configuration

Setup

Copy the appropriate avd folder to your localhost into $HOME/.android/avd

mkdir -p $HOME/.android/avd

cp -r avd/whaleshark-35.avd $HOME/.android/avd/whaleshark-35.avd

cp avd/whaleshark-35.ini $HOME/.android/avd/whaleshark-35.ini

Run the Emulator

Install the Android SDK and set $ANDROID_HOME. See also this.

Install the Android Emulator with version 33.1.23.x or higher.

Execute the Emulator: $ANDROID_HOME/emulator/emulator -avd whaleshark-35 -show-kernel