Skip to content

Latest commit

 

History

History
65 lines (45 loc) · 2.81 KB

README.md

File metadata and controls

65 lines (45 loc) · 2.81 KB
Raw

Dashboard-Fragment

Fragment

Fragment für ein Desktop/Mobile Dashboard (als PWA)

Wichtig: Dieses Repo ist nur ein Fragment! Das Dashboard ist zwar voll funktionabel (ersetzt 'BLX.JS'), es fehlen aber z.B. noch die vollständige Sprachumsetzung, diverse Spezial-Dialoge (z.B. Tarierung), diese können aber problemlos eingebaut werden. Die PWA ist in reinem Vanilla-JS geschrieben.

Features:

  • Echte PWA - Läuft Online und Offline
  • Daten Synchronisierung mit Server (wenn Internet vorhanden (geht nicht von GitHub aus!))
  • Responsive: läuft auf Android und Desktop (Chrome, Edge, ...)
  • Skalierbare Fonts für maximale Baustellen-Tauglichkeit
  • Internationalisierung (i18-aehnlich)
  • Interner QR-Code-Scanner mit Geräte-Onboading per QR
  • PWA updated sich selbst jeweils auf den neueseten Stand
  • Leicht erweiterbar
  • ...

Live-Demo: https://joembedded.github.io/JoEm-Dashboard/app

Note: Aktivieren der Chrome-Entwickleroption:

  • Aktiviere Entwicklermodus auf Mobile in den Einstellungen 'Über das Telefon' und dann 7 Mal auf die 'Build-Nummer' tippen. Dann USB-Debugging in den Entwickleroptionen aktivieren
  • 'index.html' von einem localhost auf Mobile laden
  • In Chrome: chrome://inspect/#devices -> Scannt alle offen Webseiten, 'insepct' öffnet eine remote Konsole dazu.

Service Worker (PWA)

Service Worker besteht aus 4 Dateien: sw.js / workbox_xx.jsm beide mit .map Der Service Worker caached die APP-Daten, so dass sie Offline verfügbar ist. Fuer die Entwicklung allerdings eher hinderlich... Daher deinstallierbar.

  • Entwicklung: ServiceWorker-Dateien evtl. loeschen.
    Gegebenenfalls laufenden Servicewerker manuell per Konsole löschen: removeServiceWorker() (global in 'index.html', ca. Zeile 40)
    und 'window.jdDebug' auf > 0 setzen, bzw. bei host 'localhost' wird automatisch 'window.jdDebug' gesetzt.
    Anmerkung: Beim der Live-Version auf GitHub ist Server-Sync blockiert, da dort kein PHP.

  • Deploy: ServiceWorker-Dateien erzeugen 'workbox generateSW workbox-config.js' im Root des Projekts (siehe './docu/jo_notes/notes.txt')
    SW-Registrierung automatisch wenn 'window.jdDebug = 0' setzen

Test QR-Codes

Einige QR-Codes (MACs, gesprochene Texte, Link) zum Testen:

QR_DEMO

Ein kleiner Generator für eigene QR-Codes mit Sprach-Infos: https://joembedded.de/ltx/sw/php_qr/

Ein reiner Test des QR-Scanner-Moduls (mit aktiviertem Polyfill): https://joembedded.github.io/JoEm-Dashboard/app/qrstest.html

3.rd Party Software

Changelog (wie 'blxDash.js')

  • V0.18 03.09.2024 - Test 'qrstest.html'