Partilhar via


App Store e Distribuição TestFlight

Importante

O Visual Studio App Center foi desativado em 31 de março de 2025, exceto para os recursos de Análise e Diagnóstico, que continuarão a ter suporte até 30 de junho de 2026. Mais informações.

Publique atualizações de aplicativos iOS na App Store e no TestFlight com o Fastlane através do App Center.

Pré-requisitos

  • A primeira versão de uma aplicação iOS tem de ser publicada através do portal App Store Connect.
  • Compile o aplicativo usando um perfil de provisionamento da App Store e um certificado de produção.
  • O aplicativo deve estar pronto para envio e passar as diretrizes da App Store.
  • Uma conta ativa do Apple Developer Program ou ter o seu ID Apple adicionado como administrador na conta App Store Connect das suas equipas.
  • A conta conectada deve ter permissões do Gerenciador de aplicativos para publicar um aplicativo.

Para obter mais informações, consulte o Guia de distribuição de aplicativos da Apple.

Configurar a ligação entre o App Center e o App Store Connect

Observação

Você pode se conectar ao App Store Connect usando suas credenciais da Apple ou uma chave de API do App Store Connect. Recomendamos o uso da Connect API Key para melhorar a estabilidade e definir níveis de acesso para as chaves no Apple Developer Portal. Além disso, você não precisará mais renovar sua conexão a cada 30 dias, como faria com credenciais, 2FA e senhas específicas do aplicativo.

  1. Selecione Lojas em Distribuição.

  2. No meio da página, clique no botão Conectar à Loja .

  3. Selecione o tipo de loja como App Store Connect no painel que se abre.

  4. Clique em Avançar no canto inferior direito.

  5. Inicie sessão com a sua chave de API do App Store Connect ou com a sua conta de programador Apple (uma atividade única) e clique em Ligar.

  6. Após iniciar sessão com sucesso, se a conta Apple for membro de várias equipas, estará disponível uma opção para selecionar a equipa à qual associar as compilações. Se a conta Apple for membro de apenas uma equipe, a seleção será padronizada para a única disponível.

  7. Agora, uma lista de aplicativos para a equipe selecionada estará disponível para seleção.

  8. Selecione o aplicativo a ser atualizado.

  9. As conexões da loja para o aplicativo selecionado serão configuradas automaticamente

    • Uma conexão da App Store chamada Produção.
    • Uma conexão TestFlight para testadores internos chamada App Store Connect Users.
    • Testador externo agrupa conexões com base nos grupos externos criados no console do App Store Connect.
  10. Configurar essa conexão é um processo único para um aplicativo no App Center.

Selecione o destino no menu suspenso para ver as instruções de carregamento

Observação

Ao enviar o arquivo de entrega para o App Store Connect, o App Center assume como padrão:

 add_id_info_uses_idfa: false
 export_compliance_uses_encryption: false
 export_compliance_encryption_updated: false

Adicionando autenticação de dois fatores

Se a sua conta Apple tiver a autenticação de dois fatores ativada, o App Store Connect requer uma palavra-passe específica da aplicação como segurança. Você pode adicionar uma senha específica para a aplicação em Configurações de Conta > Contas de desenvolvedor.

Sugestão

Apenas a App Store e o TestFlight exigem uma senha específica do aplicativo. Apenas os IDs Apple com autenticação de dois fatores ativada podem selecionar Atualizar palavra-passe específica da aplicação.

  1. Passe o cursor sobre um item na lista Contas .
  2. Clique nos três pontos verticais no lado direito da lista
  3. Selecione Atualizar senha específica do aplicativo.
  4. Gere uma senha específica do aplicativo usando o portal do ID Apple.
    • O nome é para você lembrar qual serviço ou aplicativo está usando a senha específica do aplicativo.
  5. Copie a senha específica do aplicativo gerada e cole-a na caixa de diálogo.
  6. Salve clicando em Atualizar.

Publicação através da CLI

Advertência

Você precisa da CLI 2.7 do App Center ou mais recente para usar esse recurso.

Use a CLI como uma maneira fácil de integrar a conexão da loja do App Center como parte de sua configuração de CI/CD, por exemplo, Jenkins ou Go CI.

Você precisará estabelecer uma conexão com a App Store antes de poder usar a CLI e compilar um binário compatível.

Você pode listar suas lojas usando o comando list da seguinte forma:

appcenter distribute stores list \
--app {app_owner}/{app_name} \
--output json

Você obterá um resultado como este:

[["Production","apple","production"],["App Store Connect Users","apple","testflight-internal"]]

E é a coluna Loja que usaremos na etapa final.

A etapa final é publicar seu aplicativo executando:

appcenter distribute stores publish \
--file /path/to/file.ipa \
--store Production \
--app {app_owner}/{app_name} \
--release-notes "Some note."

Você precisará preencher os espaços em branco, tal como o comando "list". Em vez de ter uma nota de lançamento estática, é possível usar o --release-notes-file em vez disso. Um arquivo de nota de versão é um arquivo de texto simples codificado com UTF-8.

Porque é que o ID Apple requer a função de administrador

A Apple requer pelo menos uma função de administrador para criar aplicativos e enviar versões e compilações de upload, consulte esta tabela que esclarece as permissões.

Debug de um lançamento com falha

Se a publicação de uma versão falhar, você poderá baixar os logs detalhados do Fastlane. Esses registos são encontrados na página de lançamento detalhada clicando em Status > Download Fastlane Logs.

A reautenticação falhou

Nas raras ocasiões em que a reautenticação falha, pode corrigir o problema visitando as secções Definições da conta e removendo o seu ID Apple. Em seguida, visite a página de conexão da loja do aplicativo e selecione sua conexão para estabelecer a conexão.