Skip to content

Mecanismo de Versioning do App Builder

Visão Geral

O App Builder inclui agora um mecanismo de versioning robusto. Você pode capturar e restaurar com segurança estados anteriores sem perda de dados ou inconsistências, independentemente de as alterações terem sido feitas manualmente.

Este mecanismo o ajuda a:

  • Salvar pontos de verificação nomeados durante sessões complexas de design.
  • Recuperar-se de alterações não intencionais.
  • Preservar pontos de restauração antes de operações de alto impacto.
Note

Desfazer/Refazer tem escopo de sessão. Se você fechar a aba do navegador, o histórico de desfazer será perdido. O Histórico de Versões fornece pontos de restauração persistentes entre sessões.

Pré-requisitos

Antes de começar:

  • Abra um aplicativo no App Builder.
  • Certifique-se de que você tem permissões de edição para o workspace do aplicativo.
  • Salve pelo menos uma alteração para habilitar entradas de versão relevantes à sua sessão atual.

O Que Você Pode Fazer

O recurso de versioning inclui duas capacidades principais:

  • Sistema de Versioning de Estado: Captura automática e manual de estados de aplicativos e visualizações.
  • Navegação e Gerenciamento de Versões: Listar, filtrar, renomear, duplicar, restaurar, abrir e deletar versões salvas.

Os snapshots capturam o estado do modelo do App Builder, incluindo:

  • Estrutura do aplicativo
  • Visualizações
  • Fontes de dados
  • Tema

O App Builder armazena snapshots de forma eficiente usando uma estratégia de Diff/Delta.

Acessar o Histórico de Versões

Você pode abrir o Histórico de Versões a partir do menu de aplicativo no dropdown do nome do aplicativo (Mostrar Histórico de Versões).

O painel abre no lado esquerdo e exibe uma linha do tempo das versões.

Salvar uma Versão Manual

Use versões manuais para criar pontos de restauração intencionais antes de alterações arriscadas.

  1. Abra o botão de salvamento dividido ou o menu de contexto do aplicativo/visualização.
  2. Selecione Salvar Versão.
  3. (Opcional) Digite um rótulo personalizado. : O formato padrão é Salvamento manual - [timestamp].
  4. Selecione Salvar.

No final:

  • O App Builder cria uma versão com um ID único atribuído automaticamente.
  • Um toast de sucesso aparece (por exemplo, Versão salva).

Snapshots Automáticos

Salvamos automaticamente apenas ao restaurar uma versão manualmente salva.

O painel de Histórico de Versões suporta navegação por linha do tempo e gerenciamento de versões.

Filtragem e agrupamento

Use filtros para estreitar os resultados:

  • Todas as Versões
  • Minhas Versões
  • Versões Nomeadas

Os grupos de linha do tempo podem incluir:

  • Mais Cedo Hoje
  • Mais Cedo Esta Semana
  • Mês Passado

As versões mais novas são exibidas primeiro por padrão.

Ações por versão

As ações por linha podem incluir:

  • Restaurar
  • Renomear
  • Duplicar
  • Deletar

Fluxo de Trabalho de Restauração

  1. Abra Histórico de Versões.
  2. Selecione a versão de destino.
  3. Escolha Restaurar.
  4. Confirme a restauração.

Resultado esperado:

  • Um toast de sucesso confirma a restauração.
  • Se você restaurar uma versão manualmente salva, o App Builder cria um snapshot automático antes da restauração.

Atualizações do Menu de Aplicativo e UX de Salvamento

O nome do aplicativo agora abre um dropdown com:

  • Renomear
  • Duplicar
  • Copiar para Workspace
  • Mostrar Histórico de Versões

Atualizações de comportamento relacionadas:

  • Renomear é acessado a partir do dropdown e da renomeação por clique.
  • Duplicar não força navegação para longe do aplicativo atual.
  • Toasts de sucesso confirmam ações, incluindo duplicação e salvamento de versão.

Retenção e Limpeza

A retenção de versão segue estas regras:

  • As versões são retidas por pelo menos 90 dias. Após isso, deletamos apenas as versões auto-salvas
  • As versões manuais e auto-salvas não são deletadas automaticamente, elas podem ser deletadas manualmente pelo usuário.

Limitações e Notas

  • O histórico de versões não substitui estratégias de branching de controle de código-fonte.
  • Desfazer/Refazer e Histórico de Versões são sistemas de recuperação diferentes.
  • A disponibilidade exata do gatilho pode variar por configuração de locatário e lançamento de implantação.

Resultados Esperados

Após usar o versioning, você pode:

  • Criar pontos de restauração confiáveis antes de edições arriscadas.
  • Recuperar-se rapidamente de alterações não intencionais que devem ser revertidas.
  • Rastrear a evolução de aplicativos e visualizações com metadados claros e filtros de linha do tempo.

Recursos Adicionais