Todas as coleções

Aplicando alterações

Quando o workspace estiver pronto, o buildprint apply envia suas alterações locais commitadas de volta para o Bubble. É a etapa final do ciclo sincronizar → editar → verificar → aplicar.

buildprint apply

O que o apply faz

  1. Executa o buildprint check em memória contra a árvore de trabalho (worktree) atual. Qualquer problema de nível de erro aborta o apply.

  2. Faz o commit automático de quaisquer alterações não commitadas no workspace com a mensagem Apply from <appId>/<branch>. Se você quiser mensagens de commit diferentes, faça o commit antes de executar o apply.

  3. Compara o estado commitado com a referência de snapshot do Bubble para a branch atual, compila um conjunto mínimo de operações /write do Bubble e as envia.

  4. Em caso de sucesso, avança a referência de snapshot local para corresponder ao conteúdo atual do Bubble.

O buildprint apply sempre emite um resumo JSON. Formato: { ok, appId, branch, seconds, kind: "applied" | "unchanged", applied, summary? }. Scripts podem confiar nessa linha.

Argumentos posicionais

buildprint apply <appId> <branch>

Se você passar appId e branch posicionais, eles devem coincidir com os valores inferidos do workspace. Uma divergência falha imediatamente com uma mensagem clara — é uma rede de segurança, não uma forma de redirecionar o apply.

O que o apply se recusa a fazer

  • Aplicar a partir de um workspace cujo nome da pasta da branch não coincide com a branch do git em checkout.

  • Aplicar com problemas de verificação de nível de erro em aberto, a menos que --no-check esteja definido.

  • Aplicar um snapshot local obviamente pequeno sobre um workspace grande sem --allow-large-apply.

Quando o Bubble rejeita a gravação

O Bubble pode recusar a gravação se o usuário não concedeu permissões. Isso só é aplicável dentro de sandboxes do Buildprint, onde aplicamos permissões de branch / edição. Se estiver usando a CLI do Buildprint em sua própria máquina local, não aplicamos restrições de edição ou de branch.

Pré-visualização antes de aplicar

  • Use git diff e git status para revisar suas alterações locais.

  • Execute o buildprint check (com --all se quiser cobertura total) para encontrar problemas antes do apply.

Isso foi útil?