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

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

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

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

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

1. पुष्टि करने वाले दूसरे वेबलिंक को मैनेज करना

iOS: UIApplicationDelegate

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

Swift

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
}

Objective-C

- (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 में, kAEGetURL इवेंट के लिए हैंडलर रजिस्टर करें applicationDidFinishLaunching:

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

स्विफ़्टयूआई

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

Swift

@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:. इस्तेमाल की जाने वाली चीज़ें इस नतीजे की मदद से, यह तय किया जा सकता है कि उपयोगकर्ता को कौनसा व्यू दिखाना है. उदाहरण के लिए:

Swift

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
}

Objective-C

- (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 का इस्तेमाल किया जा रहा है, तो onAppear में restorePreviousSignIn पर कॉल करने की सुविधा जोड़ें आपका शुरुआती व्यू:

Swift

@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 के लिए कॉम्पोनेंट उपलब्ध हैं. ये कॉम्पोनेंट अपने-आप जनरेट होते हैं बटन पर क्लिक करें और इसके इस्तेमाल की सलाह दी जाती है.

SwiftUI का इस्तेमाल करना

1. पक्का करें कि आपने SwiftUI "Google से साइन इन करें" पर डिपेंडेंसी जोड़ी हो बटन को भी शामिल किया जा सकता है.

2. आप जिस फ़ाइल में SwiftUI बटन जोड़ना चाहते हैं, उसमें सबसे ऊपर ज़रूरी इंपोर्ट जोड़ें:

   import GoogleSignInSwift
   

3. "Google से साइन इन करें" जोड़ना 'देखें' बटन पर क्लिक करें और कार्रवाई तय करें जिसे बटन दबाने पर कॉल किया जाएगा:

   GoogleSignInButton(action: handleSignInButton)
   

4. बटन दबाने पर, साइन इन प्रोसेस ट्रिगर करें. ऐसा करने के लिए, GIDSignIn की इसमें signIn(presentingViewController:completion:) तरीका आपकी कार्रवाई:

   func handleSignInButton() {
     GIDSignIn.sharedInstance.signIn(
       withPresenting: rootViewController) { signInResult, error in
         guard let result = signInResult else {
           // Inspect error
           return
         }
         // If sign in succeeded, display the app's main content View.
       }
     )
   }
   

यह डिफ़ॉल्ट व्यू मॉडल का इस्तेमाल करता है, जो इसके लिए स्टैंडर्ड स्टाइलिंग की जानकारी देता है बटन. बटन के दिखने का तरीका कंट्रोल करने के लिए, आपको GoogleSignInButtonViewModel और उसे बटन के viewModel के रूप में सेट करें GoogleSignInButton(viewModel: yourViewModel, action: yourAction) का इस्तेमाल करके शुरुआत कर सकते हैं. यहां जाएं: GoogleSignInButtonViewModel का सोर्स कोड हमारा वीडियो देखें.

UIKit का उपयोग करना

1. "Google से साइन इन करें" जोड़ना बटन पर क्लिक करें. Google आपके यूआरएल पैरामीटर को कैसे इस्तेमाल करेगा, यह तय करने के लिए Google की मदद से बटन अपने-आप जनरेट करने के लिए GIDSignInButton क्लास ब्रैंडिंग (इसका सुझाव दिया जाता है) या पसंद के मुताबिक स्टाइलिंग के साथ अपना बटन बनाएं.

   किसी स्टोरीबोर्ड या XIB फ़ाइल में GIDSignInButton जोड़ने के लिए, व्यू जोड़ें और सेट करें GIDSignInButton के लिए इसकी कस्टम क्लास. ध्यान दें कि जब आप किसी GIDSignInButton अपना स्टोरीबोर्ड देखें, साइन इन बटन रेंडर नहीं हो रहा का इस्तेमाल करें. 'साइन-इन करें' बटन देखने के लिए ऐप्लिकेशन चलाएं.

   GIDSignInButton के लुक को पसंद के मुताबिक बनाने के लिए, colorScheme और style प्रॉपर्टी:

   GIDSignInButton स्टाइल प्रॉपर्टी
   colorScheme	kGIDSignInButtonColorSchemeLight kGIDSignInButtonColorSchemeDark
   style	kGIDSignInButtonStyleStandard kGIDSignInButtonStyleWide kGIDSignInButtonStyleIconOnly

2. बटन को अपने ViewController में उस तरीके से कनेक्ट करें जो कॉल करता हो signIn:. उदाहरण के लिए, IBAction का इस्तेमाल करें:

   Swift

   @IBAction func signIn(sender: Any) {
     GIDSignIn.sharedInstance.signIn(withPresenting: self) { signInResult, error in
       guard error == nil else { return }
   
       // If sign in succeeded, display the app's main content View.
     }
   }
   

   Objective-C

   - (IBAction)signIn:(id)sender {
     [GIDSignIn.sharedInstance
         signInWithPresentingViewController:self
                                 completion:^(GIDSignInResult * _Nullable signInResult,
                                              NSError * _Nullable error) {
       if (error) {
         return;
       }
   
       // If sign in succeeded, display the app's main content View.
     }];
   }
   

4. 'साइन-आउट करें' बटन जोड़ें

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

2. बटन को अपने ViewController में उस तरीके से कनेक्ट करें जो कॉल करता हो signOut:. उदाहरण के लिए, IBAction का इस्तेमाल करें:

   Swift

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

   Objective-C

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

अगले चरण

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

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