Skip to main content
Imposta l’integrazione GitHub per modificare la tua app Base44 localmente e sincronizzare le modifiche automaticamente.

Sincronizza la tua app con GitHub

Collega la tua app a GitHub per scrivere codice nel tuo ambiente di sviluppo locale o in Base44 e mantenerli sincronizzati tra loro.
GitHub connection prompt showing permanent sync setup.

Connect to GitHub for 2-way sync

Importante:
  • La sincronizzazione GitHub bidirezionale richiede il piano Builder o superiore.
  • Solo i proprietari dell’app possono collegare un’app a un repository o ricollegarla.
  • Se ti sei collegato in precedenza a GitHub usando l’integrazione legacy Export to GitHub unidirezionale, clicca su Looking for the old setup? nel pannello GitHub per disconnetterla e riconnetterti usando la sincronizzazione bidirezionale.
  • Quando colleghi la tua app a GitHub, le tue modifiche vengono sincronizzate automaticamente al repository collegato. Non c’è opzione per inviare manualmente aggiornamenti dalla tua app Base44 a GitHub.
  • Dopo aver collegato GitHub alla tua app, non puoi usare Version History per tornare a versioni precedenti l’integrazione GitHub. Quelle versioni più vecchie non sono memorizzate nel tuo repository GitHub, quindi tentare di tornare a esse produce un errore. Solo le versioni che esistono nel repo GitHub collegato sono disponibili per il ripristino.
Per sincronizzare la tua app con GitHub:
  1. Clicca su Dashboard nell’editor della tua app.
  2. Clicca sull’icona GitHub in alto a destra e clicca su Connect to GitHub.
  3. Clicca su Connect GitHub.
  4. Clicca su Authorize Base44 Builder.
  5. Scegli dove installare il Base44 Builder:
    • Seleziona l’organizzazione o l’account GitHub.
    • Scegli a quali repository consentire l’accesso.
  6. Clicca su Install.
  7. Crea un repository per la tua app:
    • Scegli l’organizzazione o l’account GitHub.
    • Inserisci un nome per il nuovo repository.
    • Clicca su Create Repository.
Dopo la connessione, clicca sull’icona GitHub nel pannello superiore, poi clicca su Go to Repository.
GitHub showing Connected status and a Go to Repository button.

View your connected GitHub repository

Come il tuo team scrive su GitHub

Le connessioni GitHub appartengono al tuo workspace, non all’account di una singola persona. Gli admin del workspace le gestiscono in Workspace settings > GitHub, e la sincronizzazione continua a funzionare se il membro che ha collegato un’organizzazione lascia il workspace. L’admin del tuo workspace sceglie come i membri scrivono su GitHub. L’impostazione si applica a ogni app del workspace sincronizzata con GitHub:
  • Connessione condivisa: tutti scrivono tramite la connessione del workspace, senza collegare un proprio account GitHub. I commit mostrano Base44 come autore. Questa è l’impostazione predefinita.
  • Connessione per utente: ogni membro collega il proprio account GitHub e ottiene l’accesso che GitHub gli dà già. I membri senza accesso in scrittura al repository non possono modificare o pubblicare l’app. I commit appaiono con il nome del membro.
Le app Base Code usano sempre connessioni per utente.
Come funzionano le organizzazioni nel tuo workspace:
  • Quando crei un repository, vedi solo le organizzazioni GitHub consentite dal tuo workspace.
  • Per impostazione predefinita, solo i proprietari e gli admin del workspace possono aggiungere una nuova organizzazione. Gli admin possono consentirlo anche agli Editor.
  • Le connessioni create prima che GitHub passasse al workspace sono state spostate automaticamente, quindi non devi ricollegarti.

Imposta il tuo ambiente di sviluppo locale

Dopo la connessione a GitHub, imposta il tuo repository locale per iniziare a modificare il codice nel tuo ambiente di sviluppo preferito. Per impostare il tuo repository locale:
  1. Clona il repository usando l’URL Git del progetto.
  2. Naviga nella directory del progetto.
  3. Installa le dipendenze: npm install.
  4. Installa la CLI di Base44: npm install -g base44@latest.
  5. Autenticati: base44 login.
  6. Collega il clone alla sua app: base44 link. Il puntatore di collegamento base44/.app.jsonc è gitignored, quindi ogni nuovo clone richiede questo passaggio.
Esegui l’app localmente:
Questo avvia insieme un backend Base44 locale e il dev server del tuo frontend. Le richieste /api del frontend vengono inoltrate al backend locale. Consulta Sviluppo locale per sapere cosa viene eseguito localmente. Per lavorare solo sul frontend contro il backend live ospitato della tua app, esegui invece base44 dev --remote.
In modalità remota, le scritture vanno sui dati di produzione della tua app live.
Per dettagli sulla struttura dei file esportati, consulta Struttura del progetto.

Sincronizza le modifiche locali su Base44

Per sincronizzare le tue modifiche locali su Base44, fai il merge delle modifiche nel branch git principale. Questo branch deve chiamarsi main. Altri nomi di branch predefiniti, come master, al momento non sono supportati. Le modifiche saranno poi visibili nella tua app Base44.
Dopo la sincronizzazione, clicca su Publish in alto a destra della tua app Base44 per rendere le modifiche live per gli utenti.

Disconnettersi da GitHub

Puoi disconnettere un’app specifica dal suo repository GitHub, o disconnettere un’organizzazione GitHub da tutto il workspace. Anche spostare un’app in un altro workspace disconnette la sua sincronizzazione GitHub, e Base44 ti avvisa prima di farlo.
Se non vedi Disconnect nel pannello GitHub, non è ancora abilitato per il tuo account. La sincronizzazione non può essere messa in pausa, quindi gli unici stati sono connesso e disconnesso.

Disconnetti il tuo repository

Disconnetti la tua app dal suo repository GitHub se non vuoi più sincronizzare le modifiche. Solo il proprietario dell’app o il membro che ha collegato il repository può disconnetterlo. Per disconnettere il tuo repository:
  1. Apri la scheda code.
  2. Clicca su GitHub.
  3. Clicca sull’icona More actions .
  4. Clicca su Disconnect.
Il processo di disconnessione richiede circa 30 secondi ed è disponibile solo quando l’agente IA non sta attivamente facendo modifiche alla tua app.

Riconnetti il tuo repository

Riconnetti la tua app al repository da cui è stata disconnessa per riprendere la sincronizzazione. Solo il proprietario dell’app può riconnetterla. Per riconnettere il tuo repository:
  1. Clicca sull’icona GitHub in alto a destra e clicca su Connect to GitHub.
  2. Nella finestra Reconnect Repository, clicca su Reconnect.
Quando non puoi riconnetterti:
  • Sia la tua app sia il repository hanno nuovi commit dall’ultima volta che coincidevano.
  • Il repository è stato rinominato o eliminato, oppure è cambiato il suo branch predefinito.
  • Il repository è stato collegato da un altro workspace.
  • La connessione del workspace all’organizzazione del repository è stata disconnessa. Chiedi a un admin del workspace di ricollegarla in Workspace settings > GitHub.
In questi casi, clicca su Create a new repository instead.

Disconnetti un’organizzazione dal tuo workspace

Disconnetti un’organizzazione GitHub se non vuoi più che le app del tuo workspace si sincronizzino con essa. Ogni app che si sincronizza tramite l’organizzazione smette di sincronizzarsi, e la GitHub App di Base44 resta installata su GitHub. I proprietari, gli admin e gli Editor del workspace possono disconnettere un’organizzazione. Per disconnettere un’organizzazione:
  1. Vai su Workspace settings.
  2. Clicca su GitHub.
  3. Sotto Connected organizations, clicca sull’icona More actions accanto all’organizzazione.
  4. Clicca su Disconnect organization.
  5. Clicca su Disconnect per confermare.
Questa pagina è stata tradotta utilizzando l’IA. Per informazioni più accurate e aggiornate, consulta la versione inglese.