Troubleshooting

Troubleshooting

"Android SDK not found"

Cause: The extension couldn't locate your Android SDK.

Fix:

1. Run Caspian: Setup Android SDK from the Command Palette
2. Browse to your SDK folder (must contain platform-tools/adb and emulator/emulator)
3. Or set caspian.androidSdkPath in VS Code settings

No AVDs Listed

Cause: No Android Virtual Devices exist on your system.

Fix:

• Create one via Caspian: Create AVD (requires system images)
• Or create in Android Studio → Device Manager
• Click the refresh button after creating

Emulator Won't Start

Cause: Usually a hardware acceleration or GPU issue.

Fix:

• Ensure Intel HAXM (Windows/Mac) or KVM (Linux) is installed
• Try software rendering: set caspian.emulatorArgs to ["-gpu", "swiftshader_indirect"]
• Check logs: run emulator -avd <name> -verbose in a terminal

Device Shows "unauthorized"

Cause: USB debugging not authorized on the device.

Fix:

• Check the device/emulator screen for an authorization dialog
• Tap "Allow" or "Always allow from this computer"
• Refresh the device list

Device Shows "offline"

Cause: ADB connection dropped.

Fix:

• Restart ADB: run adb kill-server && adb start-server in a terminal
• Reconnect the USB cable (for physical devices)
• Restart the emulator (for virtual devices)

Logcat Not Showing Output

Cause: Connection issue or filter too restrictive.

Fix:

• Ensure device state is "device" (not offline/unauthorized)
• Set priority filter to "Verbose" to see all logs
• Clear the search filter
• Click Clear to restart the logcat stream

Screen Mirror Shows Nothing

Cause: screencap command failed on the device.

Fix:

• Ensure the device is fully booted
• Try taking a manual screenshot first (Caspian: Take Screenshot)
• Install scrcpy for better screen mirroring

File Explorer Permission Denied

Cause: Trying to access a restricted directory.

Fix:

• Some directories require root access
• Browse /sdcard/ for user-accessible files
• For rooted devices: run adb root in a terminal first

Extension Not Activating

Cause: Extension didn't load properly.

Fix:

• Check Output panel → select "Caspian Emulator" from the dropdown
• Reload VS Code: Ctrl+Shift+P → "Developer: Reload Window"
• Check that VS Code version is 1.85 or later