Skip to content

QFLASH21 v2.2.0 – White-Screen behoben (Interceptor-Architektur)

Choose a tag to compare

@batko15 batko15 released this 18 Sep 17:41
· 3 commits to main since this release

QFLASH21 v2.2.0 – WHITE-SCREEN BEHOBEN ✅ (Interceptor-Architektur)

Was war das Problem?

v2.1.0 servierte die Oberfläche über einen lokalen HTTP-Server (127.0.0.1:21921).
Die Analyse hat bewiesen: Die gesamte Web-Oberfläche und die Server-Logik sind fehlerfrei
(exakt dieselben Assets rendern in Desktop-Chromium perfekt). Das Problem ist die
Netzwerkschicht auf dem Gerät: Die WebView erreicht den Loopback-Server nicht
(bekanntes Cleartext/localhost-Problem der Android WebView, kombiniert mit
ROM-/VPN-Interferenz). Ergebnis: weiße Fläche – ohne jede Meldung.

Die Lösung: keine Netzwerkschicht mehr!

v2.2.0 nutzt das offizielle WebViewAssetLoader-Muster (developer.android.com):
Alle Requests der virtuellen Domain https://appassets.androidplatform.net/ werden
im WebView selbst abgefangen (shouldInterceptRequest) und direkt aus der APK
beantwortet.

  • Kein Socket, kein Port, kein Cleartext, kein DNS – strukturell immun gegen
    alle v2.1.0-Ausfallursachen
  • Nie wieder weiß: Bei jedem Ladefehler zeigt die App eine deutsche Fehlerseite
    mit Diagnose + „Diagnose kopieren" + „ERNEUT VERSUCHEN" (statt weißer Fläche)
  • Render-Watchdog fängt leere Seiten ab; WebView-Renderer-Crash → automatischer Neuaufbau
  • Konfigs-Download jetzt nativ nach Downloads/ (MediaStore)

Installation

  1. APK herunterladen (unten, QFLASH21-v2.2.0.apk, ~9 MB)
  2. Direkt über die alte Version installieren (gleiche Signatur → kein Deinstallieren)
  3. App öffnen → Oberfläche erscheint sofort (Flugmodus egal)
  4. K+DCAN-Kabel per USB-OTG → USB-Berechtigung → „Verbinden"

Falls doch einmal etwas nicht lädt: Dann zeigt die App KEIN weißes Bild, sondern
eine Fehlerseite mit Ursache → „Diagnose kopieren" → Bericht hier in den Chat.

Technische Details

Eigenschaft Wert
Package de.qflash21.app
versionCode 52
APK-Größe ~8,9 MB
Signatur SHA-256 6c62fd…ca7e (identisch zu allen Vorgängern)
Architektur shouldInterceptRequest → AssetManager (kein Server)
Virtuelle Domain https://appassets.androidplatform.net/ (Google-reserviertes Muster)
USB-Treiber FTDI · CH340 · CP2102 (nativ, aus Linux-Kernel portiert)
Netzwerk KEINS benötigt

Changelog

  • FIX: White-Screen Root-Cause behoben (Interceptor statt Loopback-Server)
  • NEU: QfNativeApi-Brücke: Operationshistorie + DTC-Analyse + Downloads nativ
  • NEU: Deutsche Fehlerseiten mit Diagnose-Kopieren statt weißem Screen
  • NEU: Render-Watchdog + WebView-Renderer-Crash-Recovery
  • GEBER: usesCleartextTraffic entfernt (nicht mehr nötig)
  • USB-Treiberschicht unverändert (FTDI/CH340/CP2102, 5-Baud-Init via BREAK)

Download: Auch verfügbar unter https://qflashk.vercel.app/apk/QFLASH21-v2.2.0.apk