'Google साइन इन' को अपने iOS या macOS ऐप्लिकेशन में इंटिग्रेट करना

इस पेज पर, iOS या macOS ऐप्लिकेशन में 'Google साइन-इन' को इंटिग्रेट करने का तरीका बताया गया है. हो सकता है कि आपको अपने ऐप्लिकेशन के लाइफ़साइकल या यूज़र इंटरफ़ेस (यूआई) मॉडल के हिसाब से, इन निर्देशों में बदलाव करना पड़े.

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

डिपेंडेंसी डाउनलोड करें, अपना Xcode प्रोजेक्ट कॉन्फ़िगर करें, और अपना क्लाइंट आईडी सेट करें.

यह देखने के लिए कि साइन-इन की सुविधा कैसे काम करती है, iOS और macOS के लिए हमारा सैंपल ऐप्लिकेशन आज़माएं.

1. पुष्टि करने के लिए रीडायरेक्ट करने वाले यूआरएल को मैनेज करना

Google से पुष्टि करने के बाद, पुष्टि करने की प्रोसेस आपके ऐप्लिकेशन पर वापस रीडायरेक्ट हो जाती है. इसमें एक यूआरएल होता है. इस यूआरएल में पुष्टि करने का जवाब शामिल होता है. इसमें उपयोगकर्ता का आईडी टोकन भी शामिल होता है. इस यूआरएल को GIDSignIn पर पास करने से, SDK टूल जवाब को पार्स कर पाता है और उपयोगकर्ता के क्रेडेंशियल आपके ऐप्लिकेशन को वापस भेज पाता है.

iOS: UIApplicationDelegate

अपने AppDelegate के application:openURL:options तरीके में, GIDSignIn के handleURL: तरीके को कॉल करें:

func application(
  _ app: UIApplication,
  open url: URL, options: [UIApplication.OpenURLOptionsKey : Any] = [:]
) -> Bool {
  var handled: Bool

  handled = GIDSignIn.sharedInstance.handle(url)
  if handled {
    return true
  }

  // Handle other custom URL types.

  // If not handled by this app, return false.
  return false
}

- (BOOL)application:(UIApplication *)app
            openURL:(NSURL *)url
            options:(NSDictionary<UIApplicationOpenURLOptionsKey,id> *)options {
  BOOL handled;

  handled = [GIDSignIn.sharedInstance handleURL:url];
  if (handled) {
    return YES;
  }

  // Handle other custom URL types.

  // If not handled by this app, return NO.
  return NO;
}

macOS: NSApplicationDelegate

1. अपने ऐप्लिकेशन के AppDelegate में, applicationDidFinishLaunching में kAEGetURL इवेंट के लिए एक हैंडलर रजिस्टर करें:

   Swift

   func applicationDidFinishLaunching(_ notification: Notification) {
     // Register for GetURL events.
     let appleEventManager = NSAppleEventManager.shared()
     appleEventManager.setEventHandler(
       self,
       andSelector: "handleGetURLEvent:replyEvent:",
       forEventClass: AEEventClass(kInternetEventClass),
       andEventID: AEEventID(kAEGetURL)
     )
   }
   

   Objective-C

   - (void)applicationDidFinishLaunching:(NSNotification *)aNotification {
     // Register for GetURL events.
     NSAppleEventManager *appleEventManager = [NSAppleEventManager sharedAppleEventManager];
     [appleEventManager setEventHandler:self
                        andSelector:@selector(handleGetURLEvent:withReplyEvent:)
                        forEventClass:kInternetEventClass
                        andEventID:kAEGetURL];
   }
   

2. इन इवेंट के लिए हैंडलर तय करें, जो GIDSignIn के handleURL को कॉल करता है:

   Swift

   func handleGetURLEvent(event: NSAppleEventDescriptor?, replyEvent: NSAppleEventDescriptor?) {
       if let urlString =
         event?.paramDescriptor(forKeyword: AEKeyword(keyDirectObject))?.stringValue{
           let url = NSURL(string: urlString)
           GIDSignIn.sharedInstance.handle(url)
       }
   }
   

   Objective-C

   - (void)handleGetURLEvent:(NSAppleEventDescriptor *)event
              withReplyEvent:(NSAppleEventDescriptor *)replyEvent {
         NSString *URLString = [[event paramDescriptorForKeyword:keyDirectObject] stringValue];
         NSURL *URL = [NSURL URLWithString:URLString];
         [GIDSignIn.sharedInstance handleURL:url];
   }
   

SwiftUI

अपने ऐप्लिकेशन की विंडो या सीन में, यूआरएल पाने और GIDSignIn के handleURL को कॉल करने के लिए एक हैंडलर रजिस्टर करें:

@main
struct MyApp: App {

  var body: some Scene {
    WindowGroup {
      ContentView()
        // ...
        .onOpenURL { url in
          GIDSignIn.sharedInstance.handle(url)
        }
    }
  }
}

2. उपयोगकर्ता के साइन-इन की स्थिति को वापस लाने की कोशिश करना

जब आपका ऐप्लिकेशन शुरू होता है, तो restorePreviousSignInWithCallback को कॉल करें. इससे, Google का इस्तेमाल करके पहले से साइन इन कर चुके उपयोगकर्ताओं के साइन-इन की स्थिति को वापस लाने की कोशिश की जा सकती है. ऐसा करने से, उपयोगकर्ताओं को हर बार आपका ऐप्लिकेशन खोलने पर साइन इन नहीं करना पड़ता. हालांकि, अगर उन्होंने साइन आउट किया है, तो उन्हें साइन इन करना होगा.

iOS ऐप्लिकेशन अक्सर ऐसा UIApplicationDelegate के application:didFinishLaunchingWithOptions: तरीके में करते हैं. वहीं, macOS ऐप्लिकेशन, NSApplicationDelegate के applicationDidFinishLaunching: तरीके में ऐसा करते हैं. उपयोगकर्ता को कौनसी व्यू दिखानी है, यह तय करने के लिए नतीजे का इस्तेमाल करें. उदाहरण के लिए:

func application(
  _ application: UIApplication,
  didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
) -> Bool {
  GIDSignIn.sharedInstance.restorePreviousSignIn { user, error in
    if error != nil || user == nil {
      // Show the app's signed-out state.
    } else {
      // Show the app's signed-in state.
    }
  }
  return true
}

- (BOOL)application:(UIApplication *)application
    didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
  [GIDSignIn.sharedInstance restorePreviousSignInWithCompletion:^(GIDGoogleUser * _Nullable user,
                                                                  NSError * _Nullable error) {
    if (error) {
      // Show the app's signed-out state.
    } else {
      // Show the app's signed-in state.
    }
  }];
  return YES;
}

SwiftUI

अगर SwiftUI का इस्तेमाल किया जा रहा है, तो अपनी शुरुआती व्यू के लिए onAppear में restorePreviousSignIn को कॉल करें:

@main
struct MyApp: App {
  var body: some Scene {
    WindowGroup {
      ContentView()
        // ...
        .onAppear {
          GIDSignIn.sharedInstance.restorePreviousSignIn { user, error in
            // Check if `user` exists; otherwise, do something with `error`
          }
        }
    }
  }
}

3. 'Google साइन-इन' बटन जोड़ना

अपने साइन-इन व्यू में, "Google से साइन इन करें" बटन जोड़ें. SwiftUI और UIKit के लिए कॉम्पोनेंट उपलब्ध हैं. ये कॉम्पोनेंट, Google के ब्रैंडिंग से जुड़े दिशा-निर्देशों के मुताबिक बटन अपने-आप जनरेट करते हैं.

4. साइन-आउट बटन जोड़ना

अपने ऐप्लिकेशन में साइन-आउट बटन जोड़ें. यह बटन, साइन इन किए हुए उपयोगकर्ताओं को दिखना चाहिए. यह बटन, GIDSignIn के signOut तरीके को कॉल करता है.

signOut को कॉल करने से, GIDSignIn में सेव की गई साइन-इन की स्थिति मिट जाती है. साथ ही, Keychain से आपके ऐप्लिकेशन के लिए उपयोगकर्ता के क्रेडेंशियल हट जाते हैं. अपने ऐप्लिकेशन की स्थिति और यूज़र इंटरफ़ेस (यूआई) को अपडेट करने की ज़िम्मेदारी आपकी है. साइन आउट करने की सुविधा सिर्फ़ आपके ऐप्लिकेशन पर लागू होती है. इससे उपयोगकर्ता, अन्य ऐप्लिकेशन या सेवाओं से साइन आउट नहीं होता. साथ ही, इससे आपके ऐप्लिकेशन को दी गई अनुमतियां भी वापस नहीं ली जाती हैं.

Button("Sign Out") {
  GIDSignIn.sharedInstance.signOut()
  // Calling signOut() may not automatically trigger UI updates.
  // Update your app's state as needed.
}

@IBAction func signOut(sender: Any) {
  GIDSignIn.sharedInstance.signOut()
}

- (IBAction)signOut:(id)sender {
  [GIDSignIn.sharedInstance signOut];
}

अगले चरण

अब उपयोगकर्ता अपने Google खातों का इस्तेमाल करके, आपके ऐप्लिकेशन में साइन इन कर सकते हैं. अब यह जानें कि:

• उपयोगकर्ताओं की Google खाते की प्रोफ़ाइल की जानकारी कैसे पाएं.
• उपयोगकर्ता के Google आईडी टोकन का इस्तेमाल करके, अपने बैकएंड से पुष्टि कैसे करें.
• उपयोगकर्ता की ओर से Google के एपीआई को कैसे कॉल करें.