टेस्टर को नए बिल्ड के बारे में सूचना दें

Firebase App Distribution iOS और Android SDK टूल, वैकल्पिक हैं. इनकी मदद से, आपके ऐप्लिकेशन के नए बिल्ड इंस्टॉल करने के लिए उपलब्ध होने पर, टेस्टर को इन-ऐप्लिकेशन चेतावनियां दिखाई जा सकती हैं. इस गाइड में, App Distribution iOS और Android SDK टूल का इस्तेमाल करके, टेस्टर के लिए नए बिल्ड की चेतावनियां बनाने और उन्हें पसंद के मुताबिक बनाने का तरीका बताया गया है.

शुरू करने से पहले

अगर आपने अब तक ऐसा नहीं किया है, तो अपने iOS प्रोजेक्ट में Firebase जोड़ें.

पहला चरण: App Distribution Tester API चालू करना

1. Google Cloud कंसोल में अपना प्रोजेक्ट चुनें.Google Cloud

2. Firebase App Testers API में जाकर, चालू करें पर क्लिक करें.

दूसरा चरण: अपने ऐप्लिकेशन में App Distribution जोड़ना

1. प्रोजेक्ट के लिए बनाया गया Podfile खोलें या pod init चलाकर एक Podfile बनाएं. इसके बाद, टारगेट सेक्शन में यह लाइन जोड़ें:

   pod 'FirebaseAppDistribution'

2. अपनी पॉडफ़ाइल की डायरेक्ट्री में, pod install चलाएं. इसके बाद, बनाई गई .xcworkspace फ़ाइल खोलें.

3. अपने App स्ट्रक्चर या UIApplicationDelegate में, Firebase मॉड्यूल इंपोर्ट करें:

   Swift

   import FirebaseCore
   import FirebaseAppDistribution
   

   Objective-C

   @import FirebaseCore;
   @import FirebaseAppDistribution;
   

4. अपने ऐप्लिकेशन डेलिगेट के application(_:didFinishLaunchingWithOptions:) तरीके में, FirebaseApp शेयर किए गए इंस्टेंस को कॉन्फ़िगर करें:

   Swift

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

   Objective-C

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

5. अगर स्विज़लिंग बंद है, तो App Distribution एसडीके टूल पर, 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. आखिर में, अपने ऐप्लिकेशन को फिर से कंपाइल करें.

तीसरा चरण: इन-ऐप्लिकेशन चेतावनियां कॉन्फ़िगर करना

App Distribution एसडीके टूल की मदद से, टेस्टर के लिए इन-ऐप्लिकेशन बिल्ड चेतावनियां सेट अप करने के दो तरीके उपलब्ध हैं: चेतावनी का बुनियादी कॉन्फ़िगरेशन. इसमें, ऐप्लिकेशन अपडेट और साइन-इन के पहले से बने डायलॉग शामिल होते हैं. इन्हें टेस्टर को दिखाया जा सकता है. दूसरा, चेतावनी का ऐडवांस कॉन्फ़िगरेशन. इसकी मदद से, अपना यूज़र इंटरफ़ेस (यूआई) पसंद के मुताबिक बनाया जा सकता है. हमारा सुझाव है कि अगर App Distribution एसडीके टूल का इस्तेमाल पहली बार किया जा रहा है, तो चेतावनी के बुनियादी कॉन्फ़िगरेशन का इस्तेमाल करें.

बुनियादी कॉन्फ़िगरेशन

checkForUpdate का इस्तेमाल करके, उन टेस्टर को पहले से बना, चेतावनियां चालू करने का डायलॉग दिखाएं जिन्होंने अब तक चेतावनियां चालू नहीं की हैं. इसके बाद, देखें कि कोई नया बिल्ड उपलब्ध है या नहीं. कॉल करने पर, यह तरीका इस क्रम में काम करता है:

1. यह देखता है कि किसी टेस्टर ने चेतावनियां चालू की हैं या नहीं. इसके लिए, टेस्टर को अपने Google खाते से App Distribution में साइन इन करने के लिए कहा जाता है.

2. अगर टेस्टर ने अब तक चेतावनियां चालू नहीं की हैं, तो पहले से बना एक डायलॉग दिखता है.

   टेस्ट डिवाइस पर चेतावनियां चालू करने की प्रोसेस एक बार ही की जाती है. साथ ही, यह आपके ऐप्लिकेशन के अपडेट के दौरान भी बनी रहती है. टेस्ट डिवाइस पर चेतावनियां तब तक चालू रहती हैं, जब तक ऐप्लिकेशन अनइंस्टॉल नहीं किया जाता या signOutTester तरीके को कॉल नहीं किया जाता. ज़्यादा जानकारी के लिए, इस तरीके का रेफ़रंस दस्तावेज़ (Swift या Objective-C) देखें.

3. यह देखता है कि टेस्टर के लिए, इंस्टॉल करने के लिए नए बिल्ड उपलब्ध हैं या नहीं.

अपने ऐप्लिकेशन में, checkForUpdate() को किसी भी समय कॉल किया जा सकता है. उदाहरण के लिए, अपने ऐप्लिकेशन के रूट व्यू के onAppear(perform:) में checkForUpdate() शामिल करके, अपने टेस्टर को स्टार्टअप पर, इंस्टॉल करने के लिए उपलब्ध नए बिल्ड के बारे में बताया जा सकता है.

यहां दिए गए उदाहरण में, यह देखा जाता है कि टेस्टर ने चेतावनियां चालू की हैं या नहीं. साथ ही, उसके पास नए बिल्ड का ऐक्सेस है या नहीं. अगर ऐसा है, तो बिल्ड इंस्टॉल करने के लिए उपलब्ध होने पर, एक डायलॉग दिखता है:

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

ऐडवांस कॉन्फ़िगरेशन

signInTester() और isTesterSignedIn तरीकों की मदद से, टेस्टर के साइन-इन करने के अनुभव को ज़्यादा बेहतर तरीके से पसंद के मुताबिक बनाया जा सकता है. इससे, टेस्टर का अनुभव आपके ऐप्लिकेशन के लुक और फ़ील से बेहतर तरीके से मैच कर सकता है.

यहां दिए गए उदाहरण में, यह देखा जाता है कि टेस्टर ने अपने Firebase App Distribution टेस्टर खाते में पहले से ही साइन इन किया है या नहीं. इससे, सिर्फ़ उन टेस्टर को साइन-इन करने का यूआई दिखाने का विकल्प मिलता है जिन्होंने अब तक साइन इन नहीं किया है. टेस्टर के साइन इन करने के बाद, checkForUpdate() को कॉल करके यह देखा जा सकता है कि टेस्टर के पास नए बिल्ड का ऐक्सेस है या नहीं.

// 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()सहित अन्य तरीकों के बारे में जानकारी पाने के लिए, App Distribution रेफ़रंस दस्तावेज़ देखें Swift और Objective-C के लिए.

चौथा चरण: अपने लागू किए गए कोड को बनाना और उसकी जांच करना

आखिर में, अपने ऐप्लिकेशन को बनाएं और लागू किए गए कोड की जांच बिल्ड को टेस्टर को डिस्ट्रिब्यूट करके करें. इसके लिए, Firebase कंसोल का इस्तेमाल करें.

App Distributionसमस्या हल करने की गाइड पर जाएं. इसमें, सामान्य समस्याओं को हल करने में मदद मिलती है. जैसे:

• टेस्टर को इन-ऐप्लिकेशन चेतावनियां नहीं मिल रही हैं
• टेस्टर को एक से ज़्यादा बार Google में साइन इन करने के लिए कहा जा रहा है