Test kullanıcılarını yeni yapılar hakkında bilgilendirin

İsteğe bağlı Firebase Uygulama Dağıtımı iOS ve Android SDK'ları, uygulamanızın yeni sürümleri yüklenebilir olduğunda test kullanıcılarınıza uygulama içi uyarılar göstermenizi sağlar. Bu kılavuz, test cihazlarınız için yeni derleme uyarıları oluşturmak ve özelleştirmek için Uygulama Dağıtımı iOS ve Android SDK'larının nasıl kullanılacağını açıklar.

Sen başlamadan önce

Henüz yapmadıysanız Firebase'i iOS projenize ekleyin .

1. Adım : App Distribution Tester API'yi etkinleştirin

1. Google Cloud Console'da projenizi seçin.

2. Firebase App Testers API altında, Etkinleştir'i tıklayın.

2. Adım : Uygulamanıza Uygulama Dağıtımı ekleyin

1. Proje için oluşturduğunuz Pod dosyasını açın (veya oluşturmak için pod init çalıştırın), ardından hedef bölümün içine aşağıdaki satırı ekleyin:

   pod 'FirebaseAppDistribution'

2. Pod dosyanızın dizininde pod install komutunu çalıştırın, ardından oluşturulan .xcworkspace dosyasını açın.

3. Firebase modülünü App yapınıza veya UIApplicationDelegate aktarın:

   Süratli

   import FirebaseCore
   import FirebaseAppDistribution
   

   Amaç-C

   @import FirebaseCore;
   @import FirebaseAppDistribution;
   

4. Uygulama temsilcinizin application(_:didFinishLaunchingWithOptions:) yönteminde bir FirebaseApp paylaşılan örneği yapılandırın:

   Süratli

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

   Amaç-C

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

5. Swizzling devre dışıysa, application(_:open:options:) uygulamanızda açılan tüm URL'leri App Distribution SDK'ye iletin:

   Süratli

   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
   }
   

   Amaç-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. Son olarak, uygulamanızı yeniden derleyin.

3. Adım : Uygulama içi uyarıları yapılandırın

App Distribution SDK, test kullanıcılarınız için uygulama içi derleme uyarıları kurmanın iki yolunu sunar: önceden oluşturulmuş uygulama güncellemesi ve test kullanıcılarına görüntülenecek oturum açma diyaloglarıyla birlikte gelen temel bir uyarı yapılandırması ve gelişmiş bir uyarı yapılandırması. kendi kullanıcı arayüzünüzü özelleştirebilirsiniz. App Distribution SDK'da yeniyseniz, önce temel uyarı yapılandırmasını kullanmanızı öneririz.

Temel yapılandırma

Henüz uyarıları etkinleştirmemiş olan test kullanıcılarına önceden oluşturulmuş bir uyarıları etkinleştir iletişim kutusunu görüntülemek için checkForUpdate kullanın ve ardından yeni bir yapının mevcut olup olmadığını kontrol edin. Yöntem çağrıldığında aşağıdaki sırayı gerçekleştirir:

1. Bir test kullanıcısından Google hesabıyla App Distribution'da oturum açmasını isteyerek uyarıları etkinleştirip etkinleştirmediğini kontrol eder.

2. Test cihazı henüz uyarıları etkinleştirmediyse, önceden oluşturulmuş bir diyalog görüntüler.

   Uyarıları etkinleştirmek, test cihazında tek seferlik bir işlemdir ve uygulamanızın güncellemelerinde devam eder. Uyarılar, uygulama kaldırılana veya signOutTester yöntemi çağrılana kadar test cihazında etkin durumda kalır. Daha fazla bilgi için yöntemin referans belgelerine ( Swift veya Objective-C ) bakın.

3. Test cihazının yüklemesi için yeni kullanılabilir yapıları kontrol eder.

Uygulamanızın herhangi bir noktasında checkForUpdate() işlevini çağırabilirsiniz. Örneğin, uygulamanızın kök görünümünün onAppear(perform:) öğesine checkForUpdate() dahil ederek, test kullanıcılarınızdan başlangıçta yeni kullanılabilir yapıları yüklemelerini isteyebilirsiniz.

Aşağıdaki örnek, test cihazının uyarıları etkinleştirip etkinleştirmediğini ve yeni bir yapıya erişimi olup olmadığını kontrol eder ve öyleyse, yapı kurulabilir olduğunda bir diyalog görüntüler:

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

[[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];
  }
}];

Gelişmiş yapılandırma

signInTester() ve isTesterSignedIn yöntemleri, test cihazınızın oturum açma deneyimini özelleştirme konusunda size daha fazla esneklik sağlar, böylece uygulamanızın görünümüne ve izlenimine daha iyi uyum sağlayabilir.

Aşağıdaki örnek, test kullanıcısının Firebase App Distribution test hesabında zaten oturum açıp açmadığını kontrol eder, böylece oturum açma kullanıcı arayüzünüzü yalnızca henüz oturum açmamış test kullanıcıları için görüntülemeyi seçebilirsiniz. Test kullanıcısı oturum açtıktan sonra şunları yapabilirsiniz: test cihazının yeni bir yapıya erişimi olup olmadığını kontrol etmek için checkForUpdate() öğesini çağırın.

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

// 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
  }];
}

signOutTester() dahil olmak üzere ek yöntemler hakkında bilgi için Swift ve Objective-C için Uygulama Dağıtımı referans belgelerine bakın.

4. Adım : Uygulamanızı oluşturun ve test edin

Son olarak, uygulamanızı oluşturun ve yapıyı Firebase konsolunu kullanarak test kullanıcılarına dağıtarak uygulamanızı test edin.

Aşağıdakiler gibi yaygın sorunlarla ilgili yardım için Uygulama Dağıtımı Sorun Giderme kılavuzunu ziyaret edin:

• Test cihazı, uygulama içi uyarıları almıyor
• Test Kullanıcısından birden fazla kez Google'da oturum açması isteniyor