Tutorial: trabalhando com o controle de origem

O controle de versões (também conhecido como controle de origem) é a prática de rastrear e gerenciar alterações no código do software ou arquivos dentro de um projeto. Os sistemas de controle de versões são ferramentas de software que ajudam as equipes a gerenciar as alterações em um projeto ao longo do tempo.

O software de controle de versões ajuda a manter o controle das alterações e mantém os membros da equipe trabalhando na versão mais recente. Ela deve ajudar você a se desenvolver e enviar mais rápido ao melhorar a visibilidade e ajudar as equipes a colaborarem. As alterações são armazenadas em um tipo de banco de dados, chamado de repositório. Se um erro for cometido, você pode comparar versões anteriores do projeto do StudioX para ajudar na correção do erro e, ao mesmo tempo, minimizar interrupções para todos os membros da equipe.

Observação: esse tutorial se aplica apenas ao StudioX v2020.10 e v2021.4. Para versões mais recentes do StudioX, consulte Gerenciamento de projetos com o GIT no guia do StudioX.

Embora haja vários softwares de controle de versões disponíveis, este guia usa o Bitbucket e o GitHub Desktop como exemplos.

Criação de repositórios

Peça que seu administrador ou gerente de equipe crie repositórios para você. Uma prática recomendada geral é ter dois repositórios:

• Um repositório pessoal para você armazenar seus projetos pessoais do StudioX, onde é improvável que outros usuários precisem de acesso.
• Um repositório compartilhado pela equipe para projetos do StudioX no qual todos os membros de sua equipe ou organização provavelmente precisarão acessar os arquivos dos projetos.

Dicas e recursos

• Trabalhe apenas com uma única ramificação (por exemplo, mestre).
• Não crie ramificações adicionais ou solicitações de puxar sem um bom motivo. Elas podem complicar o processo de uso do controle de versões.
• Sempre faça uma Solicitação pull para sincronizar quaisquer alterações do repositório antes de começar a trabalhar em um projeto.
• Sempre faça uma Confirmação e um Push quando você terminar de trabalhar em um projeto, para assegurar que suas alterações sejam carregadas no repositório.
• Para obter guias mais aprofundados do GitHub, acesse o Portal de documentação do GitHub Dekstop.
• Para obter mais guias relacionados ao trabalho no aplicativo Sourcetree, acesse o Portal de documentação do Atlassian.

<details>

<summary>GitHub Desktop</summary>

Download e instalação do GitHub Desktop

Para começar a usar o GitHub Desktop, você precisa baixá-lo, instalá-lo e configurá-lo em sua máquina. Para fazê-lo, acesse o Guia do GitHub sobre como baixar e instalar seu software.

Configuração do GitHub Desktop em sua máquina

Se você ainda não tiver uma conta, crie uma e faça login no aplicativo GitHub Desktop.

Para conectar um repositório a seu projeto local:

1. Abra o aplicativo GitHub Desktop.
2. Clique no menu Arquivo e selecione Fechar repositório.

3. Na janela que se abre:

   • Clique na guia GitHub.com.
   • Insira o nome do repositório.
   • Insira o \Documents\UiPathcaminho da sua pasta no campo Caminho local.

4. Clique em Clonar após tudo ter sido configurado.

   
   

   

   
   

Trabalho com projetos

Sincronize quaisquer alterações do repositório

Antes de criar um novo projeto ou fazer alterações em um projeto existente no StudioX, certifique-se de que todos os projetos estejam fechados no StudioX (a maneira mais segura é certificar-se de que todas as instâncias do StudioX estejam fechadas)

1. Abra o aplicativo GitHub Desktop.

2. Escolha o repositório que contém o projeto no qual você está trabalhando.

   
   

   

   
   
3. Clique no menu Repositório na parte superior e selecione Puxar.

Criar um novo Projeto

Para criar um novo projeto do StudioX que usa o controle de versões:

1. Crie uma nova tarefa no StudioX.

2. No campo Localização, navegue até a pasta que representa o repositório correto (equipe pessoal ou compartilhada).

   
   

   

   
   

Isso coloca o projeto em sua própria pasta na raiz do repositório.

Observação:

Para projetos existentes, se você quiser movê-lo para o controle de versões, a pasta pode ser

movida manualmente para a pasta do repositório.

Confirmação de alterações

Você pode salvar (confirmar) alterações da sua máquina local para o repositório online quantas vezes precisar.

1. Feche o projeto no StudioX.
2. Abra o aplicativo GitHub Desktop.

3. Escolha o repositório que contém o projeto do StudioX no qual você deseja confirmar alterações.

   
   

   

   
   
4. Insira um breve resumo das alterações no campo Resumo.

5. Clique no botão Confirmar.

   
   

   

   
   
6. Clique no menu Repositório na parte superior e selecione Puxar.

7. Clique no botão Empurrar origem para enviar suas alterações para o repositório.

   
   

   

   
   

</detalhes>

<details>

<summary>Bitbucket</summary>

Download e instalação do aplicativo Sourcetree

Para começar a usar o Sourcetree, você precisa baixá-lo, instalá-lo e configurá-lo em sua máquina. Para fazê-lo, acesse o Guia do Atlassian sobre como baixar e instalar seu software.

Trabalho com projetos

Sincronize quaisquer alterações do repositório

Antes de criar um novo projeto ou fazer alterações em um projeto existente no StudioX, certifique-se de que todos os projetos estejam fechados no StudioX (a maneira mais segura é certificar-se de que todas as instâncias do StudioX estejam fechadas)

1. Abra o aplicativo Sourcetree.
2. Clique em Remoto na parte superior.

3. Selecione o repositório que contém o projeto no qual você está trabalhando clicando em Clonar.

   
   

   

   
   

Criar um novo Projeto

Para criar um novo projeto do StudioX que usa o controle de versões:

1. Crie uma nova tarefa no StudioX.

2. No campo Localização, navegue até a pasta que representa o repositório correto (equipe pessoal ou compartilhada).

   
   

   

   
   

Isso coloca o projeto em sua própria pasta na raiz do repositório.

Observação:

Se houver projetos existentes que precisam ser movidos para o controle de versões, a pasta pode ser

movida manualmente para a pasta do repositório.

Confirmação de alterações

Você pode salvar (confirmar) alterações da sua máquina local para o repositório online quantas vezes precisar.

1. Feche o projeto no StudioX.
2. Abra o aplicativo Sourcetree.
3. Certifique-se de que o repositório que contém o projeto do StudioX esteja selecionado.
4. Clique no ícone + ao lado dos arquivos que você deseja confirmar para adicioná-los à lista.
   
   

   

   
   
5. Marque a caixa de seleção Empurrar alterações imediatamente para a origem/mestre.

6. Digite uma mensagem e clique em Confirmar no canto inferior direito.

   
   

   

   
   

</detalhes>