नए बिल्ड के बारे में परीक्षकों को सूचित करें

वैकल्पिक फायरबेस ऐप वितरण आईओएस और एंड्रॉइड एसडीके आपको अपने परीक्षकों को इन-ऐप अलर्ट प्रदर्शित करने देते हैं जब आपके ऐप के नए बिल्ड इंस्टॉल करने के लिए उपलब्ध होते हैं। यह मार्गदर्शिका बताती है कि अपने परीक्षकों के लिए नए बिल्ड अलर्ट बनाने और अनुकूलित करने के लिए ऐप वितरण आईओएस और एंड्रॉइड एसडीके का उपयोग कैसे करें।

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

यदि आपने पहले से नहीं किया है, तो अपने iOS प्रोजेक्ट में Firebase जोड़ें ।

चरण 1 : ऐप वितरण परीक्षक API को सक्षम करें

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

2. Firebase ऐप परीक्षक API के अंतर्गत, सक्षम करें क्लिक करें.

चरण 2 : ऐप वितरण को अपने ऐप में जोड़ें

1. प्रोजेक्ट के लिए आपके द्वारा बनाए गए पॉडफाइल को खोलें (या एक बनाने के लिए pod init चलाएं), फिर निम्न पंक्ति को लक्ष्य अनुभाग के अंदर जोड़ें:

   pod 'FirebaseAppDistribution'

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

3. अपने App स्ट्रक्चर या UIApplicationDelegate में फायरबेस मॉड्यूल आयात करें:

   तीव्र

   import FirebaseCore
   import FirebaseAppDistribution
   

   उद्देश्य सी

   @import FirebaseCore;
   @import FirebaseAppDistribution;
   

4. अपने ऐप प्रतिनिधि के application(_:didFinishLaunchingWithOptions:) विधि में FirebaseApp साझा उदाहरण कॉन्फ़िगर करें:

   तीव्र

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

   उद्देश्य सी

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

5. यदि स्विज़लिंग अक्षम है, तो अपने application(_:open:options:) कार्यान्वयन में किसी भी खुले URL को ऐप वितरण SDK में पास करें:

   तीव्र

   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
   }
   

   उद्देश्य सी

   - (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. अंत में, अपने ऐप को दोबारा कंपाइल करें।

चरण 3 : इन-ऐप अलर्ट कॉन्फ़िगर करें

ऐप वितरण SDK आपके परीक्षकों के लिए इन-ऐप बिल्ड अलर्ट सेट करने के दो तरीके प्रदान करता है: एक बुनियादी अलर्ट कॉन्फ़िगरेशन, जो पूर्व-निर्मित ऐप अपडेट और परीक्षकों को प्रदर्शित करने के लिए साइन-इन संवादों के साथ आता है, और एक उन्नत अलर्ट कॉन्फ़िगरेशन, जो अनुमति देता है आप अपने खुद के यूजर इंटरफेस को अनुकूलित करने के लिए। यदि आप ऐप वितरण SDK में नए हैं, तो हम पहले बुनियादी अलर्ट कॉन्फ़िगरेशन का उपयोग करने की अनुशंसा करते हैं।

मूल विन्यास

उन परीक्षकों के लिए पूर्व-निर्मित सक्षम अलर्ट संवाद प्रदर्शित करने के लिए checkForUpdate उपयोग करें, जिन्होंने अभी तक अलर्ट सक्षम नहीं किए हैं, और फिर जांचें कि कोई नया बिल्ड उपलब्ध है या नहीं। जब कॉल किया जाता है, तो विधि निम्नलिखित अनुक्रम को लागू करती है:

1. जाँचता है कि क्या किसी परीक्षक ने अपने Google खाते से ऐप वितरण में साइन इन करने के लिए संकेत देकर अलर्ट सक्षम किया है।

2. यदि परीक्षक ने अभी तक अलर्ट सक्षम नहीं किया है, तो एक पूर्व-निर्मित संवाद प्रदर्शित करता है।

   अलर्ट सक्षम करना टेस्ट डिवाइस पर एक बार की जाने वाली प्रक्रिया है और आपके ऐप के सभी अपडेट में बनी रहती है। टेस्ट डिवाइस पर अलर्ट तब तक सक्षम रहता है जब तक या तो ऐप को अनइंस्टॉल नहीं किया जाता है, या जब तक signOutTester विधि को कॉल नहीं किया जाता है। अधिक जानकारी के लिए विधि का संदर्भ दस्तावेज़ ( स्विफ़्ट या ऑब्जेक्टिव-सी ) देखें।

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 ऐप वितरण परीक्षक खाते में साइन इन कर लिया है, इसलिए आप अपना साइन-इन UI केवल उन परीक्षकों के लिए प्रदर्शित करना चुन सकते हैं जिन्होंने अभी तक साइन इन नहीं किया है। परीक्षक द्वारा साइन इन करने के बाद, आप तब कर सकते हैं परीक्षक के पास नए बिल्ड तक पहुंच है या नहीं, यह जांचने के लिए 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() शामिल है, स्विफ्ट और ऑब्जेक्टिव-सी के लिए ऐप डिस्ट्रीब्यूशन रेफरेंस डॉक्यूमेंटेशन देखें।

चरण 4 : अपने कार्यान्वयन का निर्माण और परीक्षण करें

अंत में, अपना ऐप बनाएं और फायरबेस कंसोल का उपयोग करके परीक्षकों को बिल्ड वितरित करके अपने कार्यान्वयन का परीक्षण करें।

सामान्य समस्याओं में सहायता के लिए ऐप वितरण समस्या निवारण मार्गदर्शिका पर जाएँ, जैसे:

• परीक्षक को इन-ऐप अलर्ट प्राप्त नहीं हो रहे हैं
• परीक्षक को Google में एक से अधिक बार साइन इन करने के लिए कहा जा रहा है