Usar histórico de versões
Visualize versões anteriores da loja e restaure uma sem excluir o histórico mais recente.
Caminho de entrada: Espaço de trabalho → selecione uma loja → Vitrine → Histórico de Versões
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 seu projeto.
- Selecione Vitrine.
- Selecione Histórico de Versões na barra de ferramentas da loja.
- Revise os cartões da versão mais recente para trás.
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. |
| Falha na compilação | 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.
- Revise a nova versão atual em Preview antes de publicá-la.
Estados, limites e solução de problemas
| O que você vê | Significado | O que fazer |
|---|---|---|
| Ainda não há histórico de versões | 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 o histórico de versões | A solicitação da lista falhou. | Selecione Tentar novamente. |
| Falha ao carregar a pré-visualização desta versão. | 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. |