O Google tem o compromisso de promover a igualdade racial para as comunidades negras. Saiba como.

Configure alertas de nova compilação no aplicativo com o SDK do App Distribution

O SDK opcional do Firebase App Distribution permite que você exiba alertas no aplicativo para seus testadores quando novas compilações do seu aplicativo estiverem disponíveis para instalação. Este guia explica como usar o SDK do App Distribution para criar e personalizar novos alertas de construção para seus testadores.

Antes de você começar

Se você não tiver, adicione Firebase ao seu projeto iOS .

Passo 1: Ative a App Distribuição Tester API

  1. Selecione seu projeto no Google Cloud Console .

  2. Sob Firebase App Testers API, clique em Ativar.

Passo 2: Adicionar App Distribuição para seu aplicativo

  1. Abra o podfile você criou para o projeto (ou correr pod init para criar um), em seguida, adicione a seguinte linha dentro da seção alvo:

    pod 'Firebase/AppDistribution'
  2. No diretório de sua podfile, run pod install , em seguida, abrir o criado .xcworkspace arquivo.

  3. Codificar o seu Google App ID (necessário somente para iOS versões 9 e 10):

    Codifique seu ID do Google app

    Adicione o appdistribution-<encoded-google-app-id> esquema de URL, incluindo o trecho em seu Info.plist file (consulte a documentação da Apple para obter instruções sobre como adicionar o esquema de URL no Xcode):

    <key>CFBundleURLTypes</key>
    <array>
        <dict>
            <key>CFBundleTypeRole</key>
            <string>Editor</string>
            <key>CFBundleURLSchemes</key>
            <array>
                <string>appdistribution-<encoded-google-app-id></string>
            </array>
        </dict>
    </array>
    

    Em seguida, codifique seu ID do Google app substituindo os dois pontos (:) por travessões (-). Note-se que o seu Google App ID está localizado em sua GoogleService-Info.plist arquivo. Por exemplo, se o seu ID do Google app for:

    7:77777777777:ios:123456789

    Seu ID codificado do Google app é:

    7-77777777777-ios-123456789
  4. Importar o módulo Firebase em sua UIApplicationDelegate :

    Rápido

    import Firebase
    

    Objective-C

    @import Firebase;
    
  5. Configurar um FirebaseApp instância compartilhada, tipicamente em de seu aplicativo application:didFinishLaunchingWithOptions: método:

    Rápido

    // Use Firebase library to configure APIs
    FirebaseApp.configure()
    

    Objective-C

    // Use Firebase library to configure APIs
    [FIRApp configure];
    
  6. Finalmente, recompile seu aplicativo.

Etapa 3: Configurar alertas no aplicativo

O SDK do App Distribution fornece duas maneiras de configurar alertas de compilação no aplicativo para seus testadores: uma configuração de alerta básica, que vem com um diálogo de login pré-criado para exibir aos testadores, e uma configuração de alerta avançada, que permite que você personalize sua própria interface de usuário (IU). Recomendamos primeiro o uso da configuração de alerta básica se você for novo no SDK do App Distribution.

Configuração básica

Use checkForUpdate para exibir um pré-construído activar alertas de diálogo para testadores que ainda não ativados alertas e, em seguida, verificar se uma nova compilação está disponível. Quando chamado, o método executa a seguinte sequência:

  1. Verifica se um testador ativou alertas, solicitando que ele faça login no App Distribution com sua conta do Google.

  2. Se o testador ainda não ativou os alertas, exibe uma caixa de diálogo predefinida.

    Habilitar alertas é um processo único no dispositivo de teste e persiste nas atualizações do seu aplicativo. Alertas permanecer ativado no dispositivo de teste até que o aplicativo é desinstalado, ou até que o signOutTester método é chamado. Consulte a documentação do método de referência ( Swift ou Objective-C ) para mais informações.

  3. Verifica se há novas compilações disponíveis para o testador instalar.

Você pode incluir checkForUpdate em qualquer ponto do seu aplicativo. Por exemplo, você pode solicitar que seus testadores para instalar recentemente disponível constrói na inicialização, incluindo checkForUpdate na viewDidAppear do UIViewController .

O exemplo a seguir verifica se o testador ativou ou não alertas e tem acesso a uma nova compilação e, em caso afirmativo, exibe uma caixa de diálogo quando a compilação está disponível para instalação:

Rápido

AppDistribution.appDistribution().checkForUpdate(completion: { release, error in
  guard let release = release else {
    return
  }

  // Customize your alerts here.
  let title = "New Version Available"
  let message = "Version \(release.displayVersion)(\(release.buildVersion)) is available."
  let 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 should be a UIViewController.
  self.present(uialert, animated: true, completion: nil)
})

Objective-C

[[FIRAppDistribution appDistribution]
  checkForUpdateWithCompletion:^(FIRAppDistributionRelease *_Nullable release,
                                 NSError *_Nullable error) {
  if (error) {
    UIAlertController *alert = [UIAlertController alertControllerWithTitle:@"Check For Update"
message:[NSString stringWithFormat:@"Error during tester sign in! %@", error.localizedDescription]
preferredStyle:UIAlertControllerStyleAlert];

    UIAlertAction *okAction = [UIAlertAction actionWithTitle:@"Ok" style:UIAlertActionStyleDefault
handler:^(UIAlertAction *action) {}];

    [alert addAction:okAction];
    [self presentViewController:alert animated:YES completion:nil];

    return;
  }

  if (release) {
    UIAlertController *alert = [UIAlertController alertControllerWithTitle:@"New Version Available"
message:[NSString stringWithFormat:@"Version %@ (%@) is available.", release.displayVersion,
release.buildVersion] preferredStyle:UIAlertControllerStyleAlert];

    UIAlertAction *updateAction = [UIAlertAction actionWithTitle:@"Update"
style:UIAlertActionStyleDefault handler:^(UIAlertAction *action) {
      [[UIApplication sharedApplication] openURL:release.downloadURL options:@{}
completionHandler:nil];
    }];
    UIAlertAction *cancelAction = [UIAlertAction actionWithTitle:@"Cancel"
style:UIAlertActionStyleCancel handler:^(UIAlertAction *action) {}];
    [alert addAction:updateAction];
    [alert addAction:cancelAction];
    [self presentViewController:alert animated:YES completion:nil];
  }
}];

Configuração avançada

Os métodos signInTester e isTesterSignedIn dar-lhe mais flexibilidade de personalizar sign-in experiência do seu testador, para que ele possa atender melhor a aparência do seu aplicativo e sensação.

O exemplo a seguir verifica se o testador já fez login em sua conta de testador do Firebase App Distribution, para que você possa escolher exibir sua IU de login apenas para testadores que ainda não fizeram login. Depois que o testador fizer login, você poderá chamar checkForUpdate para verificar se o testador tem acesso a uma nova compilação.

Rápido

// Sign in a tester without automatically checking for update
if (!AppDistribution.appDistribution().isTesterSignedIn) {
  AppDistribution.appDistribution().signInTester (completion: { error in
    // completion block for signInTester
     if (error != nil) {
       // handle failed sign in
      return
     }
    // handle successful sign in
  })
}

// Only check for update if tester is already signed in - do not prompt
if (AppDistribution.appDistribution().isTesterSignedIn) {
  AppDistribution.appDistribution().checkForUpdate(completion: { release, error in
      // completion block for check for update
  })
}

Objective-C

// Sign in a tester without automatically checking for update
if(![[FIRAppDistribution appDistribution] isTesterSignedIn]) {
  [[FIRAppDistribution appDistribution]
    signInTesterWithCompletion:^(NSError *_Nullable error) {
      // completion block for signInTester
     if (error) {
       // handle failed sign in
       return;
     }
      // handle successful sign in
  }];
}

// only check for update if tester is already signed in - do not prompt
if([[FIRAppDistribution appDistribution] isTesterSignedIn]) {
  [[FIRAppDistribution appDistribution]
        checkForUpdateWithCompletion:^(FIRAppDistributionRelease *_Nullable release,
                                       NSError *_Nullable error) {
     // completion block for check for update
  }];
}

Para obter informações sobre os métodos adicionais, incluindo signOutTester , ver a documentação de referência Distribuição App para Swift e Objective-C .

Passo 4: construir e testar sua implementação

Finalmente, construir seu aplicativo e testar a sua implementação por distribuir a construção de testadores usando o console Firebase.

Visite a guia Solução de problemas App Distribuição para obter ajuda com problemas comuns, tais como:

  • O testador não está recebendo alertas no aplicativo
  • O testador é solicitado a fazer login no Google mais de uma vez