Vai al contenuto principale
I branch ti permettono di provare nuove idee, funzionalità o restyling senza toccare la tua app. Ogni branch ha la propria chat e la propria anteprima live. Puoi lavorare su più branch contemporaneamente, poi unire ciascuno nella tua app quando sei soddisfatto.
I branch funzionano insieme a una connessione GitHub. Base44 mantiene ogni branch come branch reale nel tuo repository, e puoi anche costruire su un branch già esistente.
Il menu dei branch con l'elenco di diversi branch accanto all'anteprima di un'app

Lavora su più branch accanto alla tua app principale

Modi per usare un branch

  • Testare un restyling. Prova un nuovo look per la tua app e confrontalo con la versione attuale. Se cambi idea, abbandona il branch.
  • Tenere pronta la tua app live. Quando serve una piccola correzione a metà progetto, correggila e pubblicala subito da main. Il tuo lavoro più grande resta al sicuro sul suo branch.
  • Costruire una funzionalità che esce più avanti. Lavora in anticipo su una release e tieni la funzionalità su un branch fino al giorno del lancio.
  • Lavorare in parallelo. Costruisci su più branch contemporaneamente e lavora con il tuo team su idee diverse allo stesso tempo, ognuna sul proprio branch.

Come funzionano i branch

La versione principale della tua app si chiama main. Quando crei un branch, Base44 avvia una linea di lavoro separata dallo stato attuale di main. I branch procedono in parallelo, così puoi provare modifiche senza toccare main. Alcune parti della tua app appartengono a ciascun branch, altre sono condivise con main:
Un branch usa i tuoi dati reali e live.
  • I record che aggiungi, modifichi o elimini mentre visualizzi l’anteprima di un branch influiscono sugli stessi dati che la tua app usa ovunque.
  • Per sperimentare senza toccare i dati live, passa l’anteprima ai dati di test mentre lavori. I dati di test sono disponibili dal piano Builder in su. Scopri di più su come testare la tua app con dati di test.

Creare un branch

Descrivi cosa vuoi costruire e Base44 crea il branch e inizia subito a costruire. Base44 dà un nome al branch a partire dal tuo primo messaggio. I nomi hanno 3 parole o meno e sono sempre in inglese, in qualsiasi lingua tu scriva. Non puoi rinominare un branch. Puoi usare i branch anche sul telefono, in un browser mobile o nell’app Base44. Il menu dei branch appare solo quando la tua app ha un branch, quindi crea il primo branch da un computer, oppure chiedi alla chat AI di avviarne uno. Dopo puoi cambiare branch, costruire e fare il merge dal telefono.
Prima di creare un branch: se la tua app è stata costruita tempo fa, potresti dover fare una modifica su main prima di poter creare il tuo primo branch. Se questo vale per la tua app, Base44 te lo dice quando provi.

Avviare un nuovo branch

Avvia un branch dal menu dei branch quando hai una nuova idea da costruire. Per creare un branch:
  1. Apri la tua app nell’editor dell’app.
  2. Clicca Main, o il nome del branch in cui ti trovi, in cima alla chat AI.
  3. Clicca Create new branch.
  4. Scrivi cosa vuoi costruire nella casella della chat.
  5. Invia il messaggio.
Il menu dei branch aperto sotto il nome dell'app, con Main chat e un pannello Create your first branch con il pulsante Create new branch evidenziato

Creare il tuo primo branch dal menu dei branch

Un branch che crei dal menu dei branch parte sempre da main. Se crei un branch mentre sei su un altro branch, il nuovo branch parte comunque da main.

Creare un branch privato

Rendi privato un branch quando vuoi lavorare a un’idea prima che qualcun altro la veda. Chiunque possa modificare l’app può crearne uno. Un branch privato e la sua chat sono visibili solo a te. Così il proprietario dell’app e gli altri collaboratori non vedono il tuo lavoro in corso. Nel menu dei branch, accanto al suo nome appare un lucchetto. Quando lo unisci, le tue modifiche appaiono su main per tutti come di consueto. Scegli se un branch è privato quando lo crei, e non puoi cambiarlo in seguito. Se vieni rimosso come collaboratore dell’app, i tuoi branch privati vengono eliminati.
Dove sono disponibili i branch privati:
  • Collaboratori: l’opzione Private branch appare solo nelle app con collaboratori. Se costruisci da solo, invita un collaboratore e l’opzione appare, anche prima che accetti.
  • App importate: i branch privati non sono disponibili per le app importate da GitHub.
  • App mobile: i branch privati non sono disponibili nell’app mobile di Base44.
Per creare un branch privato:
  1. Apri la tua app nell’editor dell’app.
  2. Clicca Main, o il nome del branch in cui ti trovi, in cima alla chat AI.
  3. Clicca Create new branch.
  4. Seleziona Private branch in cima alla casella della chat.
  5. Scrivi cosa vuoi costruire nella casella della chat.
  6. Invia il messaggio.
Uno screenshot della schermata Create new branch nella chat AI, con Private branch selezionato ed evidenziato nella casella della chat

Selezionare Private branch prima di inviare il primo messaggio

Creare un branch da un messaggio

Crea un branch da qualsiasi messaggio che hai inviato nella chat principale per provare una direzione diversa da quel punto. Il nuovo branch parte dalla tua app com’era a quel messaggio, e tu resti su main mentre viene creato. Questa opzione è disponibile su main in un browser desktop, ma non mentre la tua app sta costruendo. Per creare un branch da un messaggio:
  1. Apri la tua app nell’editor dell’app.
  2. Passa il mouse su un messaggio che hai inviato nella chat principale.
  3. Clicca l’icona Branch from here sotto di esso.
    Un messaggio inviato nella chat principale con l'icona Branch from here evidenziata

    L'icona Branch from here sotto un messaggio che hai inviato

  4. Quando il branch è pronto, aprilo dal menu dei branch in cima al pannello della chat.

Chiedere all’AI di creare un branch

Puoi chiedere alla chat AI di avviare un branch per te, così una modifica importante viene costruita lontano dalla tua app live. Per esempio, “Costruisci il nuovo flusso di prenotazione su un branch separato.” Funziona su qualsiasi app, su main o su un branch. L’AI avvia il branch da main con la tua richiesta come primo messaggio e continua a costruire lì da sola. Tu resti dove sei, e nella chat appare un link al nuovo branch. Se chiedi una modifica importante alla tua app pubblicata, come sostituire un flusso principale o ridisegnare diverse pagine insieme, la chat AI potrebbe suggerirti di costruirla prima su un nuovo branch. Così la tua app live resta com’è mentre provi la modifica. Se sei già su un branch e chiedi qualcosa che non c’entra con il lavoro di quel branch, la chat AI potrebbe suggerirti un branch separato.
Quando l’AI suggerisce un branch:
  • Modalità Build su un computer: il suggerimento appare solo in modalità Build, in un browser sul tuo computer. Non lo vedi in modalità Plan o Discuss, né nell’app mobile di Base44.
  • Solo modifiche di design e funzionalità: l’AI non suggerisce un branch per modifiche ai dati, ai campi delle entità, alle regole di accesso o a impostazioni come autenticazione e pagamenti, perché i branch li condividono con main.
  • App importate: nelle app importate da GitHub, l’AI suggerisce un branch solo quando sei già su uno.
Per rispondere a un suggerimento di branch:
  1. Controlla il suggerimento Create new branch nella chat AI. Mostra cosa costruirebbe l’AI sul nuovo branch.
  2. Clicca una delle opzioni:
    • Start: Base44 crea il branch da main e inizia a costruire lì, mentre tu resti dove sei. Nella chat appare un link al branch.
    • Do it later: l’AI chiude il suggerimento e non avvia un branch. Per fare la modifica su main o sul branch in cui ti trovi, chiedi alla chat AI di procedere.
L'editor dell'app su Main con un suggerimento Create new branch nella chat AI e il pulsante Start evidenziato

L'AI che suggerisce un nuovo branch prima di una modifica importante

Importare da GitHub

Quando la tua app è connessa a GitHub, puoi costruire su un branch che esiste già nel tuo repository. Base44 lavora su quel branch stesso, quindi le tue modifiche e quelle di Base44 vanno sullo stesso branch nel tuo repository. Per importare un branch da GitHub:
  1. Apri la tua app nell’editor dell’app.
  2. Clicca Main, o il nome del branch in cui ti trovi, in cima alla chat AI.
  3. Clicca Import from GitHub.
  4. Cerca il branch che vuoi, poi selezionalo.
  5. Clicca Import.
Importi dal repository a cui è connessa la tua app. Un branch che crei in Base44 ottiene un nuovo branch in quello stesso repository.

Lavorare su un branch

Mentre sei su un branch, il nome del branch sostituisce il nome della tua app in cima al pannello della chat, e un’icona rotante mostra quando l’AI sta lavorando. Costruisci su un branch nello stesso modo in cui costruisci su main: descrivi cosa vuoi nella chat. Anche selezionare un elemento e fare una modifica visiva salva sul branch su cui ti trovi, come le modifiche in chat. Alcune cose funzionano diversamente su un branch:
  • Merge to main sostituisce il pulsante Publish. Pubblichi le modifiche da main dopo il merge.
  • L’anteprima mostra la versione della tua app del branch.
  • L’URL della pagina include il branch, così puoi condividere un link che apre l’editor dell’app su quel branch.
L'editor dell'app su un branch, con il nome del branch in alto e Merge to main evidenziato

Lavorare su un branch, con Merge to main al posto di Publish

I branch procedono in parallelo. Invia una richiesta su un branch, passa a un altro e continua a costruire lì mentre il primo finisce. La tua app esegue diverse build contemporaneamente, così tu e il tuo team potete portare avanti più idee allo stesso tempo, ognuna sul proprio branch.Il menu dei branch mostra quali branch stanno costruendo, così puoi controllarli man mano.

Passare tra i branch

Puoi muoverti tra main e i tuoi branch in qualsiasi momento, e ogni branch mantiene le sue modifiche finché non lo unisci. Su un branch, puoi anche cliccare la X accanto a Merge to main per uscire e tornare a main. L’icona accanto a ogni branch mostra il suo stato attuale. Passa il mouse sull’icona per vedere l’etichetta: Per passare a un altro branch o tornare a main:
  1. Apri la tua app nell’editor dell’app.
  2. Clicca Main, o il nome del branch in cui ti trovi, in cima alla chat AI.
  3. Seleziona un branch dall’elenco, o seleziona Main chat per tornare a main.
Il menu dei branch aperto su un branch, con Main chat sopra l'elenco dei branch

Passare tra main e i tuoi branch

Puoi cambiare branch mentre l’AI sta costruendo, e continua a lavorare sul branch che hai lasciato. Prima salva o scarta eventuali modifiche su main.

Unirti al branch di un collaboratore

Quando lavori su un’app con altre persone, gli avatar in cima all’editor dell’app mostrano su quale branch si trova ciascuno. Puoi passare direttamente al branch di un collaboratore, e quando qualcuno si unisce al branch su cui sei, Base44 mostra un breve messaggio che lo segnala. Per unirti al branch di un collaboratore:
  1. Apri la tua app nell’editor dell’app.
  2. Passa il mouse sull’avatar di un collaboratore in cima all’editor dell’app per vedere il suo nome e il suo branch.
    L'avatar di un collaboratore in cima all'editor dell'app con un tooltip che mostra nome e branch

    L'avatar di un collaboratore che mostra su quale branch si trova

  3. Clicca l’avatar per aprire il branch su cui si trova.

Fare modifiche a tutta l’app

Fai la maggior parte del lavoro su un branch, ma alcune azioni riguardano tutta la tua app, non solo un branch. Quelle avvengono sempre su main, anche mentre stai lavorando su un branch:
  • Pubblicare la tua app
  • Creare o modificare secret, connettori e workflow
  • Cambiare le impostazioni del tema della tua app
  • Annullare un messaggio nella chat, o modificarlo e reinviarlo
  • Aggiungere una pagina da Figma
  • Chiedere all’AI di aggiungere, modificare, eliminare o importare record
Se chiedi una di queste azioni su un branch, Base44 ti chiede di farla su main o di unire prima il branch.

Usare i dati di test

I dati di test ti permettono di provare cose su un branch senza toccare i record live. La tua app ha 1 set di dati di test condiviso da main e da tutti i branch. Un nuovo branch quindi non riceve una copia propria e non parte vuoto. Mostra gli stessi record di test di main. I record di test che aggiungi da qualsiasi branch appaiono ovunque. La chat AI non aggiunge né modifica record da un branch. Per far aggiungere dati di test all’AI, chiediglielo su main. Per aggiungere dati di test mentre lavori su un branch:
  1. Apri la tua app nell’editor dell’app.
  2. Clicca Main, o il nome del branch in cui ti trovi, in cima alla chat AI.
  3. Seleziona il tuo branch.
  4. Clicca Preview.
  5. Clicca l’icona Turn on test data in cima all’anteprima.
  6. Aggiungi record mentre usi la tua app.

Modificare le entità

Alcune modifiche alle entità funzionano su un branch, altre avvengono su main. Su un branch, puoi:
  • Creare entità: imposti tutto, incluse le autorizzazioni sui dati dell’entità.
  • Aggiungere campi alle entità esistenti: rendi opzionali i nuovi campi, perché i tuoi record esistenti non li hanno ancora.
Entrambe le modifiche appaiono subito nell’anteprima del branch. Su main, puoi:
  • Rimuovere un’entità o un campo.
  • Cambiare il tipo di un campo esistente, o se è obbligatorio.
  • Cambiare le autorizzazioni sui dati.
Fai queste modifiche su main e il tuo branch le recepisce subito, senza merge o aggiornamento. I record sono i dati live della tua app, condivisi con main, quindi chiedi all’AI le modifiche ai record su main. I record che aggiungi, modifichi o elimini tu stesso nell’anteprima del branch modificano gli stessi dati che la tua app usa ovunque.

Modificare le funzioni backend

Puoi aggiungere e modificare funzioni backend su un branch. Il branch ottiene la propria copia di ogni funzione che modifichi, incluso il codice condiviso che usa. Quando fai il merge del branch, le tue modifiche vengono distribuite su main. Quale versione di una funzione viene eseguita nell’anteprima del branch dipende da chi la usa:
  • Tu o un editor, con l’accesso all’app: la versione del branch.
  • Chiunque altro, come un visitatore non connesso o un utente dell’app: la versione dell’ultima pubblicazione. Un flusso che dipende da uno di loro non può usare le modifiche del branch finché non fai il merge e pubblichi.
Per testare una funzione da sola, usa Test Function e Logs nella scheda Code. Su un branch, eseguono la versione del branch. Le funzioni che non hai modificato eseguono la versione di main.
Quando le funzioni restano su main:
  • La prima funzione backend della tua app viene creata su main. Dopo puoi lavorare sulle funzioni da un branch.
  • In un’app importata da GitHub, le modifiche backend avvengono sempre su main.

Modificare gli agenti in-app

Puoi creare, modificare ed eliminare agenti in-app su un branch, dalla chat AI o dalla pagina Agents nella dashboard della tua app. Su un branch, la pagina Agents mostra gli agenti del branch, e le modifiche restano sul branch finché non fai il merge. Fino ad allora, la tua app, inclusa l’anteprima del branch, continua a eseguire gli agenti di main. Se il branch main della tua app è protetto, l’editor degli agenti su main è in sola lettura. Per fare modifiche, crea un branch. Quando clicchi Add Agent su main e invii la richiesta, Base44 la sposta per te su un nuovo branch.

Modificare il codice

La scheda Code mostra i file della tua app come sono sul branch in cui ti trovi. Puoi modificarli lì, e ciò che salvi resta sul branch finché non fai il merge. La maggior parte dei file si salva direttamente sul branch, inclusi i file dietro pagine, layout, stile e funzioni backend, così main resta intatto. Alcuni file cambiano tutta la tua app, non solo un branch. Se provi a salvarne uno, Base44 blocca il salvataggio e ti dice cosa fare invece:
  • File delle entità: chiedi la modifica nella chat del branch, o passa a main. Vedi entità su un branch per sapere cosa un branch può cambiare da solo.
  • Tutto ciò che cambierebbe la tua app live: fai la modifica su main, e il tuo branch la recepisce senza bisogno di merge.
La scheda Code aperta su un branch, con l'albero dei file del branch e Merge to main in alto a destra

La scheda Code su un branch, che mostra i file di quel branch

Come funziona la ridistribuzione di una funzione backend:
  • Avviene su main: quando modifichi una funzione backend su main, la salvi con Save & Redeploy. Su un branch il pulsante è Save, quindi passa a main per ridistribuire una funzione.
  • La tua app live mantiene la versione pubblicata: la ridistribuzione aggiorna la funzione nell’anteprima e quando la testi nell’editor. La tua app live continua a eseguire la versione dell’ultima pubblicazione finché non pubblichi di nuovo.
  • Pubblicare manda online tutto ciò che è su main: non puoi pubblicare una sola funzione. Quando pubblichi, tutte le modifiche su main vanno online insieme, inclusa la funzione ridistribuita.
  • I workflow usano subito la nuova versione: quando un workflow chiama la funzione, esegue l’ultima versione senza bisogno di pubblicare.

Usare la cronologia delle versioni

Ogni branch ha la propria cronologia delle versioni. Usala per rivedere come si è sviluppato il branch, confrontarlo con main e tornare a qualsiasi punto precedente.

Ripristinare una versione

Ripristinare una versione cambia solo quel branch. Main resta esattamente com’è.
  • Cosa torna indietro: le pagine, il design, le entità e le funzioni backend del branch tornano a quella versione, e la sua chat torna al messaggio che l’ha creata.
  • Cosa resta: i tuoi record, perché sono condivisi con main. Anche le versioni successive restano nell’elenco, così puoi andare di nuovo avanti.
Puoi ripristinare una versione mentre il branch è ancora attivo. La cronologia delle versioni di un branch unito resta leggibile. Per ripristinare una versione precedente di un branch:
  1. Apri la tua app nell’editor dell’app.
  2. Clicca Main, o il nome del branch in cui ti trovi, in cima alla chat AI, poi seleziona il branch.
  3. Clicca l’icona Version History in cima al pannello della chat.
  4. Clicca una versione nell’elenco per caricarla nell’anteprima.
  5. Clicca l’icona More options accanto a quella versione.
  6. Clicca Revert to this version.
Il menu More options di una versione del branch in Version History con Revert to this version evidenziato

Ripristinare una versione precedente di un branch

Ripristinare e pubblicare da un branch:
  • Publish this version è disponibile solo su main, perché la pubblicazione rilascia sempre la tua app principale. Per rilasciare il lavoro di un branch, uniscilo in main e pubblica da lì.
  • Ripristina una versione quando il branch ha finito di costruire e ogni aggiornamento da main è completo. Se il branch è occupato, Base44 te lo dice, e puoi ripristinare appena finisce.

Confrontare con main

Prima del merge, puoi controllare esattamente in cosa il codice di una versione differisce da main. Base44 apre una finestra Changes compared with main che elenca ogni file diverso e cosa è cambiato in ciascuno. Per confrontare una versione del branch con main:
  1. Apri la tua app nell’editor dell’app.
  2. Clicca Main, o il nome del branch in cui ti trovi, in cima alla chat AI, poi seleziona il branch.
  3. Clicca l’icona Version History in cima al pannello della chat.
  4. Clicca l’icona More options accanto alla versione che vuoi confrontare.
  5. Clicca Compare code vs main.
    Il menu More options di una versione del branch in Version History con Compare code vs main evidenziato

    Confrontare una versione del branch con main

  6. Clicca un file nell’elenco per vedere cosa è cambiato.
    La finestra Changes compared with main con l'elenco dei file modificati e una vista affiancata di un file

    La finestra Changes compared with main


Aggiornare da main

Se main cambia mentre il tuo branch è aperto, una card appare sopra la casella della chat sul branch. Ti dice quanto è cambiato su main e se qualcosa si sovrappone al tuo branch. Quando aggiorni, l’AI combina le modifiche di main con il tuo branch. Se alcune modifiche si sovrappongono, l’AI le risolve per te. Se le 2 versioni sono davvero in conflitto, l’AI ti fa una domanda nella chat così puoi decidere cosa tenere. Puoi anche avviare un aggiornamento dal menu dei branch. Clicca l’icona More actions accanto a un branch, poi clicca Update from main. Per portare le ultime modifiche di main nel tuo branch:
  1. Apri la tua app nell’editor dell’app.
  2. Clicca Main, o il nome del branch in cui ti trovi, in cima alla chat AI, poi seleziona il branch.
  3. Clicca Update branch sulla card di aggiornamento sopra la casella della chat.
Una card di aggiornamento sopra la casella della chat con 1 new message on main, Nothing overlaps, Ready to update e un pulsante Update branch

La card di aggiornamento che appare sopra la casella della chat quando main è cambiato

Se un aggiornamento incontra un problema, Base44 lo annulla e il lavoro del tuo branch resta invariato.

Unire in main

Il merge porta in main tutto ciò che hai costruito sul branch. Le tue modifiche raggiungono gli utenti della tua app solo quando pubblichi da main, quindi decidi tu cosa esce e quando. Su un’app importata da GitHub, invece, fai il merge tramite una pull request. Consulta lavorare con le pull request. Dopo il merge:
  • La chat di main mostra un riepilogo delle modifiche del branch.
  • Il branch resta nell’elenco dei branch come unito. Puoi ancora leggere la sua chat, ma il suo codice è in sola lettura e la sua anteprima mostra main com’è ora.
  • Per fare domande sul lavoro del branch, aprilo e chiudi l’avviso. La chat AI si riapre in modalità Discuss, così l’AI può rispondere a domande sul codice del branch senza modificarlo. Per tornare indietro, clicca Open main chat.
Puoi anche chiedere alla chat AI di unire un branch: aggiunge alla chat una card che lo fa per te con un solo clic. Oppure fai il merge dal menu dei branch: clicca l’icona More actions accanto a un branch, poi clicca Merge to main. Per unire un branch:
  1. Apri la tua app nell’editor dell’app.
  2. Clicca Main, o il nome del branch in cui ti trovi, in cima alla chat AI, poi seleziona il branch.
  3. Clicca Merge to main sotto l’ultima risposta dell’AI o in cima all’editor.
  4. Rivedi la conferma, poi clicca Merge to main.
L'editor dell'app su un branch con il pulsante Merge to main evidenziato nella barra superiore

Clicca Merge to main in cima all'editor, poi pubblica da main quando sei pronto

Se il branch è in conflitto con le modifiche fatte su main, Base44 ti chiede prima di aggiornarlo. Aggiorna il branch da main, poi unisci di nuovo.

Eliminare un branch

Elimina un branch quando hai finito con un’idea e vuoi toglierlo dall’elenco. La tua app e gli altri branch restano come sono.
L’eliminazione di un branch è permanente. Rimuove il branch e la sua chat, e non può essere annullata. Per conservare il lavoro, unisci prima il branch in main.
Per eliminare un branch:
  1. Apri la tua app nell’editor dell’app.
  2. Clicca Main, o il nome del branch in cui ti trovi, in cima alla chat AI.
  3. Clicca l’icona More actions accanto al branch che vuoi eliminare.
  4. Clicca Delete.
  5. Rivedi la conferma, poi clicca Delete branch.
Il menu dei branch con il menu More actions aperto su un branch, che mostra Merge to main, Update from main e Delete

Aprire il menu More actions su un branch

Puoi eliminare un branch quando l’AI ha finito di costruirci e ogni aggiornamento da main è completo. I branch uniti restano nell’elenco come traccia del lavoro.

FAQ

Trova le risposte alle domande più comuni sui branch.
Non c’è un limite fisso. Puoi tenere aperti tutti i branch che vuoi contemporaneamente e unire ciascuno quando è pronto.
Sì. Ogni collaboratore può aprire un branch diverso e chattare lì, e ogni branch si compila per conto suo. La tua app esegue diverse build contemporaneamente. Se ce ne sono altre in attesa, ognuna aspetta nella coda del proprio branch e parte appena un’altra build finisce.Creare un branch richiede l’accesso in modifica all’app, quindi i membri con il ruolo Viewer possono aprire i branch e leggere le loro chat. Scopri di più sui ruoli nel tuo workspace.
No. Costruire su un branch usa i crediti nello stesso modo di main, dallo stesso saldo crediti.
Sì. Base44 aggiunge i tuoi branch aperti al repository quando ti connetti, quindi non c’è niente da unire o eliminare prima. Se un branch sta costruendo in quel momento, aspetta che finisca, poi connetti.
Sì. Un’app che hai migrato da un’altra piattaforma funziona con i branch dallo stesso menu dei branch di qualsiasi altra app Base44.
Questa pagina è stata tradotta con l’AI. Per le informazioni più accurate e aggiornate, consulta la versione inglese.