Distribuir apps para iOS para testadores usando a Firebase CLI

É possível distribuir versões para testadores usando a CLI do Firebase. A ferramenta da CLI permite especificar testadores e notas para uma versão e distribuí-la de acordo.

Antes de começar

Adicione o Firebase ao seu projeto do iOS, caso ainda não tenha feito isso.

Caso não use outros produtos do Firebase, basta criar um projeto e registrar seu aplicativo. No entanto, caso decida usar produtos adicionais no futuro, certifique-se de concluir todas as etapas na página vinculada acima.

Etapa 1. Criar o aplicativo

Quando você estiver pronto para distribuir uma versão de pré-lançamento do seu aplicativo para os testadores, crie um arquivo de distribuição assinado. É possível usar seu processo de criação normal desde que você atenda aos seguintes requisitos:

  • Caso queira distribuir seu app para além da sua equipe de desenvolvimento, é preciso usar um perfil de distribuição Ad Hoc ou Enterprise.
  • Se o aplicativo usa o Game Center, os APNs (e, por extensão, o Cloud Messaging) ou o iCloud, verifique se o perfil de provisionamento usa um ID do app explícito, não um ID curinga.
  • Se você estiver usando um perfil de distribuição Ad Hoc, inclua os códigos de dispositivo exclusivos (UDIDs, na sigla em inglês) dos dispositivos dos testadores. À medida que novos testadores do iOS se inscreverem no seu programa de testes, será necessário atualizar o perfil de provisionamento com os UDIDs dos dispositivos deles. Consulte Registrar outros dispositivos para testadores.
  • Se você fez alterações no código desde a última versão (ou seja, não está criando uma nova apenas para atualizar os dispositivos registrados), atualize o número da versão visível ao usuário (Versão) e o número exclusivo da versão (Versão) do destino dela.

Quando a versão é concluída, ela salva um arquivo IPA e alguns arquivos de log na pasta especificada. Você distribui o arquivo IPA para os testadores nas etapas a seguir.

Etapa 2. Distribuir seu aplicativo para os testadores

Para distribuir seu aplicativo para os testadores, faça upload do arquivo IPA usando a CLI do Firebase:

  1. Instale ou atualize para a versão mais recente da CLI do Firebase. Recomendamos que você faça o download do binário autônomo para a CLI específica do seu SO. Certifique-se de fazer login e testar para ver se consegue acessar seus projetos.
  2. Na página "App Distribution" do Console do Firebase, selecione o aplicativo que você quer distribuir e clique em Primeiros passos.
  3. Execute o comando appdistribution:distribute para fazer upload do aplicativo e distribuí-lo aos testadores. Use os seguintes parâmetros para configurar a distribuição:

    Opções appdistribution:distribute
    --app

    Obrigatório: ID do app do Firebase do seu aplicativo. Encontre o ID do aplicativo no Console do Firebase na página "Configurações gerais".

    
    --app 1:1234567890:ios:0a1b2c3d4e5f67890
    --token

    Um token de atualização que é impresso quando você autentica o ambiente de CI com a CLI do Firebase. Para mais informações, consulte Usar a CLI com sistemas de CI .

    
    --token "$FIREBASE_TOKEN"
    --release-notes
    --release-notes-file

    Notas para esta versão.

    É possível especificar as notas da versão diretamente:

    
    --release-notes "Text of release notes"

    Como opção, especifique o caminho para um arquivo de texto simples:

    
    --release-notes-file "/path/to/release-notes.txt"
    --testers
    --testers-file

    Os endereços de e-mail dos testadores que você quer convidar.

    É possível especificar os testadores como uma lista separada por vírgulas de endereços de e-mail:

    
    --testers "ali@example.com, bri@example.com, cal@example.com"

    Como opção, especifique o caminho para um arquivo de texto simples que contém uma lista separada por vírgulas de endereços de e-mail:

    
    --testers-file "/path/to/testers.txt"
    --groups
    --groups-file

    Os grupos de testadores que você quer convidar (consulte Gerenciar testadores). Grupos são especificados usando aliases de grupo, que podem ser encontrados no Console do Firebase.

    É possível especificar os grupos como uma lista separada por vírgulas:

    
    --groups "qa-team, trusted-testers"

    Também é possível especificar o caminho para um arquivo de texto simples contendo uma lista separada por vírgulas de nomes de grupos:

    
    --groups-file "/path/to/groups.txt"
    --debug

    Uma sinalização que você pode incluir para exibir a saída de registro detalhado.

    Exemplo:

    firebase appdistribution:distribute test.ipa  \
        --app 1:1234567890:ios:0a1b2c3d4e5f67890  \
        --release-notes "Bug fixes and improvements" --testers-file testers.txt
    

Depois de distribuir o build, ele fica disponível no painel App Distribution do Console do Firebase por 150 dias (cinco meses). Quando faltarem 30 dias para o vencimento do build, o aviso de expiração aparecerá no console e na lista de builds do testador no dispositivo de teste.

Os testadores que não foram convidados para testar o app recebem convites por e-mail para dar os primeiros passos, e os testadores atuais recebem notificações por e-mail informando que um novo build está pronto para ser testado (leia o guia de configuração do testador para ver instruções sobre como instalar o app de teste). É possível monitorar o status de cada testador, por exemplo, se ele aceitou o convite e se fez o download do aplicativo no Console do Firebase.

Etapa 3. Registrar outros dispositivos para testadores

Quando os testadores aceitam um convite para testar uma versão não assinada com um perfil Enterprise, solicita-se a eles a permissão para compartilhar o UDID do dispositivo deles com você. Se eles concordarem, o App Distribution coletará o UDID do dispositivo e notificará você por e-mail sobre o UDID recém-compartilhado.

Quando receber um desses e-mails, atualize o UUID em seu perfil de provisionamento e distribua um novo build para seus testadores seguindo estas etapas:

  1. Na página Adicionar dispositivos do portal Apple Developer, registre o novo UDID especificado no e-mail recebido.
  2. Adicione o dispositivo registrado ao seu perfil de provisionamento na página Perfis de provisionamento do iOS (em inglês).
  3. Faça o download do perfil de provisionamento e use-o para recriar o aplicativo. Se você estiver criando o novo build apenas para atualizar os dispositivos registrados, não atualize o número ou a versão do build.
  4. Redistribua seu aplicativo no Console do Firebase ou na CLI. Se você já tiver distribuído um build com o mesmo número e a mesma versão, somente os usuários de dispositivos recém-registrados receberão e-mails de notificação.