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

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

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

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

चरण 1 : ऐप वितरण परीक्षक एपीआई सक्षम करें

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

  2. फायरबेस ऐप टेस्टर्स एपीआई के तहत, सक्षम करें पर क्लिक करें।

चरण 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:) :

    तीव्र

    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 : इन-ऐप अलर्ट कॉन्फ़िगर करें

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

बुनियादी विन्यास

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

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

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

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

  3. परीक्षक को स्थापित करने के लिए नए उपलब्ध बिल्ड की जाँच करता है।

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

निम्नलिखित उदाहरण यह जांचता है कि परीक्षक ने अलर्ट सक्षम किया है या नहीं और उसके पास नए बिल्ड तक पहुंच है या नहीं, और यदि हां, तो बिल्ड इंस्टॉल करने के लिए उपलब्ध होने पर एक संवाद प्रदर्शित करता है:

तीव्र

नोट: यह उत्पाद macOS, Mac उत्प्रेरक, tvOS या watchOS लक्ष्यों पर उपलब्ध नहीं है।
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)
})

उद्देश्य सी

नोट: यह उत्पाद macOS, Mac उत्प्रेरक, tvOS या watchOS लक्ष्यों पर उपलब्ध नहीं है।
[[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 विधियां आपको अपने परीक्षक के साइन-इन अनुभव को अनुकूलित करने में अधिक लचीलापन प्रदान करती हैं, ताकि यह आपके ऐप के स्वरूप और अनुभव से बेहतर ढंग से मेल खा सके।

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

तीव्र

नोट: यह उत्पाद macOS, Mac उत्प्रेरक, tvOS या watchOS लक्ष्यों पर उपलब्ध नहीं है।
// 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
  })
}

उद्देश्य सी

नोट: यह उत्पाद macOS, Mac उत्प्रेरक, tvOS या watchOS लक्ष्यों पर उपलब्ध नहीं है।
// 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 में एक से अधिक बार साइन इन करने के लिए प्रेरित किया जा रहा है