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


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

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

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

पहला चरण: App Distribution Tester API को चालू करें

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

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

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

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

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

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

    Swift

    import FirebaseCore
    import FirebaseAppDistribution
    

    Objective-C

    @import FirebaseCore;
    @import FirebaseAppDistribution;
    
  4. अपने ऐप्लिकेशन प्रतिनिधि में FirebaseApp शेयर किए गए इंस्टेंस को कॉन्फ़िगर करें application(_:didFinishLaunchingWithOptions:) तरीका:

    Swift

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

    Objective-C

    // Use Firebase library to configure APIs
    [FIRApp configure];
    
  5. अगर स्विज़लिंग की सुविधा बंद है, तो खुले हुए किसी भी यूआरएल को App Distribution SDK टूल में पास करें 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 SDK टूल की मदद से, इन-ऐप्लिकेशन बिल्ड की सूचनाएं सेट अप की जा सकती हैं. आपका टेस्टर: एक बुनियादी सूचना कॉन्फ़िगरेशन, जो पहले से बने ऐप्लिकेशन के अपडेट के साथ मिलता है लोगों को दिखाने के लिए, साइन-इन करने की सुविधा वाले डायलॉग बॉक्स और बेहतर सूचना कॉन्फ़िगरेशन की मदद से, अपने यूज़र इंटरफ़ेस को ज़रूरत के मुताबिक बनाया जा सकता है. बुध अगर आप इसके लिए नए हैं, तो सबसे पहले बेसिक अलर्ट कॉन्फ़िगरेशन का इस्तेमाल करने की सलाह दें App Distribution SDK टूल.

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

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

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

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

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

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

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

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

आखिर में, अपना ऐप्लिकेशन बनाएं और कॉन्टेंट को दुनिया भर के लोगों के लिए जो Firebase कंसोल का इस्तेमाल करके, टेस्टर के लिए उपलब्ध हैं.

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

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