Repository navigation
Releases
QFLASH21 v2.3.0 – Native Selbst-Diagnose + Reparaturleiter
QFLASH21 v2.3.0 – Native Selbst-Diagnose + Reparaturleiter 🔧
Wichtig: Bitte beim ersten Start die Statusleiste oben beobachten! Sie zeigt
jetzt App-Version, WebView-Version, Ladephase und jeden Fehler – damit sehen wir bei
jedem Problem sofort die Ursache.
Was ist neu?
Befund: v2.2.0 blieb auf deinem Gerät komplett weiß – nicht mal die eingebaute
Fehlerseite war sichtbar. Das bedeutet: Die WebView selbst hat nichts gerendert
(der Inhalt selbst ist nachgewiesen in Ordnung).
Deshalb macht die App sich jetzt selbstständig diagnostizierbar:
- Native Statusleiste (außerhalb der WebView, verschwindet nach erfolgreichem Start):
QFLASH21 v2.3.0 · Standalone · WebView: Chromium <Version>- Ladephase („Lade Oberfläche…", „Seite empfangen – prüfe Rendering…")
- Jeder Fehler + JS-Konsolenfehler wird angezeigt
- Automatische Reparaturleiter bei leerem/hängendem Bild:
- Versuch 1: Neuladen ohne Cache
- Versuch 2: Neuaufbau mit Software-Rendering (behebt Grafik-Probleme von ROMs)
- Versuch 3: Direkter Datei-Modus – lädt die Oberfläche direkt aus der APK,
komplett ohne Netzwerkschicht (bewiesen getestet: funktioniert) - Versuch 4: Nativer Fehlerbericht mit „Bericht kopieren" + „App neu starten"
- Layout-Root auf Standard-FrameLayout umgestellt (entfernt einen möglichen
Render-Risikofaktor aus v2.2.0)
Installation
- QFLASH21-v2.3.0.apk herunterladen (~9 MB) und drüber installieren
(gleiche Signatur → kein Deinstallieren) - App starten → Statusleiste oben lesen:
- Verschwindet sie nach wenigen Sekunden → ✅ alles funktioniert
- Bleibt sie mit Warnungen → die App repariert sich selbst (Versuche 1–3)
- Erscheint ein Fehlerbericht → „Bericht kopieren" antippen und hier in den Chat einfügen
- K+DCAN per USB-OTG → „Verbinden" → System-Check sollte grün sein
Technische Details
| Eigenschaft | Wert |
|---|---|
| Package | de.qflash21.app |
| versionCode | 53 |
| APK-Größe | ~8,9 MB |
| Signatur SHA-256 | 6c62fd…ca7e (identisch zu allen Vorgängern) |
| Lade-Pfade | Interception (https://appassets.androidplatform.net) + Software-Renderer + file:// |
| USB-Treiber | FTDI · CH340 · CP2102 (nativ, unverändert) |
Download: https://qflashk.vercel.app/apk/QFLASH21-v2.3.0.apk
QFLASH21 v2.2.0 – White-Screen behoben (Interceptor-Architektur)
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
- APK herunterladen (unten,
QFLASH21-v2.2.0.apk, ~9 MB) - Direkt über die alte Version installieren (gleiche Signatur → kein Deinstallieren)
- App öffnen → Oberfläche erscheint sofort (Flugmodus egal)
- 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:
usesCleartextTrafficentfernt (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
QFLASH21 v2.1.0 – Standalone (100 % offline)
QFLASH21 v2.1.0 – Standalone Android-App (100 % offline)
Diese Version ist die Antwort auf die Anforderung: Die App ist jetzt komplett eigenständig (standalone).
Was ist neu gegenüber v2.0.0?
- Gesamte Web-App ins APK eingebettet: Die komplette Oberfläche (HTML, alle JS-Chunks, CSS, Icons, DeepOBD-Konfigs-ZIP) liegt jetzt im APK selbst und wird von einem lokalen Server (127.0.0.1) in der App ausgeliefert.
- 100 % offline-fähig: Kein Internet, keine Website, kein Chrome nötig. Flugmodus-Test bestanden by design.
- Lokale APIs: Operationshistorie (
/api/logs) + DTC-Analyse (/api/analyze-dtc) laufen direkt in der App (lokale JSON-Datei). - Konfigs-Download offline: DeepOBD-Konfigs-ZIP landet per DownloadManager in
Downloads/.
Installation
- APK herunterladen (unten,
QFLASH21-v2.1.0.apk, ~9 MB) - Direkt über die installierte v2.0.0 / v1.3.x drüber installieren (gleiche Signatur → kein Deinstallieren nötig)
- App starten → lädt sofort offline die komplette Oberfläche
- K+DCAN-Kabel per USB-OTG anschließen → USB-Berechtigung erteilen → „Verbinden"
Architektur
┌─────────────────────────────────────────────┐
│ QFLASH21.apk (9,0 MB) │
│ ┌───────────────────────────────────────┐ │
│ │ MainActivity (WebView) │ │
│ │ └─ lädt http://127.0.0.1:21921 │ │
│ ┌───────────────────────────────────────┐ │
│ │ QfAssetServer (Loopback, offline) │ │
│ │ └─ serviert assets/www (im APK) │ │
│ │ └─ /api/logs + /api/analyze-dtc │ │
│ ┌───────────────────────────────────────┐ │
│ │ SerialBridge → Android USB-Host-API │ │
│ │ └─ FTDI · CH340 · CP2102 (nativ) │ │
│ └───────────────────────────────────────┘ │
└─────────────────────────────────────────────┘
↓ USB-OTG
K+DCAN-Kabel → OBD2 → DDE4 (EDC15C4)
Technische Details
| Eigenschaft | Wert |
|---|---|
| Package | de.qflash21.app |
| versionCode | 51 |
| APK-Größe | 9.255.338 Bytes (~9,0 MB) |
| Signatur SHA-256 | 6c62fd…ca7e (identisch zu v1.3.x/v2.0.0) |
| USB-Treiber | FTDI SIO · CH340 · CP2102 (eigene Implementierung, aus Linux-Kernel portiert) |
| Netzwerk | KEINS benötigt (Loopback 127.0.0.1 intern) |
Falls Probleme
Die App zeigt bei jedem Absturz einen deutschen Fehlerbericht mit Stacktrace + Geräteinfo. Über „Fehler kopieren" kopieren und hier in den Chat einfügen.
Download: Auch verfügbar unter https://qflashk.vercel.app/apk/QFLASH21-v2.1.0.apk
v2.0.0 – ECHTE NATIVE Android-App (kein Chrome nötig)
🔥 Native Android-App – kompletter Neuanfang
Die TWA-Versionen (v1.0–v1.3.1) hatten zu viele Abhängigkeiten (Chrome, Web Serial, Domain-Verifizierung). v2.0.0 ist eine echte native App mit eigener USB-Serial-Treiberschicht.
Architektur
- WebView lädt die QFLASH21-Oberfläche,
SerialBridge(window.QfSerialBridge) exponiert die Android USB-Host-API nativ an die Web-App - Treiber: FTDI FT232R/FT231X, CH340/CH341, CP2102 – Baudraten-/BREAK-Mathematik 1:1 aus dem Linux-Kernel (
ftdi_sio.c,ch341.c,cp210x.c) - Kein Chrome, keine Web-Serial-API, keine assetlinks-Verifikation – K+DCAN per USB-OTG auf jedem Android ab 7.0
- 5-Baud-Init über natives BREAK, RX-Pump-Thread mit 64-KB-Ringpuffer, USB-Detach-Erkennung
- Deutscher Fehlerbericht (CrashActivity) bei jedem Absturz mit „Fehler kopieren“
- Nur 100 KB, versionCode 50, gleiche Signatur wie v1.3.x → Upgrade ohne Deinstallation
Installation
- APK herunterladen und öffnen (Sideload – MagicOS „Reiner Modus“ ggf. deaktivieren)
- K+DCAN-Kabel per USB-OTG anschließen
- App starten → „Verbinden“ → USB-Berechtigung bestätigen → System-Check muss „Native-App-Modus“ (grün) zeigen
Signatur SHA-256: 6C:62:FD:BC:A4:83:57:15:77:A3:98:16:23:F0:EB:03:70:7A:A3:CA:41:28:2B:54:F7:5E:F1:18:96:31:CA:7E
v1.3.1 – Start-Crash behoben (App schließt nicht mehr sofort)
🔧 Kritischer Fix: App startet und schließt sofort
Root Cause (v1.3.0): Das Manifest erwartete de.qflash21.app.MainActivity, die Klasse lag im DEX aber noch unter de.qflash21.launcher.MainActivity → ClassNotFoundException beim Start → sofortiges Schließen.
Neu in v1.3.1 (versionCode 41)
- ✅
MainActivitykorrekt im Packagede.qflash21.app(DEX-verifiziert im Build) - ✅ Nativer deutscher Fehlerbericht bei jedem Crash (Stacktrace + Geräteinfo + „Fehler kopieren“-Button) – die App verschwindet nie stumm
- ✅ WebView-Fallback: App öffnet auch ohne Chrome / ohne Domain-Verifizierung
- ✅ APK von 2,6 MB auf 1,5 MB verkleinert (versehentlich eingebetteter Eclipse-Compiler entfernt)
- ✅ Build-Sicherheitsklemme: verifiziert alle Manifest-Klassen im DEX
Installation
Direkt über eine installierte v1.3.0 drüber-installieren (gleiche Signatur 6c62fd…). Alte QFLASH21-Apps (v1.0–v1.2, andere Paket-ID) danach deinstallieren.
SHA-256 (APK): 9f8e… siehe Release-Asset · Signatur: 6C:62:FD:BC:…:31:CA:7E
v1.3.0 – APK-Installationsfix + WebUSB-Fallback + System-Check
Behoben: „APK funktioniert nicht“
Ursache: v1.0–v1.2 nutzten dieselbe Paket-ID mit zwei verschiedenen Signaturschlüsseln → Android verweigert das Update („App wurde nicht installiert“).
Lösung: v1.3.0 hat die neue Paket-ID de.qflash21.app und installiert dadurch immer konfliktfrei. Alte QFLASH21-Apps danach deinstallieren.
Neu
- WebUSB-Fallback: K+DCAN (FTDI/CH340/CP2102) läuft jetzt auf jedem Android-Chrome per USB-C-OTG – Treiber 1:1 aus dem Linux-Kernel, inkl. 5-Baud-Init über BREAK
- System-Check-Tab: Umgebung-Selbstdiagnose mit kopierbarem Bericht
- DeepOBD-Job-/MWB-Referenz (öffentliche Konfig-Repos)
Installation
- APK herunterladen und öffnen
- MagicOS: ggf. Pure Mode deaktivieren / „Aus dieser Quelle installieren“ erlauben
- Chrome muss installiert sein
- App starten → Tab „System-Check“ muss grün zeigen
Signatur SHA-256: 6C:62:FD:…:CA:7E · minSdk 24 (Android 7.0+) · arm64/armeabi-v7a-neutral (JRE-frei, ~2,6 MB)
v1.2.0 – TWA-APK + Tuning-Wissen
Android-APK v1.2.0 (TWA)
Echte Trusted Web Activity: fullscreen in Chrome, kein URL-Balken, Web-Serial-fähig.
Installation
- Alte QFLASH21-App deinstallieren (neue Signatur!)
QFLASH21-v1.2.0.apkherunterladen und öffnen- „Aus dieser Quelle installieren“ erlauben (MagicOS: ggf. Reiner Modus deaktivieren)
- Play Protect: „Trotzdem installieren“
- Chrome muss installiert sein (Web Serial)
Neu
- Tuning-Wissen-Tab: Stage-1-Ziel 230 PS/480 Nm, Limiter-Kette, Hardware-Guardrails, AFR/SVBL/IQ-Rechner, Workflow-Checkliste, Klima Gelibolu
- DTC 4496 (Rail Pressure Plausibility)
- docs/EDC15C4-KI-AGENT.md (AGENTS.md-Prompt + MCP-Konfiguration)
- Fullscreen via assetlinks.json-Verifizierung
v1.1.0 – DeepOBD-Erweiterung
Neu in v1.1.0
- Steuergeräte-Jobs (DeepOBD-inspiriert): ECU-Reset (0x11), Routinen (0x31: Glühkerzen-Test, Zylinder-Abschalttest, AGR-Test, Adaptions-Reset, Test-Leerlauf), Aktuatorik (0x30: Glührelais, Lüfter, AGR, N75, Kraftstoffpumpe), ZUSB/AIF-Lesen (0x1A)
- Live-Seiten-Konfigurator: Round-Robin über wählbare Messblöcke (DeepOBD-Seiten-Prinzip)
- Neuer Live-Block 0x17: Öl-/Abgastemperatur AT1/AT2, Ölstand (EDC15C4-Zusatzsensoren)
- TSV-Export (DeepOBD/MultiEcoScan-Stil) + CSV
- WakeLock: Bildschirm bleibt bei aktiver Diagnose an
- Mobile Bottom-Nav (Android-optimiert)
- DTC-DB auf 51 EDC15-Codes erweitert
- Bugfix: Positive Response für Output-Control 0x30 → 0x70
Die APK ist ein Launcher (öffnet die PWA in Chrome – Web Serial funktioniert nur dort).
Empfohlen: PWA direkt aus Chrome installieren.
Signatur-SHA-256: a2d639c236db43c40a01254561cd3d9687ad2f689ff3fd29772d072e67b7c438
Full Changelog: v1.0.0...v1.1.0
QFLASH21 v1.0.0 – Android-Launcher
📱 QFLASH21 Android-Launcher (arm64)
QFLASH21-v1.0.0-arm64.apk herunterladen, öffnen, „Unbekannte Quellen“ erlauben – fertig.
- Minimaler nativer Launcher (~85 KB), minSdk 24 (Android 7.0+)
- Öffnet die QFLASH21-PWA in Chrome (Web Serial braucht echten Chrome)
- Signatur-SHA-256:
8c9dfb2139127cd1866b80d95da861ad89c265222d8a67564beff5648bd68f06
Alternativ (empfohlen): PWA direkt in Chrome installieren → Menü ⋮ → „App installieren“
Full Changelog: Initial-Release