Eu uso o Android Studio há anos, mas só recentemente comecei a ver arquivos com o *.toml
sufixo. Vejo que eles funcionam com arquivos gradle, mas tenho migrado para kotlin em vez de arquivos gradle (conforme os novos padrões do Google).
Também vejo que os arquivos toml estão sendo modificados automaticamente. Para mim, isso implica que eles não precisam ser controlados por versão. Mas é claro que eles são alterados, e o git os identifica como modificados.
Para referência, o arquivo modificado atualmente é gradle/libs.versions.toml
. Mas ocasionalmente vejo outros.
Então a grande questão: devo adicionar algo como *.toml
ao meu .gitignore
arquivo? Ou isso causará problemas no futuro (como o quê?).
Este arquivo é importante e deve ter controle de versão.
O
libs.versions.toml
arquivo é o catálogo de versões e pertence aos seus arquivos de build. O Android Studio começou recentemente a usar catálogos de versões por padrão para novos projetos. Há também um guia de migração para projetos Android antigos disponível.Um catálogo de versões é um lugar central para listar todas as versões das dependências usadas em sua compilação. Em contraste com o
dependencies
bloco de seus arquivos gradle, é apenas uma lista simples sem nenhuma lógica envolvida. As implementações em seudependencies
bloco então só precisam referenciar uma entrada do catálogo de versões se elas exigirem essa dependência específica, sem a necessidade de se preocupar em usar a versão correta.Atualizar versões é algo que agora é feito apenas no catálogo de versões, um exercício que é feito com muito mais frequência do que atualizar o resto dos seus arquivos de build. As alterações são, portanto, isoladas apenas para aquele único arquivo.
Quando você usa as configurações de projeto do Android Studio para atualizar suas dependências, o
libs.versions.toml
arquivo é atualizado automaticamente. Mas se você não fizer check-in desse arquivo, perderá todas as versões definidas e seus arquivos gradle não poderão referenciar as dependências definidas e você não poderá mais compilar seu aplicativo. Portanto, é fundamental que você o armazene junto com o restante dos seus arquivos de compilação e faça check-in no sistema de controle de versão que você usa.