Powiadamianie testerów o nowych kompilacjach

iOS Android .

Pakiety SDK Firebase App Distribution na iOS i Androida są wersji beta. Oznacza to, że ta funkcja może się zmienić niekompatybilne wstecznie. Wersja beta nie jest objęta żadną gwarancją jakości usług ani i mogą otrzymać ograniczoną pomoc lub nie mogą jej nie otrzymać.

Opcjonalne pakiety SDK Firebase App Distribution na iOS i Androida pozwalają alerty w aplikacji wysyłane testerom o nowych kompilacjach aplikacji, instalacji. Z tego przewodnika dowiesz się, jak korzystać z pakietów SDK App Distribution na iOS i Androida , aby tworzyć i dostosowywać alerty dotyczące nowych kompilacji dla testerów.

Zanim zaczniesz

Dodaj Firebase do swojego projektu iOS, chyba że masz to już za sobą.

Uwaga: jeśli w projekcie Firebase masz kilka aplikacji, upewnij się, które chcesz rozpowszechniać za pomocą Rozpowszechniania aplikacji, ma własny GoogleServices-info.plist. Więcej informacji: Obsługa wielu środowisk.

Krok 1. Włącz interfejs App Distribution Tester API

1. Wybierz swój projekt w Konsola Google Cloud.

2. W sekcji Interfejs API Firebase App Testers kliknij Włącz.

Krok 2. Dodaj Rozpowszechnianie aplikacji do swojej aplikacji

Uwaga: Firebase obsługuje zarówno CocoaPods, jak i Swift Package Manager. Jeśli zdecydujesz się zainstalować Firebase, korzystając z menedżera pakietów Swift, możesz pomiń czynności związane z CocoaPods, takie jak modyfikowanie plików podów i uruchamianie polecenia pod.

1. Otwórz plik Podfile utworzony dla projektu (lub uruchom plik pod init, aby go utworzyć jednej), a następnie dodaj ten wiersz w sekcji docelowej:

   pod 'FirebaseAppDistribution'

2. W katalogu pliku podfile uruchom polecenie pod install, a następnie otwórz plik utworzono .xcworkspace plik.

3. Zaimportuj moduł Firebase do struktury App lub UIApplicationDelegate:

   Swift

   import FirebaseCore
   import FirebaseAppDistribution
   

   Objective-C

   @import FirebaseCore;
   @import FirebaseAppDistribution;
   

4. Skonfiguruj udostępnioną instancję FirebaseApp w urzędzie certyfikacji Metoda application(_:didFinishLaunchingWithOptions:):

   Swift

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

   Objective-C

   // Use Firebase library to configure APIs
   [FIRApp configure];
   

5. Jeśli swizzling jest wyłączony, przekaż wszystkie otwarte adresy URL do pakietu SDK App Distribution w Twoja implementacja usługi application(_:open:options:):

   Swift

   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
   }
   

   Objective-C

   - (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. Na koniec ponownie skompiluj aplikację.

Krok 3. Skonfiguruj alerty w aplikacji

Pakiet App Distribution SDK umożliwia skonfigurowanie alertów kompilacji w aplikacji na 2 sposoby dla testerów: podstawowa konfiguracja alertów zawierająca gotową aktualizację aplikacji i okna logowania do wyświetlania testerom oraz zaawansowany alert co pozwala dostosować interfejs użytkownika. Śr zalecamy najpierw skorzystanie z podstawowej konfiguracji alertów, jeśli nie masz doświadczenia Pakiet SDK App Distribution.

Konfiguracja podstawowa

Użyj checkForUpdate, aby wyświetlić gotowe okno włączania alertów którzy jeszcze nie włączyli alertów, a następnie sprawdź, czy nowa kompilacja i dostępności informacji. Po wywołaniu metoda wywołuje tę sekwencję:

1. Sprawdza, czy tester włączył alerty, prosząc go o zalogowanie się Rozpowszechnianie aplikacji przy użyciu konta Google

2. Jeśli tester nie włączył jeszcze alertów, wyświetli się gotowe okno.

   Włączanie alertów jest jednorazowym procesem na urządzeniu testowym i jest aktywne przez cały okres aktualizacje aplikacji. Alerty pozostaną włączone na urządzeniu testowym do aplikacja została odinstalowana lub do czasu wywołania metody signOutTester. Zapoznaj się z dokumentacją metody (Swift, lub Objective-C) .

3. Sprawdza, czy są dostępne nowe kompilacje, które może zainstalować tester.

Działanie checkForUpdate() możesz wywołać w dowolnym momencie w aplikacji. Na przykład: może prosić testerów o zainstalowanie nowo dostępnych kompilacji podczas uruchamiania w tym checkForUpdate() w lokalizacji onAppear(perform:) w katalogu głównym aplikacji widok.

Ten przykład pozwala sprawdzić, czy tester włączył alerty i ma dostęp do nowej kompilacji, a jeśli tak, wyświetla okno dialogowe, gdy kompilacja jest dostępna do zainstalowania:

Swift

Uwaga: ta usługa nie jest dostępna na urządzeniach docelowych z systemami macOS, Mac Catalyst, tvOS i 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)
})

Objective-C

Uwaga: ta usługa nie jest dostępna na urządzeniach docelowych z systemami macOS, Mac Catalyst, tvOS i 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];
  }
}];

Konfiguracja zaawansowana

Metody signInTester() i isTesterSignedIn dają większą elastyczność dostosować sposób logowania się testera, aby do wyglądu i stylu aplikacji.

Ten przykład pozwala sprawdzić, czy tester zalogował się już na swoim konta testera w Firebase App Distribution, gdzie możesz wyświetlać swoje tylko dla testerów, którzy jeszcze się nie zalogowali. Gdy tester Po zalogowaniu się możesz wywołać funkcję checkForUpdate(), aby sprawdzić, czy tester i dostęp do nowej kompilacji.

Swift

Uwaga: ta usługa nie jest dostępna na urządzeniach docelowych z systemami macOS, Mac Catalyst, tvOS i 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
  })
}

Objective-C

Uwaga: ta usługa nie jest dostępna na urządzeniach docelowych z systemami macOS, Mac Catalyst, tvOS i 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
  }];
}

Informacje o dodatkowych metodach, w tym o signOutTester(), zapoznaj się z dokumentacją Rozpowszechniania aplikacji na temat: Szybkie i Objective-C.

Krok 4. Utwórz i przetestuj implementację

Na koniec stwórz aplikację i przetestuj jej implementację dystrybucja kompilacji za pomocą konsoli Firebase.

Uwaga: alertów w aplikacji nie można testować za pomocą symulatora. Aby przetestować użyj prawdziwego urządzenia testowego i upewnij się, że jest ono włączone, zainstaluj kompilacje z Rozpowszechniania aplikacji (aby dowiedzieć się, jak skonfigurować urządzenie testowe, zobacz Skonfiguruj do testów).

Odwiedź Przewodnik dotyczący rozwiązywania problemów z rozpowszechnianiem aplikacji aby uzyskać pomoc w rozwiązaniu typowych problemów, takich jak:

• Tester nie otrzymuje alertów w aplikacji
• Tester jest pytany o zalogowanie się w Google więcej niż raz