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 sürümleri kullanıma sunulduğunda test kullanıcılarınıza gönderilen uygulama içi uyarıları teşekkür ederiz. Bu kılavuzda, App Distribution iOS ve Android SDK'larının nasıl kullanılacağı açıklanmaktadır. kullanın.

Başlamadan önce

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

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

  1. Projenizi Google Cloud konsolu.

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

2. Adım: App Distribution ayarını uygulamanıza ekleyin

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

    pod 'FirebaseAppDistribution'

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

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

    Swift

    import FirebaseCore
import FirebaseAppDistribution

    Objective-C

    @import FirebaseCore;
@import FirebaseAppDistribution;

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

    Swift

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

    Objective-C

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

  5. Kaydırma devre dışı bırakılırsa açık URL'leri App Distribution SDK'sına şurada iletin: application(_:open:options:) uygulamanız:

    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'sı, test kullanıcılarınız: Önceden oluşturulmuş uygulama güncellemesiyle birlikte gelen temel bir uyarı yapılandırması test kullanıcılarına gösterilecek oturum açma iletişim kutuları ve gelişmiş uyarı ile kendi kullanıcı arayüzünüzü özelleştirmenize olanak tanıyan gelişmiş bir yapılandırma sunar. Biz kullanmaya yeni başlayanlar için ilk olarak temel uyarı yapılandırmasını App Distribution SDK'sı.

Temel yapılandırma

Önceden oluşturulmuş uyarıları etkinleştirme iletişim kutusunu görüntülemek için checkForUpdate kullanın. ve yeni bir derlemenin kullanıma sunulup sunulmadığını kontrol etmek için kullanılabilir. Bu yöntem çağrıldığında aşağıdaki sırayı uygular:

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

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

    Uyarıları etkinleştirme, test cihazında tek seferlik bir işlemdir ve uyarı süresince devam eder. güncellemelerine bakacağız. Uyarılar test cihazında etkin olarak kalır. ya da signOutTester yöntemi çağrılana kadar uygulama kaldırılır. Yöntemin referans belgelerini inceleyin (Swift veya Objective-C) konulu videomuzu izleyin.

  3. Test kullanıcısının yüklemesi için yeni kullanıma sunulan derlemeleri kontrol eder.

checkForUpdate() uygulamasını istediğiniz zaman uygulamanızda çağırabilirsiniz. Örneğin, başlatma sırasında test kullanıcılarınızdan yeni kullanıma sunulan derlemeleri yüklemelerini uygulamanızın kökünün onAppear(perform:) kısmındaki checkForUpdate() dahil görünüm.

Aşağıdaki örnek, test kullanıcısının uyarıları etkinleştirip etkinleştirmediğini kontrol eder ve yeni bir derlemeye erişimi varsa, derleme yüklenebilir:

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 size daha fazla esneklik sağlar. Böylece, test kullanıcınızın oturum açma deneyimini özelleştirebilirsiniz. görünümünü ve tarzını değiştirebilirsiniz.

Aşağıdaki örnekte, test kullanıcısının Firebase App Distribution test kullanıcısı hesabınız olduğundan, yalnızca henüz oturum açmamış test kullanıcıları için oturum açma kullanıcı arayüzü. Test kullanıcısı oturum açtıktan sonra, test kullanıcısının size ait olup olmadığını kontrol etmek için checkForUpdate() yeni derlemeye erişebilirsiniz.

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 diğer yöntemler hakkında daha fazla bilgi için, şunun App Distribution referans belgelerine bakın: Hızlı ve Targetive-C'yi seçin.

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

Son olarak da uygulamanızı derleyin ve derlemeyi dağıtma test kullanıcılarına Firebase konsolunu kullanarak.

Şurayı ziyaret edin: App Distribution Sorun giderme kılavuzu aşağıdaki gibi genel sorunlarla ilgili yardım için:

  • 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