Como lidar com o controle de origem e versão do GitHub no Xcode

Simplifique seu fluxo de trabalho utilizando o controle de versão Git diretamente no Xcode.

O controle de versão envolve acompanhar os vários estágios do seu código enquanto você constrói seu projeto. Isso permite que você tenha controle total do seu progresso e seja capaz de refazer e recuperar versões mais antigas, se necessário. Provavelmente você já usa algum tipo de ferramenta de controle de versão como GitHub, GitLab ou BitBucket se for desenvolvedor ou programador.

Por que usar o Xcode para controle de versão Git?

Às vezes, lidar com alterações de arquivos com qualquer uma das ferramentas mencionadas pode ser complicado. Você pode empregar o uso de uma ferramenta de interface de linha de comando ou interagir com uma interface da web.

Este também é o caso ao usar o Git, uma poderosa ferramenta de controle de versão distribuída. Ter um sistema de controle de versão distribuído significa que você pode colaborar em um projeto com a equipe, com todos tendo uma cópia de todo o repositório de arquivos. A ferramenta Git utiliza o GitHub como serviço de hospedagem de seus repositórios com interface web para interação. Você deve estar familiarizado com o GitHub e seus recursos para usar o Git.

Ter controle total das alterações de arquivos e controle de versão diretamente do seu IDE Xcode pode tornar a experiência do desenvolvedor muito mais simples. Obviamente, isso não substitui o uso da ferramenta CLI em situações mais complexas, mas é sempre uma conveniência.

Conectando o Xcode a uma conta GitHub

A primeira etapa para conectar o Xcode à sua conta GitHub é navegar até a guia Configurações > Contas do Xcode. Aqui você adicionará e fará login em sua conta existente do GitHub.

O aplicativo solicitará que você forneça seu Token de acesso pessoal (PAT) para fazer login em sua conta com sucesso.

Se você não tiver um, siga estas etapas para gerar um PAT:

Etapa 1: Acessando tokens de acesso pessoal nas configurações do GitHub

Acesse sua conta GitHub em um navegador e abra Configurações > Configurações do desenvolvedor > Tokens de acesso pessoal.

Etapa 2: Gerando um Novo Token

Se você já tiver um token, ele aparecerá. Se a lista estiver vazia, Clique em Gerar novo token para obter um novo token.

Etapa 3: Personalizando e salvando o token gerado

Será apresentada a página acima, onde você pode personalizar e definir diferentes configurações para o seu token. Vá em frente e gere o token, copie e salve-o.

Agora você tem um token de acesso pessoal que pode usar para fazer login em sua conta GitHub no Xcode.

Trabalhando com um repositório GitHub remoto do Xcode

Você pode criar um repositório GitHub totalmente novo para o seu projeto no Xcode ou adicionar um repositório existente ao projeto. Vamos primeiro explorar como você pode criar um novo repositório.

Criando um novo repositório

Abra o Xcode e crie um novo projeto dentro da pasta de origem de sua preferência.

Certifique-se de verificar a opção Criar repositório Git no meu Mac.

Agora, dentro do seu projeto Xcode, navegue até a guia de controle de origem no painel de controle lateral. Dentro de Repositórios, clique com o botão direito em Remotos e selecione criar um novo repositório GitHub remoto para o seu projeto.

Especifique um nome e crie o repositório com suas configurações.

Agora você deve ver seu repositório recém-criado em seu GitHub.

Conectando-se a um repositório remoto existente

Conectar-se a um repositório existente do Xcode é tão simples quanto criar um novo.

Para fazer isso, clique com o botão direito em Remotos e selecione Adicionar controle remoto existente. Aqui você especificará um nome para o repositório e o URL do local (você pode copiá-lo do repositório remoto no GitHub). O nome fornecido será usado para criar a pasta Git local gerada em seu computador.

Clique em Adicionar para vincular o repositório Git remoto à pasta local do projeto.

Confirmando e enviando alterações de código

Com o Xcode conectado ao seu repositório GitHub remoto, agora você pode fazer alterações completas em seus arquivos de código e ter essas alterações refletidas no GitHub sem precisar fazer isso em uma janela de terminal ou usando a interface da web do GitHub.

Para testar isso, faça uma alteração simples em seu código, como adicionar uma nova Visualização de texto ao aplicativo. Vá para Source Control > Commit no painel popover do Xcode para confirmar seu código. Você também pode pressionar Option + Command + C simultaneamente.

Você verá uma interface comparando as alterações em seu código. Você será solicitado a escrever uma mensagem de commit para o commit.

Certifique-se de marcar Enviar para remoto antes de enviar e enviar o arquivo.

Criando uma solicitação pull

Você também pode gerenciar a criação e mesclagem de solicitações pull diretamente do Xcode para um repositório Git remoto. Para testar isso, faça algumas alterações no código do seu aplicativo. Você pode ver as alterações em seu código indicadas por uma barra azul à esquerda do código dentro do Xcode. Agora crie e nomeie um novo branch para o repositório.

O Xcode deve mudar você automaticamente para o novo branch. Caso isso não aconteça, você sempre pode alternar entre ramificações no painel superior. Dentro do novo branch, faça novas alterações em sua base de código e vá para Controle de origem > Criar uma solicitação pull.

A imagem abaixo demonstra uma solicitação pull feita do test_branch criado para o branch main.

Você pode nomear sua solicitação pull e fornecer uma descrição adequada. Em seguida, clique em Publicar para fazer a solicitação pull.

Para ver a solicitação e mesclá-la, abra o branch dentro do GitHub.

Você deverá ver sua solicitação pull feita dentro da interface da web. Você também pode mesclar a solicitação do Xcode mudando para o branch certo. Você precisará das permissões corretas para fazer isso.

Limitações do Xcode para controle de versão Git

Embora o Xcode forneça uma interface conveniente para lidar com o controle de versão do Git, é importante estar ciente de suas limitações:

1. O Xcode oferece recursos básicos do Git, como confirmar, enviar e extrair alterações de código. No entanto, faltam recursos Git mais avançados, como resolução interativa de conflitos. Para estratégias de ramificação complexas ou fluxos de trabalho Git avançados, será necessário usar a linha de comando ou um cliente Git dedicado.
2. A integração Git do Xcode concentra-se principalmente em desenvolvedores individuais que trabalham em um projeto. Embora suporte recursos básicos de colaboração, pode não oferecer o mesmo nível de ferramentas de colaboração que plataformas Git dedicadas como GitHub, como revisões de pull request, rastreamento de problemas ou recursos de gerenciamento de projetos. Você precisará de alguns deles se quiser contribuir com software de código aberto.
3. O Xcode é específico para desenvolvimento em macOS e iOS, o que significa que pode não ser adequado para projetos direcionados a outras plataformas ou linguagens. Se você estiver trabalhando em um projeto multiplataforma ou usando diferentes linguagens de programação, um cliente Git mais versátil ou uma ferramenta independente de plataforma pode ser uma opção melhor.
4. A integração do Xcode com o Git pressupõe um certo nível de familiaridade com os conceitos e a terminologia do Git. Se você é novo no Git, talvez precise investir algum tempo na compreensão dos fundamentos do Git para utilizar os recursos Git do Xcode de maneira eficaz.

É essencial considerar essas limitações e avaliar se elas estão alinhadas aos requisitos do seu projeto e aos fluxos de trabalho preferidos da sua equipe. No entanto, você sempre pode complementar os recursos do Xcode com outras ferramentas ou plataformas Git para ajudá-lo a superar essas limitações e otimizar seu processo de controle de versão.

Familiarizando-se com o controle de versão usando Xcode

Usar o Xcode para lidar com o controle de versão do Git pode ser uma maneira fácil e divertida de agilizar a colaboração, rastrear alterações de código e contribuir de forma eficaz para projetos hospedados no GitHub. Você pode economizar tempo, aumentar a produtividade e evitar complexidades desnecessárias. Como desenvolvedor, você sempre apreciará ter todas as ferramentas necessárias em seu IDE.