Pular para o conteúdo principal
Configure a integração com o GitHub para editar seu app Base44 localmente e sincronizar mudanças automaticamente.

Sincronizar seu app com o GitHub

Conecte seu app ao GitHub para escrever código no seu ambiente de desenvolvimento local ou na Base44 e mantê-los sincronizados.
GitHub connection prompt.

Conecte ao GitHub para sincronização bidirecional

Importante:
  • A sincronização bidirecional com GitHub requer o plano Builder ou superior.
  • Apenas proprietários do app podem conectar um app a um repositório ou reconectá-lo.
  • Se você anteriormente conectou ao GitHub usando a integração legada Export to GitHub (unidirecional), clique em Looking for the old setup? no painel do GitHub para desconectá-la e reconectar usando a sincronização bidirecional.
  • Quando você conecta seu app ao GitHub, suas mudanças são sincronizadas automaticamente com o repositório conectado. Não há opção para enviar atualizações manualmente do seu app Base44 para o GitHub.
  • Depois de conectar o GitHub ao seu app, você não pode usar o Version History para reverter para versões anteriores à integração com o GitHub. Essas versões mais antigas não são armazenadas no seu repositório do GitHub, então tentar reverter para elas resulta em erro. Apenas versões que existem no repositório conectado do GitHub estão disponíveis para restaurar.
Para sincronizar seu app com o GitHub:
  1. Clique em Painel no editor do seu app.
  2. Clique no ícone do GitHub no canto superior direito e clique em Conectar ao GitHub.
  3. Clique em Conectar o GitHub.
  4. Clique em Authorize Base44 Builder.
  5. Escolha onde instalar o Base44 Builder:
    • Selecione a organização ou conta do GitHub.
    • Escolha a quais repositórios permitir acesso.
  6. Clique em Instalar.
  7. Crie um repositório para seu app:
    • Escolha a organização ou conta do GitHub.
    • Insira um nome para o novo repositório.
    • Clique em Criar repositório.
Depois de conectar, clique no ícone do GitHub no painel superior, depois clique em Go to Repository.
GitHub showing Connected status and a Go to Repository button.

Veja seu repositório do GitHub conectado

Como sua equipe grava no GitHub

As conexões do GitHub pertencem ao seu workspace, e não à conta de uma pessoa. Os admins do workspace as gerenciam em Workspace settings > GitHub, e a sincronização continua funcionando se o membro que conectou uma organização sair do workspace. O admin do seu workspace escolhe como os membros gravam no GitHub. A configuração se aplica a todos os apps do workspace que sincronizam com o GitHub:
  • Conexão compartilhada: Todos gravam pela conexão do workspace, sem conectar uma conta própria do GitHub. Os commits mostram a Base44 como autora. Esse é o padrão.
  • Conexão por usuário: Cada membro conecta a própria conta do GitHub e recebe o acesso que o GitHub já dá a ele. Membros sem acesso de escrita ao repositório não podem editar nem publicar o app. Os commits aparecem com o nome do próprio membro.
Apps Base Code sempre usam conexões por usuário.
Como as organizações funcionam no seu workspace:
  • Ao criar um repositório, você só vê as organizações do GitHub que seu workspace permite.
  • Por padrão, apenas proprietários e admins do workspace podem adicionar uma nova organização. Os admins também podem permitir que Editors adicionem organizações.
  • As conexões feitas antes de o GitHub passar para o workspace foram migradas automaticamente, então você não precisa reconectar.

Configurar seu ambiente de desenvolvimento local

Depois de conectar ao GitHub, configure seu repositório local para começar a editar código no seu ambiente de desenvolvimento preferido. Para configurar seu repositório local:
  1. Clone o repositório usando a URL Git do projeto.
  2. Navegue até o diretório do projeto.
  3. Instale as dependências: npm install.
  4. Instale a CLI da Base44: npm install -g base44@latest.
  5. Autentique-se: base44 login.
  6. Vincule o clone ao seu app: base44 link. O ponteiro de vínculo base44/.app.jsonc está no gitignore, então cada clone novo precisa desta etapa.
Execute o app localmente:
Isso inicia um backend local da Base44 e seu servidor de desenvolvimento do frontend juntos. As solicitações /api do frontend são encaminhadas por proxy ao backend local. Consulte Local development para saber o que roda localmente. Para trabalhar apenas no frontend contra o backend hospedado ao vivo do seu app, execute base44 dev --remote em vez disso.
No modo remoto, as gravações vão para os dados de produção do seu app ao vivo.
Para detalhes sobre a estrutura de arquivos exportada, veja Project Structure.

Sincronizar mudanças locais com a Base44

Para sincronizar suas mudanças locais com a Base44, faça merge das mudanças para a branch principal do git. Esta branch deve se chamar main. Outros nomes de branch padrão, como master, atualmente não são suportados. A Base44 puxa as mudanças mescladas para que elas apareçam no seu app sempre que você abrir o editor do app ou estiver nele. Após sincronizar, clique em Publicar no canto superior direito do seu app Base44 para tornar as mudanças disponíveis para os usuários.

Implantar recursos de backend

Fazer merge para main sincroniza seu código com a Base44, mas não implanta todos os recursos de backend. Esta tabela descreve o comportamento e as etapas necessárias para implantar cada recurso depois que seu projeto é sincronizado:
A Base44 sincroniza a partir do seu repositório remoto no GitHub. Evite implantar recursos de backend com comandos de implantação da CLI, como base44 deploy, base44 functions deploy, base44 entities push e base44 agents push. Esses comandos registram seus recursos de backend diretamente na Base44 e ignoram o repositório remoto. Na próxima vez que a Base44 sincronizar a partir do repositório, ela sobrescreve quaisquer mudanças que o repositório não contenha, incluindo tudo o que você implantou com comandos da CLI. Para garantir que seus recursos de backend sejam sincronizados corretamente, faça merge das suas mudanças para main e use base44 dev para testar localmente.

Sincronizar mudanças remotas localmente

Quando você faz mudanças no editor do app Base44 ou restaura uma versão anterior pelo Histórico de versões, a Base44 envia um novo commit para main. Seu clone local não recebe esses commits automaticamente, então ele pode ficar atrás do repositório. Faça pull de main no seu clone local antes de fazer push novamente. O Git rejeita um push de um projeto local que não tem os commits que a Base44 adicionou.

Resolver conflitos de merge

Um conflito de merge ocorre quando um commit no seu repositório e uma mudança na Base44 editam as mesmas linhas de um arquivo. A Base44 não consegue lidar com conflitos de merge automaticamente. Em vez disso, o chat do editor do app lista os arquivos em conflito e pede que você clique em Resolver conflitos com IA, o que usa créditos.

Desconectar do GitHub

Você pode desconectar um app específico do seu repositório do GitHub, ou desconectar uma organização do GitHub de todo o seu workspace. Mover um app para outro workspace também desconecta a sincronização com o GitHub, e a Base44 avisa você antes disso.
Se você não vê Desconectar no painel do GitHub, ele ainda não está habilitado para a sua conta. A sincronização não pode ser pausada, então os únicos estados são conectado e desconectado.

Desconectar seu repositório

Desconecte seu app do seu repositório do GitHub se não quiser mais sincronizar mudanças. Apenas o proprietário do app ou o membro que conectou o repositório pode desconectá-lo. Para desconectar seu repositório:
  1. Abra a aba code.
  2. Clique em GitHub.
  3. Clique no ícone Mais ações .
  4. Clique em Desconectar.
O processo de desconexão leva aproximadamente 30 segundos e só está disponível quando o agente de IA não está fazendo mudanças ativamente no seu app.

Reconectar seu repositório

Reconecte seu app ao repositório do qual ele foi desconectado para retomar a sincronização. Apenas o proprietário do app pode reconectar.
A reconexão restaura apenas o repositório que você desconectou por último. Se você criar um novo repositório, seu app não poderá se reconectar ao repositório original.
Para reconectar seu repositório:
  1. Clique no ícone do GitHub no canto superior direito e clique em Conectar ao GitHub.
  2. Na caixa de diálogo Reconectar repositório, clique em Reconectar.
Quando você não pode reconectar:
  • Tanto seu app quanto o repositório têm novos commits desde a última vez em que estavam iguais.
  • O repositório foi renomeado ou excluído, ou a branch padrão dele mudou.
  • O repositório foi conectado a partir de outro workspace.
  • A conexão do workspace com a organização do repositório foi desconectada. Peça a um admin do workspace para reconectá-la em Workspace settings > GitHub.
Nesses casos, clique em Criar um novo repositório em vez disso.

Desconectar uma organização do seu workspace

Desconecte uma organização do GitHub se você não quiser mais que os apps do seu workspace sincronizem com ela. Todos os apps que sincronizam pela organização param de sincronizar, e o Base44 GitHub App continua instalado no GitHub. Proprietários, admins e Editors do workspace podem desconectar uma organização. Para desconectar uma organização:
  1. Vá para Workspace settings.
  2. Clique em GitHub.
  3. Em Organizações conectadas, clique no ícone Mais ações ao lado da organização.
  4. Clique em Desconectar organização.
  5. Clique em Desconectar para confirmar.
Esta página foi traduzida usando IA. Para as informações mais precisas e atualizadas, consulte a versão em inglês.