O que é uma breaking change
Breaking change é uma alteração que quebra a compatibilidade com o uso anterior. Ela pode remover uma função, mudar o formato de retorno ou alterar o significado de um campo.
A mudança pode ser correta e ainda assim exigir trabalho. Um sistema que dependia do comportamento antigo precisa ajustar o código antes de adotar a versão nova.
Como a versão comunica
O versionamento semântico usa a versão principal para sinalizar mudanças incompatíveis. Uma correção sobe o último número, uma função nova sobe o do meio, e uma quebra sobe o primeiro.
A leitura do número ajuda a planejar a atualização. Uma dependência que muda de versão principal merece atenção maior do que uma correção pontual.
Preparar a atualização
Você lê as notas da versão, identifica as funções usadas pelo projeto e testa os percursos que dependem delas. Manter uma referência da versão anterior ajuda a comparar o comportamento antes e depois.
O release do projeto precisa registrar a versão adotada e o ajuste feito. Sem esse registro, a próxima atualização parte do mesmo desconhecimento.
Manter a compatibilidade no que você publica
Publicar uma biblioteca ou API cria a mesma responsabilidade. Anunciar a mudança com antecedência e oferecer um período de transição reduz o efeito sobre as aplicações que dependem do serviço.
Para revisar uma atualização de dependência e conferir os percursos afetados, o Desenvolvimento Colaborativo da Dev Side Studio permite executar os testes durante a sessão.
Dúvidas frequentes
Perguntas frequentes sobre Breaking changes
- Toda atualização tem breaking change?
- Não. As mudanças incompatíveis costumam vir em uma versão principal nova. Correções e melhorias menores tendem a preservar o comportamento anterior.
- Mudar o comportamento sempre quebra o sistema?
- Quebra quando outro sistema dependia do comportamento antigo. A alteração pode ser correta para o produto e ainda exigir ajuste na aplicação que usava a interface anterior.
- Como reduzir o efeito de uma quebra?
- Leia as notas da versão, teste os percursos principais antes de atualizar e mantenha a versão anterior disponível. A [regressão](/glossario/regressao/) aparece quando a mudança passa sem verificação.
Para continuar
Recursos relacionados
Site de referência
Wikipedia: compatibilidade reversa
Apresenta a compatibilidade entre versões e o efeito das mudanças de interface.
Abrir recursoSite de referência
Versionamento semântico
Define como a versão comunica mudanças incompatíveis, novas funções e correções.
Abrir recursoAplicação na formação
Developer Workspace
As breaking changes mostram por que uma atualização de dependência exige revisão antes de entrar no projeto.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.