Registre dispositivos iOS adicionais

Se quiser distribuir compilações ad hoc do iOS usando o App Distribution, você deverá seguir este guia para registrar os dispositivos dos seus testadores. Uma compilação ad hoc é uma compilação não assinada com um perfil Enterprise. Um dispositivo só poderá instalar um build ad hoc se o identificador exclusivo de dispositivo (UDID) do dispositivo estiver incluído no perfil de provisionamento do build.

Quando um testador aceita um convite para testar seu aplicativo, o App Distribution solicita permissão para compartilhar o identificador do dispositivo do testador com você, o desenvolvedor. Antes de baixar uma versão ad hoc, o App Distribution solicita ao testador que registre seu dispositivo. Se o testador registrar seu dispositivo, o App Distribution coletará o UDID do dispositivo e notificará você sobre o UDID por e-mail.

Ao receber um email contendo um UDID, atualize seu perfil de provisionamento com o UDID e distribua um novo build aos seus testadores. Você pode exportar UDIDs manualmente usando o console do Firebase ou Firebase CLI ou pode exportar UDIDs programaticamente usando fastlane .

Exportar UDIDs manualmente

  1. Adicione os dispositivos ao seu portal de desenvolvedores Apple.
    • Opção 1: importe os UDIDs do dispositivo como um arquivo CSV.

      Na guia Testers & Groups do painel App Distribution, selecione All testers e clique em Export Apple UDIDs para baixar um arquivo CSV. Em seguida, importe o arquivo para sua conta de desenvolvedor Apple usando a opção Registrar vários dispositivos . Para saber mais, consulte Distribuindo seu aplicativo para dispositivos registrados .

      Observe que sua conta de desenvolvedor Apple só permite importar 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 do desenvolvedor Apple, registre o novo UDID especificado no e-mail que você recebeu.

  2. Adicione os dispositivos registrados ao seu perfil de provisionamento .
  3. Baixe o perfil de provisionamento e use-o para recriar seu aplicativo. Se você estiver reconstruindo apenas para atualizar os dispositivos registrados, não atualize o número ou a versão da compilação.
  4. Redistribua seu aplicativo pelo Console do Firebase ou pela CLI . Se você não alterar sua versão, número de compilação ou código do seu aplicativo, o App Distribution não criará uma nova versão e não notificará os testadores. Se você já distribuiu um build com o mesmo número e versão do build, apenas os usuários de dispositivos recém-registrados receberão e-mails de notificação.

Exportar UDIDs programaticamente usando fastlane

  1. Exporte todos os UDIDs do seu dispositivo testador como um arquivo CSV do fastlane. Por exemplo, crie e execute uma nova via 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 Apple usando a opção Registrar vários dispositivos . Para saber mais, consulte a documentação da Apple . Observe que sua conta de desenvolvedor Apple só permite importar um número limitado de dispositivos por ano.

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

  4. Baixe o perfil de provisionamento e use-o para recriar seu aplicativo. Se você estiver reconstruindo apenas para atualizar os dispositivos registrados, não atualize o número ou a versão da compilação.

  5. Redistribua seu aplicativo . Se você não alterar sua versão, número de compilação ou código do seu aplicativo, o App Distribution não criará uma nova versão e não notificará os testadores. Se você já distribuiu uma versão com o mesmo número e versão, apenas os usuários de dispositivos recém-registrados receberão e-mails de notificação.

Receba alertas

Receba 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 por meio desse mecanismo padrão, você deve ter a permissão firebase.projects.update . As seguintes funções incluem esta permissão necessária por padrão: Firebase Admin ou proprietário ou editor do projeto.

Por padrão, cada membro do projeto (que tenha as permissões necessárias para receber alertas) receberá um email quando um novo dispositivo iOS for registrado.

Ative/desative alertas para sua própria conta

Para sua própria conta, você pode ativar/desativar alertas do App Distribution sem afetar outros membros do projeto. Observe que você ainda precisa das permissões necessárias para receber alertas.

Para ativar ou desativar alertas de distribuição de aplicativos, siga estas etapas:

  1. No console do Firebase, no canto superior direito, vá para Alertas do Firebase .
  2. Então vá para Configurações e defina sua preferência de conta para alertas de distribuição de aplicativos.

Configure alertas avançados para serviços de terceiros

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

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

Para configurar recursos avançados de alertas usando o Cloud Functions para 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 para Firebase usando a CLI do Firebase.

  2. Escreva e implante uma função que capture um evento de alerta do App Distribution e lide com a carga útil do evento (por exemplo, publique as informações de alerta em uma mensagem no Discord).

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

Próximos passos