Catch up on everything announced at Firebase Summit, and learn how Firebase can help you accelerate app development and run your app with confidence. Learn More

Notificar a los probadores sobre nuevas compilaciones

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Los SDK opcionales de Firebase App Distribution para iOS y Android le permiten mostrar alertas en la aplicación a sus evaluadores cuando hay nuevas compilaciones de su aplicación disponibles para instalar. Esta guía explica cómo usar los SDK de iOS y Android de App Distribution para crear y personalizar nuevas alertas de compilación para sus evaluadores.

Antes de que empieces

Si aún no lo ha hecho, agregue Firebase a su proyecto de iOS .

Paso 1 : habilite la API del probador de distribución de aplicaciones

  1. Seleccione su proyecto en Google Cloud Console .

  2. En Firebase App Testers API , haga clic en Habilitar .

Paso 2 : agregue la distribución de aplicaciones a su aplicación

  1. Abra el Podfile que creó para el proyecto (o ejecute pod init para crear uno), luego agregue la siguiente línea dentro de la sección de destino:

    pod 'FirebaseAppDistribution'
  2. En el directorio de su podfile, ejecute pod install , luego abra el archivo .xcworkspace creado.

  3. Importe el módulo Firebase en su estructura de App o UIApplicationDelegate :

    Rápido

    import FirebaseCore
    import FirebaseAppDistribution
    

    C objetivo

    @import FirebaseCore;
    @import FirebaseAppDistribution;
    
  4. Configure una instancia compartida de FirebaseApp en el método application(_:didFinishLaunchingWithOptions:) del delegado de su aplicación:

    Rápido

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

    C objetivo

    // Use Firebase library to configure APIs
    [FIRApp configure];
    
  5. Si el swizzling está deshabilitado, pase cualquier URL abierta al SDK de distribución de aplicaciones en su implementación de application(_:open:options:) :

    Rápido

    func application(_ app: UIApplication, 
                     open url: URL,
                     options: [UIApplication.OpenURLOptionsKey : Any] = [:]) -> Bool {
       if AppDistribution.appDistribution().application(application, open: url, options: options) {
          return true
       }
    
       // Handle other non-Firebase URLs here.
    
       return false
    }
    

    C objetivo

    - (BOOL)application:(UIApplication *)app 
                openURL:(NSURL *)url 
                options:(NSDictionary<UIApplicationOpenURLOptionsKey, id> *)options {
       if ([[FIRAppDistribution appDistribution] application:app openURL:url options:options]) {
          return YES;
       }
    
       // Handle other non-Firebase URLs here.
    
       return NO;
    }
    
  6. Finalmente, vuelva a compilar su aplicación.

Paso 3 : configurar alertas en la aplicación

El SDK de distribución de aplicaciones proporciona dos formas de configurar alertas de compilación en la aplicación para sus evaluadores: una configuración de alerta básica, que viene con una actualización de la aplicación prediseñada y diálogos de inicio de sesión para mostrar a los evaluadores, y una configuración de alerta avanzada, que permite personalizar su propia interfaz de usuario. Recomendamos usar primero la configuración de alerta básica si es nuevo en el SDK de distribución de aplicaciones.

Configuracion basica

Use checkForUpdate para mostrar un diálogo de alertas de habilitación preconstruido para los probadores que aún no han habilitado alertas y luego verifique si hay una nueva compilación disponible. Cuando se llama, el método ejecuta la siguiente secuencia:

  1. Comprueba si un evaluador ha habilitado las alertas al solicitarle que inicie sesión en Distribución de aplicaciones con su cuenta de Google.

  2. Si el evaluador aún no ha habilitado las alertas, muestra un diálogo prediseñado.

    Habilitar alertas es un proceso que se realiza una sola vez en el dispositivo de prueba y persiste entre las actualizaciones de su aplicación. Las alertas permanecen habilitadas en el dispositivo de prueba hasta que se desinstala la aplicación o hasta que se llama al método signOutTester . Consulte la documentación de referencia del método ( Swift u Objective-C ) para obtener más información.

  3. Comprueba si hay compilaciones disponibles recientemente para que las instale el probador.

Puede invocar checkForUpdate() en cualquier punto de su aplicación. Por ejemplo, puede solicitar a sus evaluadores que instalen compilaciones disponibles recientemente al inicio al incluir checkForUpdate() en onAppear(perform:) de la vista raíz de su aplicación.

El siguiente ejemplo verifica si el probador ha habilitado o no las alertas y tiene acceso a una nueva compilación y, de ser así, muestra un diálogo cuando la compilación está disponible para instalar:

Rápido

Nota: este producto no está disponible en objetivos macOS, Mac Catalyst, tvOS o watchOS.
AppDistribution.appDistribution().checkForUpdate(completion: { release, error in
  if error != nil {
      // Handle error
      return
  }

  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)
})

C objetivo

Nota: este producto no está disponible en objetivos macOS, Mac Catalyst, tvOS o watchOS.
[[FIRAppDistribution appDistribution]
  checkForUpdateWithCompletion:^(FIRAppDistributionRelease *_Nullable release,
                                 NSError *_Nullable error) {
  if (error) {
    // Handle error
    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];
  }
}];

Configuración avanzada

Los métodos signInTester() e isTesterSignedIn le brindan más flexibilidad al personalizar la experiencia de inicio de sesión de su evaluador, para que pueda adaptarse mejor a la apariencia de su aplicación.

El siguiente ejemplo verifica si el evaluador ya inició sesión en su cuenta de evaluador de Firebase App Distribution, por lo que puede optar por mostrar su IU de inicio de sesión solo para los evaluadores que aún no han iniciado sesión. Una vez que el evaluador haya iniciado sesión, puede llame a checkForUpdate() para verificar si el probador tiene acceso a una nueva compilación.

Rápido

Nota: este producto no está disponible en objetivos macOS, Mac Catalyst, tvOS o watchOS.
// 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
  })
}

C objetivo

Nota: este producto no está disponible en objetivos macOS, Mac Catalyst, tvOS o watchOS.
// 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 obtener información sobre métodos adicionales, incluido signOutTester() , consulte la documentación de referencia de distribución de aplicaciones para Swift y Objective-C .

Paso 4 : Cree y pruebe su implementación

Finalmente, cree su aplicación y pruebe su implementación distribuyendo la compilación a los evaluadores mediante la consola de Firebase.

Visite la guía de solución de problemas de distribución de aplicaciones para obtener ayuda con problemas comunes, como:

  • Tester no recibe alertas en la aplicación
  • Se le solicita al evaluador que inicie sesión en Google más de una vez