Compartilhe seu projeto Xcode com o Git e o Azure Repos - Azure Repos

Serviços de DevOps do Azure | Azure DevOps Server | Azure DevOps Server 2022

Este guia mostra como compartilhar seus projetos Xcode usando o Azure Repos.

Pré-requisitos

Categoria	Requerimentos
Acesso ao projeto	Membro de um projeto .
Permissões	- Ver código em projetos privados: Acesso pelo menos Básico. - Clone ou contribua para o código em projetos privados: Membro do grupo de segurança Contributors ou permissões correspondentes no projeto. - Definir permissões de ramo ou repositório: Gerir permissões para o ramo ou repositório. - Alterar ramificação padrão: Editar políticas e permissões para o repositório. - Importar um repositório: Membro do grupo de segurança Administradores de Projeto ou com permissão de Criar repositório ao nível do projeto Git definida como Permitir. Para obter mais informações, consulte Definir permissões do repositório Git.
Serviços	Repos ativado.
Ferramentas	Opcional. Utilize os comandos az repos: Azure DevOps CLI.

Observação

Em projetos públicos, os usuários com acesso Partes Interessadas têm acesso total aos repositórios do Azure, incluindo visualização, clonagem e contribuição para o código.

Categoria	Requerimentos
Acesso ao projeto	Membro de um projeto .
Permissões	- Visualização de código: Pelo menos acesso básico. - Clone ou contribua para o código: Membro do grupo de segurança Contributors ou com permissões correspondentes no projeto.
Serviços	Repos ativado.

Métodos de autenticação

Escolha o método de autenticação que melhor se adapta ao seu fluxo de trabalho:

Método	Melhor para	Complexidade da configuração	Segurança
chaves SSH	Programadores individuais, utilização a longo prazo	Médio (configuração única)	Alto
Microsoft Entra ID Tokens	Ambientes empresariais, acesso temporário	Médio	Muito alto
Tokens de acesso pessoal	Cenários específicos, automação	Baixo	Médio

Sugestão

Para a maioria dos desenvolvedores, as chaves SSH fornecem o melhor equilíbrio de segurança e usabilidade com o Xcode. Configure-os uma vez e eles funcionam perfeitamente.

Configure seu projeto Xcode com o Git

Crie um repositório Git local para seu código para gerenciar seu projeto no controle de versão.

Escolha a opção que corresponde à sua situação:

Novos projetos - Criando um novo projeto Xcode
Projetos existentes - Adicionando Git a um projeto existente

Observação

Se o seu projeto já estiver em um repositório Git local, pule para Criar um novo repositório Git no Azure Repos.

Novos projetos

Crie um repositório Git local ao criar um novo projeto. Escolha Create Git repository on My Mac ao criar um novo projeto.

Projetos existentes

Crie um repositório Git local para seus projetos existentes que não estão no controle de versão indo para Controle do código-fonte, Criar cópia de trabalho... . Selecione os projetos a serem adicionados ao repositório Git local e selecione Criar. O Xcode cria um repositório Git para seu código e adiciona uma confirmação com seus arquivos de projeto.

Criar um novo repositório Git no Azure Repos

Crie um novo repositório Git no Azure Repos para seu projeto Xcode.

Observação

Se você já criou um repositório para seu projeto Xcode no Azure DevOps, pule para Conectar e envie seu projeto.

Em sua organização do Azure DevOps, vá para seu projeto e selecione o ao lado do nome atual do repositório Git. Selecione Novo repositório.
Insira um nome para seu novo repositório Git e selecione Criar.
Copie o URL do clone do seu novo repositório. Escolha o formato de URL com base no seu método de autenticação:
- SSH: Use o URL de clone SSH (se tiver configurado chaves SSH)
- HTTPS: Utilize o URL de clonagem HTTPS (para 'tokens')
Sugestão

Escolha o seu método de autenticação:
- Chaves SSH (recomendadas para simplificar): Configure uma vez e funcione perfeitamente com o Xcode. Consulte Usar chaves SSH.
- Tokens de ID do Microsoft Entra (recomendados para empresas): autenticação moderna e segura. Consulte Autenticação do Microsoft Entra ID.
- Personal Access Tokens: Método alternativo para cenários específicos. Consulte Tokens de acesso pessoal.
Ao usar SSH, use a URL de clone SSH ao configurar o controle remoto.

Conecte-se e impulsione seu projeto

Agora conecte seu projeto Xcode local ao Azure Repos e envie seu código.

No Xcode, vá para Controle do código-fonte e selecione [Nome do projeto] -- principal e, em seguida, Configurar.
Selecione Remotes, selecione o ícone e escolha Add Remote.
No campo Endereço , cole a URL de clone do Git copiada anteriormente. Selecione Adicionar controle remoto e, em seguida, Concluído para criar o origin controle remoto.
Vá para Controle de Código-Fonte>Push, digite o nome da ramificação em origin para fazer o push (geralmente main) e selecione Push.
Se as credenciais forem solicitadas, escolha o método de autenticação:

Importante

Recomendamos o uso de chaves SSH ou tokens de ID do Microsoft Entra para autenticação segura. Use tokens de acesso pessoal apenas quando outros métodos não estiverem disponíveis.

Opção 1: Autenticação SSH (Recomendado)

Se você configurou chaves SSH, o Xcode autentica automaticamente. Não são necessárias outras credenciais.

Opção 2: Microsoft Entra ID Token

Para Nome de usuário: insira seu nome de usuário do Azure DevOps. Para Password: Utilize um token de acesso do Microsoft Entra ID.
```
# Get token using Azure CLI
az account get-access-token --resource 499b84ac-1321-427f-aa17-267ca6975798 --query "accessToken" --output tsv
```
Opção 3: Token de Acesso Pessoal (alternativa)

Para Nome de usuário: insira seu nome de usuário do Azure DevOps. Para palavra-passe: crie um token de acesso pessoal com escopo Codigo (leitura e gravação).

Selecione OK para concluir a autenticação.