# Abertura do branch de versões

Detalhamento do processo de como realizar a abertura de um novo Branch de Versão

# Nova Página



# Definição do Processo

##### **Resumo do processo**

O processo de gerenciamento do *Branch* de Versões é um ciclo, onde sempre após o fechamento do *Branch* atual, deverá ser realizada a abertura de um novo *Branch*, que passará a ser o atual *Branch* da Versão ou *Branch* da Versão de Trabalho, onde o mesmo será utilizado até ser fechado e as versões à ele relacionadas sejam liberadas aos clientes.

O pré-requisito para abertura/início de um novo *Branch* de Versão será que o *Branch* da Versão atual tenha sido <span style="text-decoration: underline;">[finalizado](https://wiki.supersoft.com.br/books/gerenciamento-do-branch-de-versao/page/finalizacao-do-fechamento-do-branch-da-versao)</span>.

---

##### **Envolvidos no processo**

Sempre será uma dupla que ficará responsável pela abertura, manutenção e fechamento do Branch da Versão, sendo um desenvolvedor e um testador.

---

##### **Etapas do processo**

1. [<span style="text-decoration: underline;">Decisão do Fechamento do Branch da Versão</span>](https://wiki.supersoft.com.br/books/gerenciamento-do-branch-de-versao/page/decisao-do-fechamento-do-branch-da-versao)
2. [<span style="text-decoration: underline;">Atualização dos arquivos "Config.ini"</span>](https://wiki.supersoft.com.br/books/gerenciamento-do-branch-de-versao/page/atualizacao-dos-arquivos-configini)
3. [<span style="text-decoration: underline;">Atualização dos arquivos "Altver.rtf"</span>](https://wiki.supersoft.com.br/books/gerenciamento-do-branch-de-versao/page/atualizacao-dos-arquivos-altverrtf)
4. [<span style="text-decoration: underline;">Solicitar a inclusão do Branch da versão no main</span>](https://wiki.supersoft.com.br/books/gerenciamento-do-branch-de-versao/page/solicitar-a-inclusao-do-branch-da-versao-no-main)
5. [<span style="text-decoration: underline;">Geração dos executáveis das versões</span>](https://wiki.supersoft.com.br/books/gerenciamento-do-branch-de-versao/page/geracao-de-executaveis-das-versoes)
6. [Validação e assinatura dos executáveis](https://wiki.supersoft.com.br/books/gerenciamento-do-branch-de-versao/page/validacao-e-assinatura-dos-executaveis)
7. [Geração das Customizações (DLLs) para liberação das versões](https://wiki.supersoft.com.br/books/gerenciamento-do-branch-de-versao/page/geracao-de-customizacoes-dlls-para-liberacao-das-versoes)
8. [Geração das pastas com as novas versões](https://wiki.supersoft.com.br/books/gerenciamento-do-branch-de-versao/page/geracao-das-pastas-com-as-novas-versoes)
9. [Publicação dos executáveis e instaladores](https://wiki.supersoft.com.br/books/gerenciamento-do-branch-de-versao/page/publicacao-dos-executaveis-e-instaladores)
10. [Finalização do fechamento do Branch da Versão](https://wiki.supersoft.com.br/books/gerenciamento-do-branch-de-versao/page/finalizacao-do-fechamento-do-branch-da-versao)
11. <span style="text-decoration: underline;">[Criação de novos casos para o Branch da Versão](https://wiki.supersoft.com.br/books/gerenciamento-do-branch-de-versao/page/criando-novos-casos-para-branch-de-versao-e-versionamento-dos-modulos-casos-pai)</span>
12. [Criação do repositório do Branch de Versão no Azure](https://wiki.supersoft.com.br/books/gerenciamento-do-branch-de-versao/page/criacao-do-repositorio-do-branch-de-versao-no-azure)
13. <span style="text-decoration: underline;">[Publicação do novo Branch da Versão para a equipe](https://wiki.supersoft.com.br/books/gerenciamento-do-branch-de-versao/page/publicacao-do-novo-branch-da-versao-para-a-equipe-de-desenvolvimento-e-qualidade)</span>

---

##### **Ponto inicial do processo**

Por se tratar de um processo cíclico, ou seja, o início do processo de gerenciamento do *branch* X é iniciado logo após a finalização do processo referente ao *branch* Y (sendo que Y = X - 1). O seu ponto inicial será sempre após a finalização do fechamento do Branch da Versão anterior.

---

##### **Ponto final do processo**

Será a criação do novo Branch da Versão no Azure e a publicação desse novo Branch para a equipe de Desenvolvimento e Qualidade.

---

##### **Resultado esperado**

Realizar toda a documentação do novo Branch da Versão, criando os novos casos no Mantis e publicar os novos casos para as equipes de Desenvolvimento e Qualidade.

# Criação do repositório do Branch de Versão no Azure

Após o caso do *Branch* da Versão ter sido [criado no Mantis](https://wiki.supersoft.com.br/books/beta-gerenciamento-do-branch-de-versao/page/criando-novos-casos-para-branch-de-versao-e-versionamento-dos-modulos-casos-pai), será necessário realizar um "New Branch" no Azure.

<p class="callout warning">Essa etapa só poderá ser realizada quando o *Branch* da Versão anterior já tiver sido vinculado ao *main*. Portanto antes de realizar essa etapa, confirmar com o desenvolvedor se o *Branch* já foi vinculado ao *main* e se pode ser criado o novo *Branch* de Versão.</p>

O repositório do *Branch* da Versão deverá ser criado dentro do repositório [https://dev.azure.com/SuperSoftDelphi/\_git/SistemaERPFISCO](https://SuperSoftDelphi@dev.azure.com/SuperSoftDelphi/SistemaERPFISCO/_git/SistemaERPFISCO)

No repositório ir em Branches -&gt; "New Branch" e seguir o modelo:

Em Name:

<p class="callout info">Número do *Branch* da Versão+Caso+Número do caso no mantis. Exemplo: "167-Caso-0053630"</p>

Em Base on:

<p class="callout info">Seguir sempre o padrão deixando em "main"</p>

Após criar o Branch ir em Branches -&gt; 3 pontinhos -&gt; Branch policies

[![image.png](https://wiki.supersoft.com.br/uploads/images/supersoft/gallery/2026-04/scaled-1680-/image.png)](https://wiki.supersoft.com.br/uploads/images/supersoft/gallery/2026-04/image.png)

<p class="callout info">Acessar a aba Policies deixar essa configuração padrão</p>

[![image.png](https://wiki.supersoft.com.br/uploads/images/supersoft/gallery/2026-04/scaled-1680-/f3ximage.png)](https://wiki.supersoft.com.br/uploads/images/supersoft/gallery/2026-04/f3ximage.png)

<p class="callout info">Na aba Security, deixar como padrão:</p>

[![image.png](https://wiki.supersoft.com.br/uploads/images/supersoft/gallery/2026-04/scaled-1680-/nkXimage.png)](https://wiki.supersoft.com.br/uploads/images/supersoft/gallery/2026-04/nkXimage.png)

# Criação dos novos casos para Branch de Versão

Após a [<span style="text-decoration: underline;">liberação e fechamento</span>](https://wiki.supersoft.com.br/books/gerenciamento-do-branch-de-versao/page/inicio-do-fechamento-do-branch-da-versao) de um Branch de Versão sempre será necessário realizar a abertura de um novo Branch e, com isso, abrir os casos no Mantis para documentação e manutenção do mesmo.

---

##### **Criação do Branch da Versão no Mantis**

O primeiro passo será a abertura do novo caso do Branch da Versão no Mantis, para isso deveremos preencher os campos conforme exemplos abaixo:

<p class="callout info">**Tipo do Projeto:** "Outros";  
**Categoria:** "Outros";  
**Resumo:** "BRANCH DE VERSÕES XXX - GERENCIAMENTO DE CASOS" (sempre incremental em +1);  
**Descrição:** Adicionar a mensagem padrão:  
  
*"Caso para controle e gerenciamento dos casos adicionados ao Branch de Versões.*  
  
*O Branch de Versões é a centralização dos códigos de todos os módulos que estão sendo trabalhados para liberação (Versões cheias).*  
*Todos os casos testados na versão "Por Caso", serão adicionados no Branch de Versões para ser trabalhado para liberação.*  
  
*Após os casos passarem por testes e retestes e estarem prontos para liberação, os casos são adicionados no TRUNK da Versão de liberação.*  
*O TRUNK será o repositório apenas dos casos que estão 100% finalizados."* **Aplicar marcadores:** "BRANCH\_ERP" ou "BRANCH\_FISCO" e "BRANCH\_VERSAO";   
**Departamento:** Qualidade ERP;  
**Tipo e Estado:** "Nova Versão".  
</p>

[![imagem_1.png](https://wiki.supersoft.com.br/uploads/images/supersoft/gallery/2026-04/scaled-1680-/imagem-1.png)](https://wiki.supersoft.com.br/uploads/images/supersoft/gallery/2026-04/imagem-1.png)

[![imagem_2.png](https://wiki.supersoft.com.br/uploads/images/supersoft/gallery/2026-04/scaled-1680-/imagem-2.png)](https://wiki.supersoft.com.br/uploads/images/supersoft/gallery/2026-04/imagem-2.png)

Após criar o caso, relacioná-lo ao caso <span style="text-decoration: underline;">[0044448 - Gerenciamento das Versões Correntes](https://mantis.supersoft.com.br/view.php?id=44448 "0044448 - Gerenciamento das Versões Correntes")</span>:

[![imagem_5.png](https://wiki.supersoft.com.br/uploads/images/supersoft/gallery/2026-04/scaled-1680-/imagem-5.png)](https://wiki.supersoft.com.br/uploads/images/supersoft/gallery/2026-04/imagem-5.png)

Após a [<span style="text-decoration: underline;">criação do caso do Branch da Versão </span>no Azure ](https://wiki.supersoft.com.br/books/gerenciamento-do-branch-de-versao/page/criacao-do-repositorio-do-branch-de-versao-no-azure "criação do caso do Branch da Versão no Azure ") feito pelo Desenvolvedor, copiar o endereço "URL" para o caso no Mantis, no quadro "Informações Adicionais", conforme exemplo:

[![imagem_3.png](https://wiki.supersoft.com.br/uploads/images/supersoft/gallery/2026-04/scaled-1680-/imagem-3.png)](https://wiki.supersoft.com.br/uploads/images/supersoft/gallery/2026-04/imagem-3.png)

[![imagem_4.png](https://wiki.supersoft.com.br/uploads/images/supersoft/gallery/2026-04/scaled-1680-/imagem-4.png)](https://wiki.supersoft.com.br/uploads/images/supersoft/gallery/2026-04/imagem-4.png)

##### **Criação dos casos de versionamento dos módulos (Casos pai)**

Assim como após a liberação e fechamento de um Branch de Versão é necessário fazer a abertura de um novo, também é necessário criar novos "casos pai" para os módulos que foram liberados no Branch da Versão anterior.

O processo para abertura dos "casos pai" é basicamente o mesmo do que o da abertura do caso do Branch da Versão, salvo algumas exceções. Para a abertura dos casos pai seguir as regras abaixo:

<p class="callout info">**Tipo do Projeto:** Deve ser o tipo de projeto de cada módulo, exemplo "Compras", "Vendas", "Estoque", etc.  
**Categoria:** "Outros";  
**Resumo:** "Versão 5.191 - COMPRAS" (Número da versão incremental em +1 e o módulo referente ao caso pai);  
**Descrição:** "Versão 5.191 - COMPRAS" (repetir o campo "Resumo");  
**Aplicar marcadores:** "Não é necessário aplicar marcadores;  
**Departamento:** Qualidade ERP;  
**Tipo e Estado:** "Nova Versão".  
</p>

[![imagem_6.png](https://wiki.supersoft.com.br/uploads/images/supersoft/gallery/2026-04/scaled-1680-/imagem-6.png)](https://wiki.supersoft.com.br/uploads/images/supersoft/gallery/2026-04/imagem-6.png)

Após a abertura dos casos, também relacioná-lo ao caso <span style="text-decoration: underline;">[0044448 - Gerenciamento das Versões Correntes ](https://mantis.supersoft.com.br/desenvol/view.php?id=44448) </span>e também ao Branch atual de versões:

[![imagem_7.png](https://wiki.supersoft.com.br/uploads/images/supersoft/gallery/2026-04/scaled-1680-/imagem-7.png)](https://wiki.supersoft.com.br/uploads/images/supersoft/gallery/2026-04/imagem-7.png)

# Aviso de publicação do novo Branch da Versão para a equipe

<p class="callout warning">**Processo feito pelo Desenvolvimento**</p>

Após o *Branch* da Versão ter sido criado tanto no Mantis quanto no Azure, é necessário avisar à equipe de Desenvolvimento e Qualidade que o novo *Branch* está pronto e que deverão passar a utilizá-lo.

Para isso, no comunicador padrão utilizado pela equipe (atualmente é o *Rocket* *Chat*), no canal "Equipe.Delphi.ERP" deverá ser enviada uma mensagem seguindo o padrão:

<p class="callout info">Pessoal!  
*BRANCH* 168 foi liberado na data 07/04/2026.  
  
Foi criado o caso e pasta no *SVN* para o *BRANCH* 169.  
[https://dev.azure.com/SuperSoftDelphi/SistemaERPFISCO/\_git/SistemaERPFISCO?version=GB169-Caso-0053778](https://dev.azure.com/SuperSoftDelphi/SistemaERPFISCO/_git/SistemaERPFISCO?version=GB169-Caso-0053778)  
Favor utilizar esse *BRANCH* a partir de hoje.  
  
Obrigado!</p>

# [extinto] Criação do repositório do Branch de Versão no SVN

Após o caso do *Branch* da Versão ter sido <span style="text-decoration: underline;">[criado no Mantis](https://wiki.supersoft.com.br/books/beta-gerenciamento-do-branch-de-versao/page/criando-novos-casos-para-branch-de-versao-e-versionamento-dos-modulos-casos-pai)</span>, será necessário realizar um "*<span style="text-decoration: underline;">[Copy to](https://wiki.supersoft.com.br/books/svn-basico/page/copy-to)</span>*" no SVN, copiando o *Trunk* (<span style="text-decoration: underline;">[https://svn.supersoft.com.br/svn/desenvolvimento/trunk/CodigoBaseSkin](https://svn.supersoft.com.br/svn/desenvolvimento/trunk/CodigoBaseSkin)</span>) para um novo repositório que será criado para o *Branch* da Versão.

<p class="callout warning">Essa etapa só poderá ser realizada quando o *Branch* da Versão anterior já tiver sido vinculado ao *Trunk*. Portanto antes de realizar essa etapa, confirmar com o desenvolvedor se o *Branch* já foi vinculado ao *Trunk* e se pode ser criado o novo *Branch* de Versão.</p>

O repositório do *Branch* da Versão deverá ser criado dentro do caminho

ERP:  
([<span style="text-decoration: underline;">https://svn.supersoft.com.br/svn/desenvolvimento/branches/Versoes/ERP</span>)](https://svn.supersoft.com.br/svn/desenvolvimento/branches/Versoes/ERP/042-Caso-0044323)

Fisco:  
(<span style="text-decoration: underline;">[https://svn.supersoft.com.br/svn/desenvolvimento/branches/Versoes/Fisco](https://svn.supersoft.com.br/svn/desenvolvimento/branches/Versoes/Fisco))</span>

e deverá seguir o modelo:

<p class="callout info">Número do *Branch* da Versão+Caso+Número do caso no mantis. Exemplo: "042-Caso-0044323"</p>

Dessa forma o endereço completo do *Branch* da Versão ficará parecido com:

<span style="text-decoration: underline;">[https://svn.supersoft.com.br/svn/desenvolvimento/branches/Versoes/ERP/042-Caso-0044323](https://svn.supersoft.com.br/svn/desenvolvimento/branches/Versoes/ERP/042-Caso-0044323).  
</span>  
Após inserir o caminho de repositório, uma tela de mensagem de *log* será aberta, e deverá seguir o modelo:

<p class="callout info">Número do caso: BRANCH DE VERSÕES + Número do *Branch* da versão - GERENCIAMENTO DE CASOS.   
Exemplo: "0044760: BRANCH DE VERSÕES 048 - GERENCIAMENTO DE CASOS"</p>

<p class="callout success">Após a realização de todos os passos, o resultado final deverá ser semelhante a: </p>

[![image-1616422198821.png](https://wiki.supersoft.com.br/uploads/images/gallery/2021-03/scaled-1680-/image-1616422198821.png)](https://wiki.supersoft.com.br/uploads/images/gallery/2021-03/image-1616422198821.png)