distribuição App Store e TestFlight

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 linhas do tempo e alternativas de suporte.

Publique atualizações de aplicativos iOS para o 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 App Store e um certificado de produção.
  • O aplicativo deve estar pronto para envio e passar as diretrizes de App Store.
  • Uma conta ativa do Programa para 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 ao App Store Connect usando suas credenciais da Apple ou uma chave de API do App Store Connect. É recomendável usar a Chave de API de Conexão 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 Lojas em Distribuição.

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

  3. Selecione o tipo de repositório como App Store Conectar no painel aberto.

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

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

  6. Ao entrar com êxito, se a conta da Apple for membro de várias equipes, uma opção para selecionar a equipe para associar os builds 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 da Loja para o aplicativo selecionado serão configuradas automaticamente

    • Uma conexão App Store chamada Produção.
    • Uma conexão TestFlight para testadores internos chamada App Store Conectar Usuários.
    • 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 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 Apple tiver a autenticação de dois fatores habilitada, App Store Connect exigirá uma senha específica do aplicativo como segurança. Você pode adicionar uma senha específica do aplicativo em Contas de Desenvolvedor de Configurações > de Conta.

Dica

Somente App Store e 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 loja do App Center como parte da configuração de CI/CD, por exemplo, Jenkins ou Go CI.

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

Você pode listar seus repositórios usando o comando list desta 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 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, como o comando list. Em vez de ter uma nota de versão estática, é possível usar o --release-notes-file em vez disso. Um arquivo de nota 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 de versão detalhada clicando em Status > Baixar 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 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.