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üklenmeye hazır olduğunda testçilerinize uygulama içi uyarılar görüntülemenize olanak tanır. Bu kılavuz, testçileriniz için yeni derleme uyarıları oluşturmak ve özelleştirmek için App Distribution iOS ve Android SDK'larının nasıl kullanılacağını açıklar.

Sen başlamadan önce

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

1. Adım : App Distribution Tester API'sini 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 bir tane oluşturmak için pod init init'i ç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. Google uygulama kimliğinizi kodlayın ( yalnızca iOS 9 ve 10 sürümleri için gereklidir ):

    Google uygulama kimliğinizi kodlayın

    Snippet'i Info.plist file appdistribution-<encoded-google-app-id> URL şemasını ekleyin (URL şemasının Xcode'a nasıl ekleneceğine ilişkin talimatlar için Apple'ın belgelerine bakın):

    <key>CFBundleURLTypes</key>
    <array>
        <dict>
            <key>CFBundleTypeRole</key>
            <string>Editor</string>
            <key>CFBundleURLSchemes</key>
            <array>
                <string>appdistribution-<encoded-google-app-id></string>
            </array>
        </dict>
    </array>
    

    Ardından, iki nokta üst üste (:) yerine tire (-) koyarak Google uygulama kimliğinizi kodlayın. Google uygulama kimliğinizin GoogleService-Info.plist dosyanızda bulunduğunu unutmayın. Örneğin, Google uygulama kimliğiniz:

    7:77777777777:ios:123456789

    Kodlanmış Google uygulama kimliğiniz:

    7-77777777777-ios-123456789
  4. Firebase modülünü App yapınıza veya UIApplicationDelegate aktarın:

    Süratli

    import FirebaseCore
    

    Amaç-C

    @import FirebaseCore;
    
  5. Genellikle App başlatıcısında veya uygulama temsilcisinin 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];
    
  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ı için uygulama içi derleme uyarıları ayarlamanın iki yolunu sunar: önceden oluşturulmuş uygulama güncellemesi ve test kullanıcılarına görüntülenmesi için oturum açma diyalogları ile birlikte gelen temel bir uyarı yapılandırması ve aşağıdakilere izin veren 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 etkinleştirme uyarıları diyaloğunu görüntülemek için checkForUpdate kullanın ve ardından yeni bir yapı olup olmadığını kontrol edin. Çağrıldığında, yöntem aşağıdaki sırayı uygular:

  1. Bir test kullanıcısının Google hesaplarıyla Uygulama Dağıtımı'nda 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ü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 başvuru 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() çağırabilirsiniz. Örneğin, uygulamanızın kök görünümünün onAppear(perform:) checkForUpdate() öğesini ekleyerek 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 derlemeye erişimi olup olmadığını kontrol eder ve eğer öyleyse, derleme kurulmaya hazır olduğunda bir diyalog görüntüler:

Süratli

Not: Bu ürün macOS, Mac Catalyst, tvOS veya watchOS hedeflerinde mevcut değildir.
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)
})

Amaç-C

Not: Bu ürün macOS, Mac Catalyst, tvOS veya watchOS hedeflerinde mevcut değildir.
[[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ınızın oturum açma deneyimini özelleştirerek size daha fazla esneklik sağlar, böylece uygulamanızın görünümü ve hissi ile daha iyi eşleşebilir.

Aşağıdaki örnek, test kullanıcısının Firebase App Distribution test kullanıcısı 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, test cihazının yeni bir yapıya erişimi olup olmadığını kontrol etmek için checkForUpdate() 'i arayın.

Süratli

Not: Bu ürün macOS, Mac Catalyst, tvOS veya watchOS hedeflerinde mevcut değildir.
// 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
  })
}

Amaç-C

Not: Bu ürün macOS, Mac Catalyst, tvOS veya watchOS hedeflerinde mevcut değildir.
// 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 App Distribution başvuru belgelerine bakın.

Adım 4 : 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 kullanıcısı uygulama içi uyarıları almıyor
  • Test kullanıcısından birden fazla kez Google'da oturum açması isteniyor