Como posso ver um repositório do GitHub e saber qual versão do código fazer o download?

5

Eu sou novo no GitHub e novo no mundo do código aberto (vindo do .NET). Eu tenho um site wiki de mídia e quero instalar uma extensão do Google Analytics: link

A documentação da extensão diz para baixar o código de GitHub .

No repositório do GitHub, há algumas "resenhas" que dizem mestre e outras que dizem ramificações. Eu suponho que eu quero um mestre e não um ramo. Mas como faço para escolher qual mestre baixar? Além disso, a documentação diz que alguns dos commits serão marcados, mas isso não parece ser o caso. Sem tags / documentação existe alguma maneira fácil de saber quais commits são estáveis e quais commits não são?

Eu adoraria alguma sabedoria geral sobre como abordar um repositório para um projeto como este.

    
por Bernie2436 30.07.2013 / 06:49
fonte

2 respostas

3

Se o repositório está seguindo os padrões usuais (o que é um pouco mais provável para repositórios Git do que outros VCS, na minha experiência), então você quer a ramificação master para versões estáveis. Em teoria, se estiver em master , ele deve ser testado e funcionando, portanto, a confirmação mais recente para master deve ser a versão estável mais recente.

Olhando para o repo que você vinculou, vou direto para a seção "branches" e vejo "master". Clicando nisso, eu vejo que este commit está marcado como REL1_21 , que eu assumo significa release 1.21, que eu suponho corresponde ao nome desta versão usada em sua documentação. Esse é um bom lugar para começar.

Analisando rapidamente a partir daí, vejo principalmente os commits de um bot, atualizando a localização. Provavelmente nada quebrando lá. Há também um commit que menciona uma alteração. Se eles estão fazendo as coisas corretamente, isso deve ser uma correção, e definitivamente não é uma quebra, pois é um compromisso com master sem uma tag de versão. Verificando o comentário sobre este commit, vejo que ele menciona as medidas tomadas para preservar a compatibilidade com versões anteriores.

Agora que estou feliz que nada de ruim foi empurrado para master desde o último lançamento, simplesmente agarro o commit mais recente: no momento da escrita, isso é este . Se eu tiver problemas com esta versão, ou se eu não estivesse convencido de que a mudança era segura, eu teria o última tag com commit , e continue até que eles adicionem uma versão a master marcada com algo maior que 1.21, (que, baseado em uma estimativa rápida em seu sistema de versionamento, seria REL1_22 ou REL2_0 ).

É claro que alguém esperaria que a documentação do projeto apontasse para a versão correta, tornando este processo desnecessário, mas infelizmente nem sempre é o caso. Quando você se encontra nessa situação, o processo que usei aqui funciona para a maioria dos repositórios, Git ou de outra forma, desde que uma estratégia de ramificação vagamente sensata tenha sido usada:

  • Encontre um ramo chamado "main", "master", "stable" ou algo similar
  • Encontre o último commit com a tag da versão para esse branch
  • Verifique se nada de estranho foi adicionado a essa ramificação - qualquer coisa que possa introduzir alterações inesperadas
    • Se não houver nada, pegue o commit mais recente
    • Se houver uma alteração potencialmente problemática, pegue o commit marcado
  • De qualquer forma, se você tiver problemas com a versão que você tem, volte para a confirmação marcada anterior.
  • Quando você encontrar uma versão que funcione, mantenha-a até que ela libere uma nova versão marcada e, em seguida, obtenha isso. Se isso não funcionar, volte para o que você estava antes e espere por uma nova versão.
por 30.07.2013 / 11:02
fonte
2

Em um repositório git, é muito fácil descobrir isso. Haverá ramos diferentes e o mestre é apenas um ramo dos ramos. Na tradição, você encontrará no mestre as versões estável / aprovada / atual (depende do manuseio de agências). Algumas pessoas apenas desenvolvem com o mestre.

Se um repositório desse tipo estiver hospedado no Github (o link não é), você poderá ver as tags com facilidade. O repositório vinculado parece colocar a versão mais recente no branch master. Você deve simplesmente usar o último commit disponível.

Qual versão você deve baixar depende muito de como o projeto é mantido. Como um exemplo para um repositório Github aqui, o repositório Symfony2 Github .

    
por 30.07.2013 / 08:50
fonte