Panoramica dell'App Mobile
xCRUD_Nova_Android_App è un guscio WebView Capacitor attorno a un frontend HTML/JS statico che comunica con qualsiasi backend xCRUD Nova/Pro tramite semplice HTTP.
Cos'è
xCRUD_Nova_Android_App/ è un progetto Capacitor - un sottile guscio nativo Android la cui intera interfaccia è una WebView. Il suo capacitor.config.json è deliberatamente minimale:
{
"appId": "net.xcrud.nova",
"appName": "xCRUD Nova",
"webDir": "www"
}
webDir: "www" punta a www/ - una copia rimarchiata del remote_frontend_demo/ proprio del progetto - un frontend HTML/JS 100% statico, privo di qualsiasi codice di rete nativo Android. Ogni schermata (login, poi la dashboard dal vivo) viene recuperata da un backend esclusivamente tramite chiamate fetch(), instradate attraverso core/remote_shell_bridge.php sul lato backend.
L'idea chiave: un'app, qualsiasi backend
La stessa app installata funziona contro QUALSIASI backend xCRUD Nova/Pro distribuito - il server dell'acquirente stesso, non uno fisso incorporato al momento della compilazione. Quale backend contatta è controllato interamente da un unico file, www/settings.ini, modificabile successivamente:
- Puntala verso un backend diverso cambiando un solo URL.
- Ricarica la WebView (o risincronizza l'app) per vedere il cambiamento - nessuna ricompilazione, nessuna modifica al codice dell'app stessa.
- Il frontend statico che carica è lo stesso codice del
remote_frontend_demo/desktop - semplicemente rimarchiato per il guscio dell'app.
Questo rende banale un test rapido: modifica settings.ini, ricarica, fatto. Vedi Configurare e Ricompilare l'App Android per la guida completa, incluso quando serve davvero una vera ricompilazione dell'APK.
Come si incastra tutto insieme
| Componente | Ruolo |
|---|---|
capacitor.config.json | Metadati del progetto Capacitor - ID app, nome app, e quale cartella (www/) è la radice dei contenuti della WebView. |
www/ | Il frontend HTML/JS statico caricato nella WebView - una copia rimarchiata di remote_frontend_demo/. |
www/settings.ini | La configurazione modificabile dall'acquirente - quale URL di backend chiamare, testo di branding, e link CTA opzionali. Non serve alcuna ricompilazione per modificarla. |
core/remote_shell_bridge.php (backend) | L'endpoint lato server con cui comunicano le chiamate fetch() del frontend - parte del backend xCRUD Nova/Pro, non dell'app stessa. |