1. Visão geral
|
|
Este é o codelab "Como integrar o SDK do Firebase App Distribution no seu app iOS". Neste codelab, você vai adicionar o SDK do App Distribution ao seu app para mostrar alertas aos testadores quando novos builds estiverem disponíveis para download. Você vai aprender a usar uma configuração básica e uma personalizada para que seus testadores façam login e recebam atualizações. Depois, você vai enviar uma nova versão ao App Distribution e acionar um novo alerta de build diretamente no app.
Conteúdo
- Como usar o App Distribution para distribuir um app de pré-lançamento para testadores em tempo real
- Como integrar o SDK do App Distribution para iOS ao seu app
- Como alertar um testador quando houver um novo build de pré-lançamento pronto para instalação
- Como personalizar o SDK para atender às suas necessidades de teste exclusivas
Pré-requisitos
- Xcode 12 (ou mais recente)
- CocoaPods 1.9.1 (ou versão mais recente)
- Uma conta de desenvolvedor da Apple para distribuição ad hoc
- Um dispositivo físico com iOS para testes O app simulador para iOS funciona na maior parte do codelab, mas os simuladores não podem fazer o download de versões.
Como você usará este tutorial?
Como você classificaria sua experiência com a criação de apps iOS?
2. Criar projeto do console do Firebase
Adicionar novo projeto do Firebase
- Faça login no Firebase.
- No Console do Firebase, clique em Adicionar projeto e nomeie seu projeto como "Firebase Codelab".
Você não precisa ativar o Google Analytics neste projeto.
- Clique em Criar projeto.
Adicionar app ao Firebase
Siga a documentação para registrar seu app no Firebase. Use "com.google.firebase.codelab.AppDistribution.<your_name>" como o ID do pacote do iOS.
Quando solicitado, faça o download do arquivo GoogleService-Info.plist do projeto. Você precisará dele mais tarde.
3. Acessar o projeto de amostra
Faça o download do código
Comece clonando o projeto de amostra.
git clone git@github.com:googlecodelabs/firebase-appdistribution-ios.git
Se você não tiver o git instalado, faça o download do projeto de exemplo na página do GitHub ou clique neste link (link em inglês).
Fazer o download das dependências e abrir o projeto no Xcode
- Abra o Podfile no mesmo diretório
cd firebase-appdistribution-ios/start Open Podfile
- Adicione a seguinte linha ao seu podfile:
Podfile (link em inglês)
pod 'Firebase/AppDistribution'
Execute pod update no diretório do projeto e abra o projeto no Xcode.
pod install --repo-update xed .
Atualizar o identificador do pacote para corresponder ao seu app do Firebase
No menu à esquerda, clique duas vezes em AppDistributionExample. Em seguida, localize a guia Geral e altere o identificador do pacote para corresponder ao identificador do pacote do seu app do Firebase, que pode ser encontrado nas configurações do projeto. Deve ser "com.google.firebase.codelab.AppDistribution.<your_name>"
Adicionar o Firebase ao app
Localize o arquivo GoogleService-Info.plist salvo anteriormente no seu sistema de arquivos e arraste-o para a raiz do projeto Xcode. Também é possível fazer o download desse arquivo a qualquer momento na página de configurações do seu projeto.
No arquivo AppDistributionExample/AppDelegate.swift, importe o Firebase na parte de cima do arquivo.
AppDistributionExample/AppDelegate.swift (link em inglês)
import Firebase
No método didFinishLaunchingWithOptions, adicione uma chamada para configurar o Firebase.
AppDistributionExample/AppDelegate.swift (link em inglês)
FirebaseApp.configure()
4. Configurar novos alertas de build no app com o SDK do App Distribution
Nesta etapa, você vai adicionar o SDK do Firebase App Distribution ao seu app e mostrar alertas para os testadores quando novos builds estiverem disponíveis para instalação. Para isso, ative a API Firebase App Testers para seu projeto "Firebase Codelab" (no console do Google Cloud). Você precisará fazer login com a mesma conta e selecionar o projeto correto no menu suspenso na parte superior.
Configurar alertas no app
O SDK do App Distribution oferece duas maneiras de configurar alertas de build no app para os testadores: uma configuração básica de alerta, que vem com uma caixa de diálogo de login pré-criada para exibição aos testadores, e uma configuração de alerta avançada, que permite personalizar a própria interface do usuário (IU).
Vamos começar com a configuração básica de alertas. É possível usar checkForUpdate para mostrar uma caixa de diálogo de ativação de alertas pré-criada para os testadores que ainda não ativaram os alertas e verificar se um novo build está disponível. Para ativar os alertas, os testadores fazem login em uma conta que tem acesso ao app no App Distribution. Quando chamado, o método gera a seguinte sequência:
- Verifica se um testador ativou alertas. Caso contrário, uma caixa de diálogo pré-criada é exibida solicitando que o usuário faça login no App Distribution com a Conta do Google.
A ativação de alertas é um processo único no dispositivo de teste e persiste entre as atualizações do app. Os alertas permanecem ativados no dispositivo de teste até que o app seja desinstalado ou até que o método signOutTester seja chamado. Para mais informações, consulte a documentação de referência do método ( Swift ou Objective-C).
- Verifica se há builds recém-disponibilizados para a instalação do testador. Retorna um objeto release ou um erro.
Você pode incluir checkForUpdate a qualquer momento no app. Por exemplo, é possível solicitar que os testadores instalem builds recém-disponibilizados na inicialização incluindo checkForUpdate no viewgivenAppearance do UIViewController.
No arquivo AppDistributionViewController.swift, importe o Firebase na parte de cima do arquivo.
AppDistributionViewController.swift (em inglês)
import Firebase
Abra AppDistributionExample/AppDistributionViewController.swift e copie linhas no método viewDidAppear desta forma:
AppDistributionViewController.swift (em inglês)
override func viewDidAppear(_ animated: Bool) {
checkForUpdate()
}
Agora, vamos implementar o método checkForUpdate().
AppDistributionViewController.swift (em inglês)
private func checkForUpdate() {
AppDistribution.appDistribution().checkForUpdate(completion: { [self] release, error in
var uiAlert: UIAlertController
if error != nil {
uiAlert = UIAlertController(title: "Error", message: "Error Checking for update! \(error?.localizedDescription ?? "")", preferredStyle: .alert)
} else if release == nil {
uiAlert = UIAlertController(title: "Check for Update", message: "No releases found!!", preferredStyle: .alert)
uiAlert.addAction(UIAlertAction(title: "Ok", style: UIAlertAction.Style.default))
} else {
guard let release = release else { return }
let title = "New Version Available"
let message = "Version \(release.displayVersion)(\(release.buildVersion)) is available."
uiAlert = UIAlertController(title: title, message: message, preferredStyle: .alert)
uiAlert.addAction(UIAlertAction(title: "Update", style: UIAlertAction.Style.default) {
_ in
UIApplication.shared.open(release.downloadURL)
})
uiAlert.addAction(UIAlertAction(title: "Cancel", style: UIAlertAction.Style.cancel) {
_ in
})
}
self.present(uiAlert, animated: true, completion: nil)
})
}
5. Criar e convidar testadores para fazer o download do app
Nesta etapa, você vai criar seu app e testar a implementação distribuindo o build para os testadores usando o Console do Firebase.
Criar seu app
Quando estiver tudo pronto para distribuir uma versão de pré-lançamento do app para os testadores, selecione "Qualquer dispositivo iOS (arm64)" como destino da versão e "Produto->Arquivo". Depois que o arquivo for criado, crie uma distribuição assinada com o perfil de distribuição para desenvolvedores.
Quando o build é concluído, ele salva um arquivo IPA e alguns arquivos de registro na pasta especificada. Você distribui o arquivo IPA para os testadores nas etapas a seguir.
Se você tiver problemas para criar seu app, consulte os documentos de assinatura de código da Apple para ver as etapas de solução de problemas.
Distribuir seu app para os testadores
Para distribuir seu aplicativo para os testadores, faça o upload do arquivo IPA usando o Console do Firebase:
- Abra a página do App Distribution do Console do Firebase. Selecione seu projeto do Firebase quando solicitado.
- Pressione Vamos começar
- Na página "Versões", selecione o app que você quer distribuir no menu suspenso.
- Arraste o arquivo IPA do seu aplicativo ao console para fazer o upload.
- Quando o upload for concluído, especifique os grupos de testadores e os testadores individuais que devem receber o build. Adicione seu e-mail para receber o convite. Em seguida, adicione notas ao build. Consulte Gerenciar testadores para saber mais sobre a criação de grupos de testadores.
- Clique em "Distribuir" para disponibilizar o build para os testadores.
Participar como testador da versão
No Console do Firebase, agora é possível ver os testadores adicionados na versão do app.
Como você incluiu seu endereço de e-mail, vai receber um e-mail do Firebase App Distribution com um convite para testar o app. Agora você é o primeiro testador. Continue a seção abaixo para se preparar como um testador no dispositivo de teste.
Registrar o dispositivo de teste
Primeiro, é necessário registrar seu dispositivo de teste para fazer o download e testar uma versão ad hoc.
- No dispositivo de teste iOS, abra o e-mail enviado pelo Firebase App Distribution e toque no link "Vamos começar". Abra o link no Safari.
- No app da Web de testador do Firebase App Distribution que será exibido, faça login com sua Conta do Google e toque em Aceitar convite.
Agora você confere o lançamento para o qual recebeu um convite.
- Toque em Registrar dispositivo para compartilhar seu UDID com o Firebase e atualizar o perfil de provisionamento do seu app mais tarde.
- Siga as instruções e acesse as configurações para fazer o download do perfil e compartilhar seu UDID.
Agora, quando você voltar ao App Distribution, a versão estará marcada como "Dispositivo registrado":
O UDID do testador foi compartilhado com o desenvolvedor. Agora cabe ao desenvolvedor criar uma nova versão do app para o testador.
Visualizar informações do testador no console
De volta à visualização do desenvolvedor no Console do Firebase, o testador vai aparecer como "Aceito" na versão:
Você também receberá um e-mail como desenvolvedor se o dispositivo usado ainda não estiver incluído no perfil de provisionamento. Isso notificará o novo UDID que você precisa adicionar. Você também tem a opção de exportar todos os UDIDs como um arquivo de texto.
- Para exportar todos os UDIDs, abra a guia "Testadores e grupos".
- Clique em "Exportar UDIDs da Apple".
O arquivo precisa conter o UDID do seu dispositivo de teste.
Device ID Device Name Device Platform
1234567890 tester.app.distribtuion@gmail.com - iPhone SE 2nd Gen ios
Quando você receber um desses e-mails, atualize seu perfil de provisionamento com o UDID e distribua um novo build para seus testadores seguindo estas etapas:
- Adicione os dispositivos ao seu portal para desenvolvedores da Apple.
- Opção 1: importar os UDIDs do dispositivo 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". Consulte a documentação da Apple para saber mais. Sua conta de desenvolvedor da Apple pode permitir apenas a importação de um número limitado de dispositivos por ano.
- Opção 2: coletar e inserir os UDIDs por e-mail. Na página Adicionar dispositivos do portal para desenvolvedores da Apple, registre o novo UDID especificado no e-mail que você recebeu.
- Adicione os dispositivos registrados ao seu perfil de provisionamento.
- Baixe o perfil de provisionamento e use-o para recriar seu app. Se você estiver recriando apenas para atualizar os dispositivos registrados, não atualize o número da versão ou a versão.
- Redistribua seu app 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.
Faça o download da versão no dispositivo de teste
Agora a versão tem o UDID do dispositivo de teste para que o dispositivo de teste possa fazer o download e instalar o app. O App Distribution envia um e-mail aos testadores quando o UDID deles é adicionado a uma nova versão.
- No dispositivo de teste, retorne ao app da Web do testador do App Distribution usando o link no e-mail ou o ícone na tela inicial do dispositivo.
Ao navegar até o app do codelab da UDID, você vai notar que a versão está pronta para download.
- Se você estiver usando um dispositivo físico, pressione "Download" e instale e execute o app.
- Quando o app for iniciado, ele vai pedir que você ative os novos alertas de build. Selecione "Ativar".
- Em seguida, será solicitado que você faça login. Clique em "Continuar.
- Faça login com sua conta de testador.
- Você voltará ao app. Não será necessário fazer login nem aceitar alertas na próxima vez que executar o app.
Distribuir uma atualização para os testadores
- Atualize o número da versão para "2".
- Selecione "Any iOS Device (arm64)" como destino da versão e "Product->Archive". Depois que o arquivo for gerado, crie uma distribuição assinada com o perfil de distribuição para desenvolvedores.
- Quando o build é concluído, ele salva um arquivo IPA e alguns arquivos de registro na pasta especificada. Faça upload do novo IPA no Console do Firebase, adicione seu e-mail como testador novamente e distribua.
Alertas de build de teste
- Feche o app se ele estiver aberto. Reinicie o app.
- Quando o app for reiniciado, você vai receber um alerta "Nova versão disponível".
- Clique em "Atualizar" para receber a versão mais recente.
- Clique em "Instalar" na tela seguinte.
- Parabéns! Você conseguiu atualizar o app com os alertas integrados.
6. Personalizar o login do testador
Os métodos signInTester/signOutTester e isTesterSignedIn oferecem mais flexibilidade para personalizar a experiência de login do testador para que ele corresponda melhor à aparência do seu app.
O exemplo a seguir verifica se o testador já fez login na conta de testador do Firebase App Distribution. Assim, você pode mostrar a interface de login apenas para os testadores que ainda não fizeram login. Depois que o testador fizer login, você poderá chamar checkForUpdate para verificar se tem acesso a um novo build.
Vamos desativar a verificação automática de atualizações no view DidAppea comentando a chamada checkForUpdate().
AppDistributionViewController.swift (em inglês)
override func viewDidAppear(_ animated: Bool) {
// checkForUpdate()
}
Em vez disso, vamos chamar checkForUpdate() em checkForUpdateButtonClicked().
@objc func checkForUpdateButtonClicked() {
checkForUpdate()
}
Agora, vamos implementar nosso método signInOutButtonClicked() que fará login do usuário se ele estiver desconectado, ou fará logout do usuário se ele já estiver conectado.
AppDistributionViewController.swift (em inglês)
@objc func signInOutButtonClicked() {
if isTesterSignedIn() {
AppDistribution.appDistribution().signOutTester()
self.configureCheckForUpdateButton()
self.configureSignInSignOutButton()
self.configureSignInStatus()
} else {
AppDistribution.appDistribution().signInTester(completion: { error in
if error == nil {
self.configureCheckForUpdateButton()
self.configureSignInSignOutButton()
self.configureSignInStatus()
} else {
let uiAlert = UIAlertController(title: "Custom:Error", message: "Error during tester sign in! \(error?.localizedDescription ?? "")", preferredStyle: .alert)
uiAlert.addAction(UIAlertAction(title: "Ok", style: UIAlertAction.Style.default) {
_ in
})
self.present(uiAlert, animated: true, completion: nil)
}
})
}
}
Por fim, vamos implementar o método isTesterSignedIn.
AppDistributionViewController.swift (em inglês)
private func isTesterSignedIn() -> Bool {
return AppDistribution.appDistribution().isTesterSignedIn
}
Criar e testar a implementação
7. Parabéns!
Você criou o recurso "exibição de alertas no app" em um app usando o SDK do Firebase App Distribution para iOS.
O que vimos
- Firebase App Distribution
- SDK para iOS dos novos alertas do Firebase App Distribution
Próximas etapas
Saiba mais
Perguntas?
- Stack Overflow "firebase-app-distribution"
- Canal do Slack da comunidade do Firebase #app-distribution
Informar problemas