Partilhar via


Exportar a configuração de build do App Center para o Azure Pipelines

Importante

O Visual Studio App Center está programado para ser desativado em 31 de março de 2025. Embora você possa continuar a usar o Visual Studio App Center até que ele seja totalmente desativado, há várias alternativas recomendadas para as quais você pode considerar migrar.

Saiba mais sobre cronogramas e alternativas de suporte.

Visão geral

Com o App Center, você pode exportar todas as configurações de build do App Center para o Azure Pipelines usando o recurso de exportação de build. Você pode baixar o arquivo JSON ou YAML e importá-lo para o Azure Pipelines.

Embora a migração direta das configurações de build do App Center para o Azure Pipelines seja a opção mais fácil, ela pode não ser bem otimizada para seu aplicativo específico. Considere criar Azure Pipelines do zero para uma experiência mais otimizada (Android, Xcode, Xamarin)

Pré-requisitos

Você precisará de um projeto do Azure DevOps em que importará uma configuração de build. Você pode criar um novo projeto ou usar um existente.

(Opcional) Adicionar conexão de serviço para tarefas do App Center

Se você tiver o Teste do App Center ou a Distribuição do App Center integrado à sua configuração de build, precisará criar uma Conexão de Serviço

  1. Navegue até Configurações do Projeto do Azure DevOps –> Pipelines –> Conexões de serviço
  2. Selecione 'Nova conexão de serviço'
  3. Pesquisar por 'Visual Studio App Center' –> Avançar
  4. Crie um token de API, dê um nome à conexão e salve-a

Exportar usando o arquivo JSON

Exporte o arquivo JSON da página Build do App Center.

  1. Navegue até o portal do App Center
  2. Escolha sua aplicação
  3. Vá para a seção Compilar, escolha sua ramificação e selecione exportar Clique em Exportar
  4. Selecione 'Download' e escolha 'Baixar JSON'

Alterar o ID do projeto no arquivo JSON

Obter a ID do projeto do Azure DevOps

  1. Navegue até o URL abaixo e copie o ID do seu projeto
https://dev.azure.com/{organization}/_apis/projects?api-version=6.0

ID do projeto 2. Cole o ID do projeto no project parâmetro no arquivo JSON

Editar JSON

Criar pipeline do Azure

  1. Navegue até Azure DevOps –> Pipelines –> Importar um Pipeline e escolha o arquivo JSON baixado Pipeline de importação
  2. Na Pipeline seção, escolha Hosted (Azure Pipelines) sob o Agent Pool parâmetro
  3. Escolha o agente mais recente do macOS hospedado pela Agent Specification Microsoft no parâmetro
  4. Na Get Sources seção, adicione uma conexão ao repositório do aplicativo

(Opcional) Carregar arquivos de assinatura e atualizar senhas

Se você usar a assinatura de código em suas configurações de Build do App Center, precisará carregar os respectivos arquivos no Azure Pipelines usando o recurso Arquivo seguro. Além disso, você precisa atualizar as variáveis de senha armazenadas em pipelines

Android

  1. Carregar um arquivo de repositório de chaves em seu projeto do Azure DevOps
  2. Atualizar keystorePassword, keyAlias, keyPassworde keystoreFilename variáveis

iOS/macOS

  1. Carregar perfis de provisionamento e certificados em seu projeto do Azure DevOps
  2. Atualizar P12Password, P12Filenamee variáveis MobileProvisionFilename

Windows (UWP)

  1. Carregar um certificado em seu projeto do Azure DevOps
  2. Atualizar packageCertificatePassword, packageCertificateFileNamee packageCertificateBase64String

Se você tiver a Distribuição do App Center ou o Teste do App Center integrado, precisará modificar as respectivas tarefas

  1. Navegue até Azure DevOps –> Pipelines
  2. Selecione seus pipelines importados e selecione Editar
  3. Localizar tarefas do App Center e escolher a conexão de serviço criada anteriormente no parâmetro 'Conexão de serviço do App Center' Conexão de Serviço

Exportar usando o arquivo YAML

Exporte o arquivo YAML da página Build do App Center.

  1. Navegue até o portal do App Center
  2. Escolha sua aplicação
  3. Vá para a seção Compilar, escolha sua ramificação e selecione exportar Clique em Exportar
  4. Selecione 'Download' e escolha 'Baixar YAML'

Configurar seu repositório para funcionar com o Azure Pipelines

  1. Confirme o arquivo baixado azure-pipelines.yml no repositório do seu aplicativo
  2. Navegue até Azure DevOps –> Pipelines –> Criar Pipeline
  3. Escolha onde seu código está localizado
  4. Revise seu pipeline e selecione Run

Mais informações sobre o processo de criação do pipeline YAML podem ser encontradas aqui.

(Opcional) Carregar arquivos de assinatura e atualizar senhas

Se você usar a assinatura de código em suas configurações de Build do App Center, precisará carregar os respectivos arquivos no Azure Pipelines usando o recurso Arquivo seguro. Além disso, você precisa atualizar as variáveis de senha armazenadas em pipelines

Android

  1. Carregar um arquivo de repositório de chaves em seu projeto do Azure DevOps
  2. keyAliasCriar keystorePassword, , keyPassword, e keystoreFilename variáveis secretas no Azure Pipelines
  3. Atualize o arquivo YAML com as variáveis secretas criadas
...
  keystorePassword: $(keystorePassword)
  keyAlias: $(keyAlias)
  keyPassword: $(keyPassword)
  keystoreFilename: $(keystoreFilename)
...

iOS/macOS

  1. Carregar perfis de provisionamento e certificados em seu projeto do Azure DevOps
  2. Criar P12Password, e variáveis MobileProvisionFilename secretas P12Filenameno Azure Pipelines
  3. Atualize o arquivo YAML com as variáveis secretas criadas
...
  P12Password: $(P12Password)
  P12Filename: $(P12Filename)
  MobileProvisionFilename: $(MobileProvisionFilename)
...

Windows (UWP)

  1. Carregar um certificado em seu projeto do Azure DevOps
  2. Criar packageCertificatePassword, e variáveis packageCertificateBase64String secretas packageCertificateFileNameno Azure Pipelines
  3. Atualize o arquivo YAML com as variáveis secretas criadas
...
  packageCertificatePassword: $(packageCertificatePassword)
  packageCertificateBase64String: $(packageCertificateFileName)
  packageCertificateFileName: $(packageCertificateBase64String)
...

(Opcional) Autorizar o pipeline recém-criado a usar a conexão de serviço do App Center

Se você tiver o App Center Distribute ou Test integrado, precisará autorizar pipelines a usar a conexão de serviço.

  1. Abra o trabalho em execução no momento, você verá uma mensagem sobre permissões
  2. Selecione o trabalho em execução e Permit o acesso à conexão de serviço Permissão do