native:emulator

​

Syntax

php artisan native:emulator {os}

​

Arguments

​

os

• android - Launch Android emulator
• ios - Launch iOS Simulator (launches Android instead currently)

​

Examples

​

Launch Android emulator

php artisan native:emulator android

​

What it does

1. Lists available Android emulators (AVDs)
2. Prompts you to select one
3. Launches the selected emulator
4. Waits for emulator to boot

​

Requirements

​

Android Emulator

1. Install Android Studio
2. Open SDK Manager (Tools > SDK Manager)
3. Install “Android Emulator” under SDK Tools
4. Create AVDs via AVD Manager (Tools > Device Manager)

​

Creating AVDs

1. Open Android Studio
2. Tools > Device Manager
3. Click “Create Device”
4. Choose device (e.g., Pixel 6)
5. Download a system image (e.g., Android 13)
6. Finish creation

​

Common workflows

​

Launch emulator before running

php artisan native:emulator android
php artisan native:run android

​

Check running emulators

adb devices

List of devices attached
emulator-5554   device

​

Alternative: iOS Simulator

# List available simulators
xcrun simctl list devices

# Boot a specific simulator
xcrun simctl boot "iPhone 15 Pro"

# Open Simulator app
open -a Simulator

php artisan native:run ios

​

Troubleshooting

​

”No emulators found”

1. Tools > Device Manager
2. Create Device
3. Follow wizard

​

”emulator: command not found”

# macOS/Linux - add to ~/.bashrc or ~/.zshrc
export ANDROID_HOME=$HOME/Library/Android/sdk
export PATH=$PATH:$ANDROID_HOME/emulator
export PATH=$PATH:$ANDROID_HOME/platform-tools

# Windows - add to System Environment Variables
# ANDROID_HOME = C:\Users\YourName\AppData\Local\Android\Sdk
# Path += %ANDROID_HOME%\emulator
# Path += %ANDROID_HOME%\platform-tools

​

Emulator won’t boot

# Kill existing emulator processes
adb kill-server
adb start-server

# Or from AVD Manager
# Tools > Device Manager > Right-click AVD > Wipe Data

​

Slow emulator performance

• Windows: Enable Intel HAXM or AMD Hypervisor
• macOS: Enable Hypervisor Framework (automatic)
• Linux: Enable KVM

​

See also

• native:run - Run app on emulator
• native:open - Open Android Studio