Debug Android Flutter apps including runtime errors, build issues, device connection problems, and performance issues. Use when troubleshooting Android-specific problems, crashes, or deployment issues.

2025-12-310

name	android-debug
description	Debug Android Flutter app runtime errors, crashes, device issues, and performance problems

Android App Debugging

Expert guidance for debugging Android Flutter applications - runtime errors, device connectivity, and performance.

When to Use

App crashes or runtime errors on Android
Device/emulator connection issues
Performance problems (lag, memory, battery)
Platform channel issues
Native Android integration bugs

Diagnostic Workflow

1. Gather Information

flutter doctor -v          # System check
flutter devices            # Connected devices
flutter run --verbose      # Verbose app launch
flutter logs               # App logs (or: adb logcat)

2. Device Connection

adb devices                          # List devices
adb kill-server && adb start-server  # Restart ADB
adb connect <ip>:5555               # Network device

3. Runtime Debugging

flutter run -d <device-id> --verbose  # Run with logging
flutter run --profile                 # Profile mode
flutter run --profile --trace-skia    # Skia tracing

4. Log Analysis

flutter logs | grep -i "flutter"     # Filter Flutter logs
adb logcat -s flutter                # Android-specific
adb logcat -c                        # Clear logs
adb logcat > debug.log               # Save to file

Common Issues

App Crashes on Startup

Check logs: flutter logs
Look for stack traces in logcat
Verify AndroidManifest.xml permissions
Check minSdkVersion in android/app/build.gradle.kts

UI Lag / Jank

flutter run --profile              # Profile mode
flutter run --profile --trace-skia # With Skia tracing

Use Flutter DevTools Timeline tab
Check for expensive operations in build methods
Add const constructors, use RepaintBoundary

Memory Leaks

Use DevTools Memory tab
Check for undisposed controllers
Review image caching strategy
Look for retained references in closures

Large APK Size

flutter build apk --analyze-size

R8 shrinking is enabled in this project
Check for unused dependencies in pubspec.yaml

DevTools

flutter pub global activate devtools
flutter pub global run devtools

Features: Widget Inspector, Timeline, Memory, Network, Logging, Debugger

ADB Quick Reference

adb shell screencap /sdcard/screen.png && adb pull /sdcard/screen.png  # Screenshot
adb shell dumpsys package com.cmwen.private_chat_hub                   # App info
adb shell am force-stop com.cmwen.private_chat_hub                     # Force stop
adb shell pm clear com.cmwen.private_chat_hub                          # Clear data