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

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

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

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

पहला चरण: App Distribution टेस्टर एपीआई को चालू करना

Google Cloud कंसोल में अपना प्रोजेक्ट चुनें.
Firebase App Testers API में जाकर, चालू करें पर क्लिक करें.

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

ध्यान दें: Firebase, CocoaPods और Swift Package Manager, दोनों के साथ काम करता है. अगर Swift Package Manager का इस्तेमाल करके Firebase इंस्टॉल करना है, तो CocoaPods से जुड़े चरणों को छोड़ा जा सकता है. जैसे, Podfile में बदलाव करना और pod कमांड चलाना.

प्रोजेक्ट के लिए बनाई गई Podfile खोलें (या कोई नई Podfile बनाने के लिए pod init चलाएं). इसके बाद, टारगेट सेक्शन में यह लाइन जोड़ें:
```
pod 'FirebaseAppDistribution'
```
अपनी podfile की डायरेक्ट्री में, pod install चलाएं. इसके बाद, बनाई गई .xcworkspace फ़ाइल खोलें.
अपने App स्ट्रक्चर या UIApplicationDelegate में Firebase मॉड्यूल इंपोर्ट करें:
Swift
```
import FirebaseCore
import FirebaseAppDistribution
```
Objective-C
```
@import FirebaseCore;
@import FirebaseAppDistribution;
```
अपने ऐप्लिकेशन डेलीगेट के application(_:didFinishLaunchingWithOptions:) तरीके में, FirebaseApp का शेयर किया गया इंस्टेंस कॉन्फ़िगर करें:
Swift
```
// Use Firebase library to configure APIs
FirebaseApp.configure()
```
Objective-C
```
// Use Firebase library to configure APIs
[FIRApp configure];
```

अगर स्विज़लिंग की सुविधा बंद है, तो application(_:open:options:) को लागू करते समय, खोले गए सभी यूआरएल को App Distribution SDK टूल पर भेजें:

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

आखिर में, अपने ऐप्लिकेशन को फिर से कंपाइल करें.

तीसरा चरण: ऐप्लिकेशन में सूचनाएं पाने की सुविधा कॉन्फ़िगर करना

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

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

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

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

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

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

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

Swift

ध्यान दें: यह प्रॉडक्ट, macOS, Mac Catalyst, 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)
})

Objective-C

ध्यान दें: यह प्रॉडक्ट, macOS, Mac Catalyst, 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 तरीके से, टेस्टर के साइन-इन अनुभव को अपनी पसंद के मुताबिक बनाने में ज़्यादा आसानी होती है. इससे, यह आपके ऐप्लिकेशन के लुक और स्टाइल से बेहतर तरीके से मैच कर पाता है.

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

Swift

ध्यान दें: यह प्रॉडक्ट, macOS, Mac Catalyst, 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
  })
}

Objective-C

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

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

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

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

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

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