Tutorials

Flutter App auf einem echten Android-Gerät ausführen – Schritt-für-Schritt Tutorial

Melden

Hier ist ein ausführliches Tutorial, wie du deine Flutter-App auf einem echten Android-Smartphone installierst und testest.

Das Testen auf einem echten Gerät ist entscheidend, da Emulatoren oft nicht die volle Performance oder Hardware-Features (wie Kamera oder Sensoren) widerspiegeln können.

1. Voraussetzungen

Bevor du startest, stelle sicher, dass:

  • Flutter SDK auf deinem Computer installiert ist.
  • Android Studio (oder VS Code) eingerichtet ist.
  • Ein passendes USB-Kabel vorhanden ist.

2. Schritt: Entwickleroptionen am Smartphone aktivieren

Android-Geräte erlauben standardmäßig keine Installation von Apps über USB. Dies musst du manuell freischalten:

  1. Öffne die Einstellungen auf deinem Android-Handy.
  2. Gehe zu Über das Telefon (oder "Telefoninfo").
  3. Suche den Eintrag Build-Nummer.
  4. Tippe 7-mal schnell hintereinander auf die Build-Nummer, bis die Meldung erscheint: "Du bist jetzt ein Entwickler".
  5. Gehe zurück in das Hauptmenü der Einstellungen und suche nach System > Entwickleroptionen (bei manchen Geräten unter "Zusätzliche Einstellungen").
  6. Aktiviere dort den Schalter bei USB-Debugging.

3. Schritt: Gerät mit dem Computer verbinden

  1. Verbinde dein Handy per USB-Kabel mit deinem PC/Mac.
  2. Auf dem Handy erscheint meist eine Abfrage: "USB-Debugging zulassen?".
  3. Setze den Haken bei "Von diesem Computer immer zulassen" und bestätige mit OK.

Tipp: Falls das Handy nur geladen wird, stelle den USB-Modus in der Benachrichtigungsleiste von "Nur Laden" auf "Dateiübertragung (MTP)" um.

4. Schritt: Verbindung prüfen

Überprüfe nun, ob Flutter dein Gerät erkennt. Öffne ein Terminal (Eingabeaufforderung oder PowerShell) und tippe ein:

flutter devices

Du solltest nun den Namen deines Smartphones in der Liste sehen. Falls dort "No devices available" steht, prüfe das Kabel oder die Treiber.

5. Schritt: Die App starten

Du hast nun zwei Möglichkeiten, die App auszuführen:

Methode A: Über VS Code (Empfohlen)

  1. Öffne dein Flutter-Projekt in VS Code.
  2. In der unteren Statusleiste (rechts) siehst du das aktuell ausgewählte Gerät. Klicke darauf, falls noch der Emulator ausgewählt ist, und wähle dein echtes Handy aus.
  3. Drücke F5 oder gehe auf Run > Start Debugging.

Methode B: Über das Terminal

Tippe folgenden Befehl im Hauptverzeichnis deines Projekts ein:

flutter run

6. Troubleshooting (Häufige Probleme)

  • Gerät wird nicht erkannt: Installiere die Google USB Driver (nur für Windows nötig). Bei Samsung oder Huawei-Geräten sind manchmal herstellereigene Treiber erforderlich.
  • Fehler beim "AssembleDebug": Stelle sicher, dass dein Handy eine Android-Version hat, die mit der minSdkVersion in deiner android/app/build.gradle kompatibel ist.
  • Keine Berechtigung: Falls die Installation fehlschlägt, prüfe, ob auf deinem Handy eine Sicherheitsapp (z.B. von Xiaomi) das Installieren von Apps über USB blockiert.

Bonus: Kabelloses Debugging (Wireless Debugging)

Wenn du Android 11 oder neuer nutzt, kannst du die App auch ohne Kabel übertragen:

  1. PC und Handy müssen im selben WLAN sein.
  2. Gehe in die Entwickleroptionen > Wireless Debugging.
  3. Nutze den Befehl adb pair [IP-Adresse] oder verbinde dich direkt über die Android Studio Oberfläche ("Pair Devices Using Wi-Fi").

Viel Erfolg beim Programmieren deiner Flutter-App!

0