Usar histórico de versões
Visualize versões anteriores da loja e restaure uma sem excluir o histórico mais recente.
As capturas de tela e as gravações mostram a interface em inglês. Os nomes dos controles podem variar conforme o idioma selecionado.
Caminho de entrada: Espaço de trabalho → selecione uma loja → Loja virtual → Histórico de versões (ícone de relógio com seta)
O que este guia cobre
Compare versões da loja, visualize uma versão anterior pronta e—quando necessário—restaure seu conteúdo como uma nova versão atual mantendo o histórico existente.
Por que e quando usar o histórico de versões
Use o histórico de versões quando você precisa entender o que mudou, revisar um design anterior ou recuperar conteúdo que era melhor antes de uma solicitação recente. A visualização é somente leitura. Restaurar altera o projeto, portanto revise a confirmação primeiro.
Disponibilidade e pré-requisitos
- Abra um projeto com pelo menos uma versão da loja.
- A visualização histórica e restauração estão disponíveis apenas para versões que o Runner consegue carregar com sucesso.
- Aguarde o Runner terminar uma solicitação ativa antes de restaurar.
- O histórico de versões é condicional em workspaces que usam a experiência de loja baseada em checkpoint.
- Alguns cartões de trabalho de conversa concluída também mostram um rótulo de versão condicional, visualização de versão exata e ação Publicar para uma versão atual não publicada. Esses cartões são uma entrada rápida; esta página permanece como a visualização completa de comparação e restauração.
Abrir histórico de versões
Abra a loja que deseja revisar e siga as marcações numeradas abaixo.
- Selecione Vitrine na barra lateral esquerda. Isso abre a prévia da sua loja. Se a barra lateral mostrar apenas ícones, expanda-a usando o botão no canto superior esquerdo.
- Clique no ícone de relógio com seta acima da prévia, perto do canto superior direito. Esse é o Histórico de versões. Passe o cursor sobre ele para ver o nome. No exemplo, ele fica logo à esquerda do endereço do site publicado e de Publicar alterações.
- Confira se o painel Histórico de Versões abre à direita. A versão mais recente aparece em Versão Atual. Role para baixo para revisar versões anteriores, se a loja tiver alguma. Selecione Voltar (a seta para a esquerda ao lado do título do painel) para fechá-lo.
Selecione a imagem para ampliá-la. As telas de desktop com anotações mostram onde clicar. Abrir o histórico não restaura nem publica nada. Uma loja com apenas uma versão registrada mostra somente Versão Atual.
No celular: abra Loja virtual, toque em Mais ações (…) ao lado do botão de publicação na parte inferior e depois toque em Histórico de versões.
Se o controle do histórico não aparecer, saia do Modo Design ou volte primeiro à prévia mais recente. Aguarde a conclusão da compilação inicial. A disponibilidade também pode depender da experiência de vitrine do seu workspace.
Exemplo com uma versão anterior
Compare os rótulos antes de escolher uma versão. Este exemplo apenas abre o histórico; não restaura nem publica uma versão.
Controles do histórico de versões
| Controle | Por que você o usa | O que acontece quando você o seleciona |
|---|---|---|
| Voltar | Saia da lista de versões. | O Runner retorna à visualização da loja. |
| Captura de tela da versão | Inspecione a aparência capturada. | A captura de tela abre em um visualizador de imagem maior quando disponível. |
| Ver diff completo | Veja um registro detalhado do que mudou. | O Runner abre os detalhes da alteração dessa versão em uma nova aba. |
| Visualização / Visualizar esta versão | Revise uma versão anterior pronta sem restaurá-la. | A loja muda para uma visualização histórica temporária rotulada Visualizando v…. A versão do projeto mais recente e a loja ativa não mudam. |
| Voltar ao mais recente / Voltar para a versão atual | Termine uma visualização histórica. | O Runner recarrega a versão atual mais recente da loja. |
| Restaurar | Reutilize o conteúdo de uma versão anterior. | O Runner abre Restaurar para a v…?. Confirmar cria uma nova versão mais recente com esse conteúdo; a versão selecionada, versões mais recentes e histórico permanecem. |
| Mais ações | Acesse ações de cartão em layouts compactos. | Um menu abre com as ações disponíveis para essa versão, como Visualização, Restaurar ou Ver diff completo. |
| Publicar na versão atual | Comece a publicar a versão mais recente. | O Runner abre as verificações de publicação. Não publica uma visualização histórica diretamente. |
Leia os cartões de versão
| Rótulo ou estado | Significado |
|---|---|
| Mais recente ou Versão Atual | Esta é a versão do projeto mais recente. |
| Publicado | Esta versão está associada a uma publicação concluída. Não prova que o checkout está funcionando agora. |
| Compilando… | O Runner ainda está criando a versão. Visualização e restauração podem não estar disponíveis. |
| Build falhou | Esta versão não atingiu um estado pronto. Use seu contexto de erro para pedir ao Runner uma correção. |
| Contagens de alteração de arquivo | Um resumo de arquivos adicionados, alterados ou removidos para essa versão. |
| Hora | Quando a versão foi registrada. |
| Descrição | O resumo registrado da versão quando disponível. |
Visualize e restaure com segurança
- Selecione Visualização na versão que você deseja inspecionar.
- Confirme que a barra de ferramentas diz Visualizando v… para não confundir com a versão mais recente.
- Verifique as páginas relevantes e layouts de dispositivo.
- Selecione Voltar ao mais recente se você apenas precisava comparar.
- Para recuperar o conteúdo anterior, selecione Restaurar.
- Leia a confirmação: o Runner adicionará uma nova versão e manterá o histórico existente.
- Confirme a restauração apenas quando o Runner estiver inativo.
- Confira se aparece uma nova Versão Atual e revise o conteúdo restaurado na prévia antes de publicar. O histórico anterior deve continuar disponível.
Estados, limites e solução de problemas
| O que você vê | Significado | O que fazer |
|---|---|---|
| Cada alteração que o Runner faz aparece aqui como uma versão para a qual você pode voltar. | Apenas o estado inicial atual existe ou nenhum histórico está disponível. | Continue trabalhando; retorne depois que o Runner registrar outra versão. |
| Carregando histórico de versões… | O Runner está recuperando os cartões. | Mantenha o painel aberto até terminar. |
| Não foi possível carregar suas versões — tente novamente. | A solicitação da lista falhou. | Selecione Tentar novamente. |
| Não foi possível mostrar esta versão — tente novamente ou escolha outra. | Essa visualização histórica não pôde ser iniciada. | Retorne ao atual e tente outra versão pronta. |
| Restaurar está desabilitado | O Runner está ativo ou a versão não é restaurável. | Aguarde o Runner terminar ou selecione uma versão pronta. |
| Não é possível restaurar enquanto o agente está trabalhando. Tente novamente quando ele terminar. | Restaurar entraria em conflito com a tarefa ativa. | Deixe a tarefa atingir um estado terminal e tente novamente. |
| O conteúdo restaurado não está ativo | Restaurar criou uma versão do projeto, não uma publicação. | Revise-a e selecione Publicar alterações. |