Vai al contenuto principale
Lo sviluppo locale esegue due processi affiancati: il dev server di Base44 per il tuo backend e il consueto dev server frontend per l’interfaccia utente. Il tuo frontend comunica con il backend locale tramite l’SDK.

​
Prerequisiti

Se il tuo progetto ha funzioni backend, devi installare Deno per eseguirle in locale.

​
Configura il client frontend

Se il tuo progetto ha un frontend che usa l’SDK, devi indicargli dove inviare le richieste e dove reindirizzare per l’autenticazione. Per impostazione predefinita, l’SDK usa il backend ospitato da Base44. Per usare il dev server locale in sviluppo, imposta sia serverUrl sia appBaseUrl su "http://localhost:4400" quando chiami createClient(). In produzione, omettili in modo che l’SDK usi i valori predefiniti. Scegli uno dei due pattern qui sotto. Il pattern con variabili d’ambiente è il più semplice se base44 dev avvia il tuo frontend tramite site.serveCommand e usi una build basata su Vite. Il pattern con rilevamento manuale funziona in qualsiasi configurazione.

​
Pattern con variabili d’ambiente

Quando base44 dev avvia il tuo frontend tramite site.serveCommand, imposta due variabili d’ambiente Vite nel processo frontend: VITE_BASE44_APP_ID (l’id della tua app) e VITE_BASE44_APP_BASE_URL (l’URL del dev locale). Leggile durante la creazione del client, usando l’URL sia per serverUrl sia per appBaseUrl: 
import { createClient } from "@base44/sdk";

const base44 = createClient({
  appId: import.meta.env.VITE_BASE44_APP_ID ?? "your-app-id",
  serverUrl: import.meta.env.VITE_BASE44_APP_BASE_URL,
  appBaseUrl: import.meta.env.VITE_BASE44_APP_BASE_URL,
});
L’opzione serverUrl è dove l’SDK invia le richieste API. L’opzione appBaseUrl è dove reindirizza per i flussi di autenticazione come il login. Nello sviluppo locale, entrambi puntano al tuo dev server locale. Nelle build di produzione, le variabili d’ambiente sono indefinite ed entrambe le opzioni ricadono sui valori predefiniti dell’SDK.
Le app create tramite l’integrazione GitHub di Base44 usano @base44/vite-plugin, che imposta serverUrl e appBaseUrl automaticamente. Questa configurazione manuale è necessaria solo per progetti che non eseguono il plugin.

​
Pattern con rilevamento manuale

Usa questo pattern se avvii il tuo frontend in un terminale separato o se il tuo build tool non è Vite. Rileva se il codice è in esecuzione in sviluppo, quindi imposta serverUrl in modo condizionale.
1

Rileva la modalità di sviluppo

Usa il pattern che corrisponde al tuo ambiente:
const isDev = import.meta.env.DEV;
2

Passa serverUrl in modo condizionale

Quando crei il client, includi serverUrl solo in sviluppo:
import { createClient } from "@base44/sdk";

const base44 = createClient({
  appId: "your-app-id",
  ...(isDev && {
    serverUrl: "http://localhost:4400",
    appBaseUrl: "http://localhost:4400",
  }),
});
  • In sviluppo, isDev è true e sia serverUrl sia appBaseUrl puntano a localhost:4400
  • Nelle build di produzione, isDev è false, entrambe le opzioni vengono omesse e l’SDK usa i valori predefiniti

​
Eseguire i dev server

Il modo in cui avvii l’ambiente di sviluppo dipende dal fatto che il tuo progetto definisca o meno site.serveCommand in base44/config.jsonc.

​
Con site.serveCommand (consigliato)

Esegui dev dalla directory del tuo progetto: 
base44 dev
Questo avvia il backend locale su http://localhost:4400, quindi genera il tuo dev server frontend usando site.serveCommand. La CLI inserisce VITE_BASE44_APP_ID e VITE_BASE44_APP_BASE_URL nell’ambiente del frontend, che il pattern di configurazione client con variabili d’ambiente qui sopra legge per puntare l’SDK al backend locale. L’output di entrambi i processi viene trasmesso allo stesso terminale, con i prefissi [backend] e [frontend], e un singolo Ctrl-C li arresta entrambi.

​
Senza site.serveCommand

Se site.serveCommand non è impostato, esegui i due processi in terminali separati.
1

Avvia il backend

In un terminale, esegui dev dalla directory del tuo progetto:
base44 dev
Questo avvia il backend locale su http://localhost:4400.
2

Avvia il frontend

In un secondo terminale, avvia il tuo dev server frontend come faresti normalmente. Ad esempio, con Vite:
npm run dev
Tutte le chiamate SDK dal tuo frontend ora vanno al dev server Base44 locale.

​
Vedi anche

Questa pagina è stata tradotta utilizzando l’IA. Per informazioni più accurate e aggiornate, consulta la versione inglese.