Compartilhar via


Distribuição pela App Store e TestFlight

Importante

O Visual Studio App Center foi desativado em 31 de março de 2025, com exceção dos recursos de Análise e Diagnóstico, que continuarão com suporte até 30 de junho de 2026. Saiba mais.

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

Pré-requisitos

  • A primeira versão de um aplicativo iOS deve ser publicada por meio do portal do 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 Programa de Desenvolvedores da Apple ou tenha sua ID da Apple adicionada como administrador na conta do App Store Connect de suas equipes.
  • A conta conectada deve ter permissões do Gerenciador de Aplicativos para publicar um aplicativo.

Para obter mais informações, examine o Guia de Distribuição de Aplicativos da Apple.

Configurar a conexão entre o App Center e o App Store Connect

Observação

Você pode se conectar à App Store Connect usando suas credenciais da Apple ou uma chave de API connect da App Store. É recomendável usar a Chave de API connect para melhorar a estabilidade e definir níveis de acesso para as chaves no Portal do Desenvolvedor da Apple. 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 Repositórios 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 é aberto.

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

  5. Entre com a Chave de API do App Store Connect ou com sua conta de desenvolvedor da Apple (uma atividade única) e clique em Conectar.

  6. Ao login bem-sucedido, se a conta da Apple integra várias equipes, uma opção para selecionar a equipe a ser associada às compilações estará disponível. Se a conta da Apple for membro de apenas uma única 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 com a loja de aplicativos para o aplicativo selecionado serão definidas automaticamente

    • Uma conexão da App Store chamada Produção.
    • Uma conexão TestFlight para testadores internos chamados Usuários do App Store Connect.
    • O 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 obter instruções de upload

Observação

Ao enviar o arquivo de entrega para a App Store Connect, o App Center usa 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 sua conta da Apple tiver a autenticação de dois fatores habilitada, a App Store Connect exigirá uma senha específica do aplicativo como segurança. Você pode adicionar uma senha específica de aplicativo em Configurações de Conta, Contas de Desenvolvedor >.

Dica

Somente a App Store e o TestFlight exigem uma senha específica do aplicativo. Somente as IDs da Apple com autenticação de dois fatores habilitadas podem selecionar Atualizar senha específica do aplicativo.

  1. Passe o mouse 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 de ID da 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 no diálogo.
  6. Salve clicando em Atualizar.

Publicação por meio da CLI

Aviso

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

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

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

Você pode listar seus repositórios usando o comando de lista assim:

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 Store 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, assim como faz o comando listar. Em vez de ter uma nota de versão estática, é possível usar o --release-notes-file em vez disso. Um arquivo de anotação de versão é um arquivo de texto sem formatação codificado com UTF-8.

Por que a ID da 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 carregar builds, consulte esta tabela que esclarece as permissões.

Depurando uma versão com falha

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

Falha na reautenticação

Na rara ocasião em que a reautenticação falha, você pode corrigir o problema visitando as seções de configurações da Conta e removendo sua ID da Apple. Em seguida, visite a página de conexão da loja do aplicativo e selecione sua conexão para estabelecer a conexão.