Test kullanıcılarını yeni derlemelerle ilgili bilgilendirme


İsteğe bağlı Firebase App Distribution iOS ve Android SDK'ları, uygulamanızın yeni derlemeleri yüklenebilir olduğunda test kullanıcılarınıza uygulama içi uyarılar göstermenize olanak tanır. Bu kılavuzda, test kullanıcılarınız için yeni derleme uyarıları oluşturmak ve bunları özelleştirmek üzere App Distribution iOS ve Android SDK'larının nasıl kullanılacağı açıklanmaktadır.

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 konsolunda projenizi seçin.

  2. Firebase App Testers API bölümünde Etkinleştir'i tıklayın.

2. adım: Uygulamanıza App Distribution ekleyin

  1. Proje için oluşturduğunuz Podfile'ı açın (veya pod init komutunu çalıştırarak bir Podfile oluşturun), ardından hedef bölümüne aşağıdaki satırı ekleyin:

    pod 'FirebaseAppDistribution'

  2. Podfile 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 yapınıza aktarın:

    Swift

    import FirebaseCore
import FirebaseAppDistribution

    Objective-C

    @import FirebaseCore;
@import FirebaseAppDistribution;

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

    Swift

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

    Objective-C

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

  5. Swizzling devre dışıysa açılan URL'leri application(_:open:options:) uygulamanızda App Distribution SDK'sına iletin:

    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. 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ı ayarlamanın iki yolunu sunar: Test kullanıcılarına gösterilecek önceden oluşturulmuş uygulama güncelleme ve oturum açma iletişim kutularını içeren temel uyarı yapılandırması ve kendi kullanıcı arayüzünüzü özelleştirmenize olanak tanıyan gelişmiş uyarı yapılandırması. App Distribution SDK'yı yeni kullanmaya başladıysanız önce temel uyarı yapılandırmasını kullanmanızı öneririz.

Temel yapılandırma

Henüz uyarıları etkinleştirmemiş test kullanıcılarına önceden oluşturulmuş uyarıları etkinleştir iletişim kutusunu göstermek için checkForUpdate işlevini kullanın ve ardından yeni bir derlemenin kullanıma sunulup sunulmadığını kontrol edin. Yöntem çağrıldığında aşağıdaki sırayı uygular:

  1. Test kullanıcısının, Google Hesabı ile App Distribution'da oturum açmasını isteyerek uyarıları etkinleştirip etkinleştirmediğini kontrol eder.

  2. Test kullanıcısı henüz uyarıları etkinleştirmediyse önceden oluşturulmuş bir iletişim kutusu gösterilir.

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

  3. Test kullanıcısının yükleyebileceği yeni derlemeleri kontrol eder.

checkForUpdate() işlevini uygulamanızın herhangi bir noktasında çağırabilirsiniz. Örneğin, uygulamanızın kök görünümünün onAppear(perform:) bölümüne checkForUpdate() işlevini ekleyerek test kullanıcılarınızdan yeni kullanıma sunulan derlemeleri başlatma sırasında yüklemelerini isteyebilirsiniz.

Aşağıdaki örnekte, test kullanıcısının uyarıları etkinleştirip etkinleştirmediği ve yeni bir derlemeye erişimi olup olmadığı kontrol edilir. Bu koşullar karşılanıyorsa derleme yüklenmeye hazır olduğunda bir iletişim kutusu gösterilir:

Swift

Not: Bu ürün macOS, Mac Catalyst, tvOS veya watchOS hedeflerinde kullanılamaz. 
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

Not: Bu ürün macOS, Mac Catalyst, tvOS veya watchOS hedeflerinde kullanılamaz. 
[[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 kullanıcılarınızın oturum açma deneyimini özelleştirme konusunda daha fazla esneklik sunar. Böylece, test kullanıcılarınızın oturum açma deneyimi uygulamanızın görünümüne ve tarzına daha iyi uyum sağlayabilir.

Aşağıdaki örnekte, test kullanıcısının Firebase App Distribution test kullanıcısı hesabında oturum açıp açmadığı kontrol edilir. Böylece, oturum açma kullanıcı arayüzünüzü yalnızca henüz oturum açmamış test kullanıcılarına göstermeyi seçebilirsiniz. Test kullanıcısı oturum açtıktan sonra, test kullanıcısının yeni bir derlemeye erişimi olup olmadığını kontrol etmek için checkForUpdate() işlevini çağırabilirsiniz.

Swift

Not: Bu ürün macOS, Mac Catalyst, tvOS veya watchOS hedeflerinde kullanılamaz. 
// 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

Not: Bu ürün macOS, Mac Catalyst, tvOS veya watchOS hedeflerinde kullanılamaz. 
// 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 edinmek için App Distribution Swift ve Objective-C referans dokümanlarına bakın.

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

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

Aşağıdakiler gibi sık karşılaşılan sorunlarla ilgili yardım almak için App Distribution Sorun giderme kılavuzunu ziyaret edin:

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