Sobre o gerenciamento de versões
Saiba sobre o gerenciamento de versões para o SDK da Braze, para que seu app possa ficar atualizado com os últimos recursos e melhorias de qualidade. Como versões mais antigas do SDK podem não receber o último patch, correções de bugs ou suporte, recomendamos sempre mantê-lo atualizado como parte do seu ciclo de desenvolvimento contínuo.
Recomendações de versionamento
Todos os SDKs da Braze seguem a Especificação de Versionamento Semântico (SemVer), então, dado um número de versão MAJOR.MINOR.PATCH, recomendamos o seguinte:
| Versão | Sobre esta versão | Recomendação |
|---|---|---|
PATCH |
As atualizações são sempre não disruptivas e incluem correções de bugs importantes. Elas sempre serão seguras. | Você deve sempre tentar atualizar para a versão de patch mais recente da sua versão principal e secundária atual imediatamente. |
MINOR |
As atualizações são sempre não disruptivas e incluem novas funcionalidades. Elas nunca exigirão mudanças no código da sua aplicação. | Embora você não precise fazer isso imediatamente, deve atualizar para a versão secundária mais recente da sua versão principal atual o mais rápido possível. |
MAJOR |
As atualizações são mudanças disruptivas e podem exigir mudanças no código da sua aplicação. | Como isso pode exigir mudanças no código, atualize para a versão principal mais recente em um período que funcione melhor para sua equipe. |
Às vezes, novas atualizações do Android ou do sistema operacional da Apple exigem mudanças no SDK da Braze. Para garantir que seu app seja compatível com telefones mais novos, é importante que você mantenha seu SDK atualizado.
Recebendo notificações de novos lançamentos
Para receber notificações automáticas quando uma nova versão do SDK for lançada, você pode acompanhar o repositório no GitHub de qualquer SDK da Braze:
- Acesse o repositório do SDK no GitHub (por exemplo, braze-android-sdk, braze-swift-sdk ou braze-web-sdk).
- Clique em Watch no canto superior direito.
- Clique em Custom, selecione Releases e clique em Apply.
Você receberá uma notificação do GitHub (e um e-mail, dependendo das suas configurações de notificação) cada vez que um novo lançamento for publicado. Para a lista completa de repositórios de SDK, consulte Referências, repositórios e apps de exemplo.
Sobre problemas conhecidos
Para garantir que nossas mudanças não quebrem suas pipelines de build, nunca alteraremos ou removeremos uma versão depois que ela for publicada em um sistema de distribuição—mesmo que essa versão específica tenha problemas conhecidos.
Nesses casos, documentaremos o problema no changelog do SDK da Braze e lançaremos um novo patch para as versões principais ou secundárias impactadas o mais rápido possível.