Join us in person and online for Firebase Summit on October 18, 2022. Learn how Firebase can help you accelerate app development, release your app with confidence, and scale with ease. Register now

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

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

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

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

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

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

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

चरण 2 : अपने ऐप में ऐप डिस्ट्रीब्यूशन जोड़ें

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

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

  3. अपनी Google ऐप आईडी को एन्कोड करें ( केवल iOS संस्करण 9 और 10 के लिए आवश्यक ):

    अपनी Google ऐप आईडी एन्कोड करें

    अपनी Info.plist file में स्निपेट शामिल करके appdistribution-<encoded-google-app-id> URL स्कीम जोड़ें (Xcode में URL स्कीम कैसे जोड़ें, इस पर निर्देशों के लिए Apple के दस्तावेज़ देखें):

    <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>
    

    फिर, कोलन (:) को डैश (-) से बदलकर अपनी Google ऐप आईडी एन्कोड करें। ध्यान दें कि आपकी Google ऐप आईडी आपकी GoogleService-Info.plist फ़ाइल में स्थित है। उदाहरण के लिए, यदि आपकी Google ऐप आईडी है:

    7:77777777777:ios:123456789

    आपकी एन्कोडेड Google ऐप आईडी है:

    7-77777777777-ios-123456789
  4. अपने App स्ट्रक्चर या UIApplicationDelegate में फायरबेस मॉड्यूल आयात करें:

    तीव्र

    import FirebaseCore
    

    उद्देश्य सी

    @import FirebaseCore;
    
  5. अपने ऐप प्रतिनिधि के application(_:didFinishLaunchingWithOptions:) विधि में FirebaseApp साझा इंस्टेंस कॉन्फ़िगर करें:

    तीव्र

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

    उद्देश्य सी

    // Use Firebase library to configure APIs
    [FIRApp configure];
    
  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 में एक से अधिक बार साइन इन करने के लिए प्रेरित किया जा रहा है