/

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

ComponenteRuolo
capacitor.config.jsonMetadati 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.iniLa 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.