Registrar outros dispositivos iOS

Se você quiser distribuir builds para iOS ad-hoc usando o App Distribution, siga este guia para registrar os dispositivos dos testadores. Um build ad-hoc não é assinado com um perfil Enterprise. Um dispositivo só vai conseguir instalar um build ad-hoc se o identificador exclusivo do dispositivo (UDID, na sigla em inglês) estiver incluído no perfil de provisionamento do build.

Quando um testador aceita um convite para testar o app, o App Distribution solicita permissão para compartilhar o identificador do dispositivo do testador com você, o desenvolvedor. Antes de fazer o download de um build ad-hoc, o App Distribution pede que o testador registre o dispositivo. Se o testador registrar o dispositivo, o App Distribution vai coletar o UDID do dispositivo e enviar uma notificação ao seu e-mail.

Quando você receber um e-mail com um UDID, atualize seu perfil de provisionamento com o UDID e distribua um novo build para seus testadores. Além disso, também é possível exportar UDIDs manualmente usando o console ou a CLI do Firebase. Outra opção é exportar de maneira programática os UDIDs usando o fastlane.

Exportar UDIDs manualmente

  1. Adicione os dispositivos ao seu portal para desenvolvedores da Apple.
    • Opção 1: importe os UDIDs dos dispositivos como um arquivo CSV.

      Na guia Testadores e grupos do painel do App Distribution, selecione Todos os testadores e clique em Exportar UDIDs da Apple para fazer o download de um arquivo CSV. Em seguida, importe o arquivo para sua conta de desenvolvedor da Apple usando a opção Registrar vários dispositivos. Para saber mais, consulte Como distribuir seu app para dispositivos registrados.

      Sua conta de desenvolvedor da Apple permite apenas a importação de um número limitado de dispositivos por ano.

    • Opção 2: colete e insira os UDIDs por e-mail.

      Na página Adicionar dispositivos do portal para desenvolvedores da Apple, registre o novo UDID especificado no e-mail recebido.

  2. Adicione os dispositivos registrados ao seu perfil de provisionamento.
  3. Faça o download do perfil de provisionamento e use-o para recriar o app. 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 app pela CLI ou console do Firebase. Se você não mudar a versão, o número do build ou o código do app, o App Distribution não vai criar uma nova versão nem notificar os testadores. Se você já tiver distribuído um build com o mesmo número e versão, somente os usuários de dispositivos recém-registrados receberão e-mails de notificação.

Exportar UDIDs de maneira programática usando o fastlane

  1. Exporte todos os UDIDs dos dispositivos de teste como um arquivo CSV do fastlane. Por exemplo, crie e execute uma nova faixa download_udids:

    lane :download_udids do
    firebase_app_distribution_get_udids(
        app: "<your Firebase app ID>",
        output_file: "<path to output file>",
    )
end

  2. Importe os UDID(s) para sua conta de desenvolvedor da Apple usando a opção Registrar vários dispositivos. Para saber mais, consulte a documentação da Apple. Sua conta de desenvolvedor da Apple pode permitir apenas a importação de um número limitado de dispositivos por ano.

  3. Adicione os dispositivos registrados ao seu perfil de provisionamento.

  4. Faça o download do perfil de provisionamento e use-o para recriar o app. Se você estiver recriando apenas para atualizar os dispositivos registrados, não atualize o número ou a versão do build.

  5. Redistribua seu app. Se você não mudar a versão, o número do build ou o código do app, o App Distribution não vai criar uma nova versão nem notificar os testadores. Se você já tiver distribuído um build com o mesmo número e versão, somente os usuários de dispositivos recém-registrados receberão e-mails de notificação.

Receber alertas

Receber alertas padrão

Por padrão, o Firebase pode enviar alertas do App Distribution para novos registros de dispositivos iOS por e-mail.

Para receber alertas do App Distribution com esse mecanismo padrão, você precisa ter a permissão firebase.projects.update. Os papéis a seguir incluem essa permissão necessária por padrão: administrador do Firebase ou proprietário ou editor do projeto.

Por padrão, todos os membros do projeto (que tenham as permissões necessárias para receber alertas) vão ser avisados por e-mail quando um novo dispositivo iOS for registrado.

Ativar/desativar alertas para sua conta

Para sua própria conta, é possível ativar/desativar os alertas do App Distribution sem afetar outros membros do projeto. Você ainda precisa das permissões necessárias para receber alertas.

Para ativar ou desativar os alertas do App Distribution, siga estas etapas:

  1. No canto superior direito do console do Firebase, acesse alertas do Firebase.
  2. Em seguida, acesse Configurações e defina a preferência da conta para os alertas do App Distribution.

Configurar alertas avançados para serviços de terceiros

Você também pode enviar alertas do App Distribution para o canal de notificação de preferência da equipe usando o Cloud Functions for Firebase. Por exemplo, é possível criar uma função que capture um evento de alerta do registro de um novo dispositivo iOS e poste as informações do alerta em um serviço de terceiros, como Discord, Slack ou Jira.

Para automatizar totalmente a integração de novos testadores do iOS, crie uma função que adicione o UDID de um novo dispositivo iOS ao perfil de provisionamento do app, que recrie o aplicativo e o redistribua com o perfil de provisionamento atualizado.

Para configurar recursos avançados de alerta usando o Cloud Functions for Firebase, siga estas etapas:

  1. Configure o Cloud Functions para Firebase, que inclui as seguintes tarefas:

    1. Configure um ambiente de desenvolvimento para Node.js ou Python.
    2. Instale e faça login na CLI do Firebase.
    3. Inicialize o Cloud Functions for Firebase usando a CLI do Firebase.

  2. Crie e implante uma função que capture um evento de alerta do App Distribution e processe o payload do evento, por exemplo, posta as informações de alerta em uma mensagem do Discord.

Para saber mais sobre todos os eventos de alerta que você pode capturar, acesse a documentação de referência dos alertas do App Distribution.

Próximas etapas