HQarroum/docker-android
Docker Android
This project provides a containerized runtime for Android emulator virtualization, allowing virtual Android devices to run within isolated container environments. It is designed to support headless emulation and device orchestration for use in continuous integration and development pipelines.
The system differentiates itself by implementing GPU hardware acceleration via passthrough to improve graphics rendering performance. It also utilizes external SDK mounting and volume-mapped state persistence to reduce image size and maintain emulator data across restarts.
The environment supports remote debugging through network port mapping and the Android Debug Bridge. It allows for the customization of emulator specifications, including the target API level, CPU architecture, and operating system version.
Automated deployment scripts are provided to set up the container engine, verify hardware virtualization, and build the emulator image.
Features
- Containerized Emulator Runtimes - Wraps an Android emulator and its dependencies inside an isolated container image for consistent deployment.
- Android Containerization - Provides a containerized runtime environment for running virtual Android devices on non-Android host operating systems.
- Hardware-Accelerated Rendering - Offloads the composition of visual layers to the host GPU for improved emulator display performance.
- GPU Passthrough Acceleration - Implements direct GPU hardware passthrough to accelerate graphics rendering in the container.
- Hardware-Accelerated Emulators - Leverages native hardware translation and GPU passthrough for high-performance Android emulation.
- Android Emulator Orchestration - Enables deploying and configuring multiple Android emulator instances with specific API levels and hardware profiles.
- Android App Containers - Provides a full Linux-based container environment for executing a virtualized Android runtime.
- Emulator Image Configurations - Enables customization of the operating system version, CPU architecture, and image type during the emulator build process.
- Device Specifications - Allows defining the API level, device architecture, and image type to target specific Android OS versions.
- Headless Virtualization - Runs the Android system without a graphical user interface by leveraging a virtual frame buffer.
- Headless Android Emulation - Starts virtual Android devices within containers to provide a headless environment with configurable hardware profiles.
- Container Filesystem Mounts - Shares the Android SDK from the host filesystem into the container via filesystem mounts.
- SDK Volume Mounts - Supports mounting the Android SDK from a shared external filesystem to reduce image size.
- ADB Remote Control Platforms - Exposes ADB functionality over the network for remote shell access and application deployment.
- Remote Debugging Bridges - Provides a network interface to stream Android device state and actions to a local debugger.
- Remote Debugging Environments - Provides a container-based environment for attaching development tools to remote Android devices.
- Filesystem Persistence Volumes - Maps host directories to the container to persist the emulator's disk image and user data.
- Container Storage Persistence - Implements host-level storage mapping to ensure emulator state durability across service restarts.
- Remote Debugging Port Forwarding - Maps virtual Android device ports to the host to enable IDE and debugger communication.
- GPU-Accelerated UI Rendering - Utilizes GPU-accelerated pipelines to render the virtual Android user interface.
- CI Integration Testing - Executes automated test suites within a containerized pipeline using headless Android emulators.
