/

Überblick über die Mobile App

xCRUD_Nova_Android_App ist eine Capacitor-WebView-Hülle um ein statisches HTML/JS-Frontend, das über gewöhnliches HTTP mit jedem xCRUD Nova/Pro-Backend spricht.

Was es ist

xCRUD_Nova_Android_App/ ist ein Capacitor-Projekt - eine schlanke native Android-Hülle, deren gesamte Oberfläche eine WebView ist. Ihre capacitor.config.json ist bewusst schlicht gehalten:

{
  "appId": "net.xcrud.nova",
  "appName": "xCRUD Nova",
  "webDir": "www"
}

webDir: "www" verweist auf www/ - eine umbenannte Kopie der projekteigenen remote_frontend_demo/ - ein zu 100 % statisches HTML/JS-Frontend ganz ohne nativen Android-Netzwerkcode. Jeder Bildschirm (Login, dann das Live-Dashboard) wird ausschließlich über fetch()-Aufrufe von einem Backend geladen, geleitet über core/remote_shell_bridge.php auf der Backend-Seite.

Die Kernidee: eine App, jedes Backend

Dieselbe installierte App funktioniert gegen JEDES bereitgestellte xCRUD Nova/Pro-Backend - den eigenen Server des Käufers, nicht einen zur Build-Zeit fest einprogrammierten. Welches Backend sie anspricht, wird ausschließlich über eine Datei gesteuert, www/settings.ini, die nachträglich bearbeitet wird:

  • Auf ein anderes Backend zeigen, indem einfach eine URL geändert wird.
  • Die WebView neu laden (oder die App neu synchronisieren), um die Änderung zu sehen - kein Rebuild, keine Codeänderung an der App selbst.
  • Das geladene statische Frontend ist derselbe Code wie das Desktop-remote_frontend_demo/ - nur für die App-Hülle umbenannt.

Das macht einen schnellen Test denkbar einfach: settings.ini bearbeiten, neu laden, fertig. Siehe Die Android-App konfigurieren & neu bauen für die vollständige Anleitung, einschließlich wann ein echter APK-Rebuild tatsächlich nötig ist.

Wie alles zusammenspielt

BestandteilRolle
capacitor.config.jsonMetadaten des Capacitor-Projekts - App-ID, App-Name und welcher Ordner (www/) die Inhaltswurzel der WebView ist.
www/Das statische HTML/JS-Frontend, das in die WebView geladen wird - eine umbenannte Kopie von remote_frontend_demo/.
www/settings.iniDie vom Käufer editierbare Konfiguration - welche Backend-URL angesprochen wird, Branding-Text und optionale CTA-Links. Zum Ändern ist kein Rebuild nötig.
core/remote_shell_bridge.php (Backend)Der serverseitige Endpunkt, mit dem die fetch()-Aufrufe des Frontends sprechen - Teil des xCRUD Nova/Pro-Backends, nicht der App selbst.