iOS और macOS के लिए, 'Google साइन इन' का इस्तेमाल शुरू करना

अपने iOS या macOS ऐप्लिकेशन को Google Sign-In के कॉम्पोनेंट के साथ इंटिग्रेट करने से पहले, आपको डिपेंडेंसी डाउनलोड करनी होंगी और अपने Xcode प्रोजेक्ट को कॉन्फ़िगर करना होगा. इस पेज पर दिया गया तरीका, ठीक यही काम करता है. इसके बाद, अगले चरणों में, अपने ऐप्लिकेशन में 'Google साइन इन' की सुविधाओं को इंटिग्रेट करने का तरीका बताया गया है.

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

Xcode का मौजूदा वर्शन इंस्टॉल करें.

अपने प्रोजेक्ट में Google Sign-In की डिपेंडेंसी इंस्टॉल करना

CocoaPods

1. अगर आपने CocoaPods पहले से इंस्टॉल नहीं किया है, तो CocoaPods शुरू करने के लिए दी गई गाइड में दिया गया तरीका अपनाएं.

2. टर्मिनल विंडो खोलें और अपने ऐप्लिकेशन के Xcode प्रोजेक्ट की जगह पर जाएं.

3. अगर आपने अपने ऐप्लिकेशन के लिए पहले से कोई Podfile नहीं बनाई है, तो अब एक बनाएं:

   pod init

4. अपने ऐप्लिकेशन के लिए बनाई गई Podfile खोलें और नीचे दी गई जानकारी जोड़ें:

   pod 'GoogleSignIn'

5. अगर SwiftUI का इस्तेमाल किया जा रहा है, तो "Google से साइन इन करें" बटन के लिए पॉड एक्सटेंशन भी जोड़ें:

   pod 'GoogleSignInSwiftSupport'

6. फ़ाइल सेव करें और चलाएं:

   pod install

7. Xcode में, अपने ऐप्लिकेशन के लिए जनरेट की गई .xcworkspace workspace फ़ाइल खोलें. अपने ऐप्लिकेशन में भविष्य के विकास के लिए इस फ़ाइल का इस्तेमाल करें. (ध्यान दें कि यह, शामिल की गई .xcodeproj project फ़ाइल से अलग है. इसे खोलने पर, बिल्ड से जुड़ी गड़बड़ियां हो सकती हैं.)

   उदाहरण के लिए, Objective-C के सैंपल ऐप्लिकेशन की Podfile देखें.

Swift Package Manager

1. Xcode में अपना प्रोजेक्ट खोलें.

2. अपने ऐप्लिकेशन में Google Sign-In की डिपेंडेंसी जोड़ें (Xcode दस्तावेज़):

   डेटा स्टोर करने की जगह	https://github.com/google/GoogleSignIn-iOS
   वर्शन	7.0.0
   पैकेज में प्रॉडक्ट	GoogleSignIn

3. अगर SwiftUI का इस्तेमाल किया जा रहा है, तो "Google से साइन इन करें" बटन के लिए, एक्सटेंशन पैकेज का यह प्रॉडक्ट भी जोड़ें:

   पैकेज में प्रॉडक्ट

   GoogleSignInSwift

OAuth क्लाइंट आईडी पाना

Google के पुष्टि करने वाले बैकएंड को अपनी पहचान बताने के लिए, आपके ऐप्लिकेशन को OAuth क्लाइंट आईडी की ज़रूरत होती है. iOS और macOS ऐप्लिकेशन के लिए, OAuth क्लाइंट आईडी ऐप्लिकेशन टाइप को iOS के तौर पर कॉन्फ़िगर करना ज़रूरी है.

अगर आपने पहले से कोई OAuth क्लाइंट आईडी नहीं बनाया है, तो ऐसा करने के लिए यहां दिए गए बटन पर क्लिक करें.

OAuth क्लाइंट आईडी बनाना

OAuth क्लाइंट आईडी बनाने के बाद, क्लाइंट आईडी स्ट्रिंग को नोट कर लें. आपको अपने ऐप्लिकेशन में 'Google साइन इन' को कॉन्फ़िगर करने के लिए, इसकी ज़रूरत पड़ेगी. आपके पास, कॉन्फ़िगरेशन फ़ाइल को डाउनलोड करने का विकल्प भी है. इसमें आपका क्लाइंट आईडी और कॉन्फ़िगरेशन का अन्य डेटा होता है, ताकि आने वाले समय में इसका इस्तेमाल किया जा सके.

अगर आपने पहले ही OAuth क्लाइंट आईडी बना लिया है, तो नीचे दिए गए बटन पर क्लिक करके, अपनी मौजूदा OAuth जानकारी देखी जा सकती है.

मौजूदा OAuth क्लाइंट आईडी पाना

OAuth सर्वर क्लाइंट आईडी पाना

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

सर्वर क्लाइंट आईडी बनाने के लिए:

1. Cloud Console में अपना प्रोजेक्ट खोलें.

2. वेब ऐप्लिकेशन टाइप का नया OAuth क्लाइंट आईडी बनाएं. क्लाइंट आईडी स्ट्रिंग को नोट कर लें. आपको अपने ऐप्लिकेशन में Google Sign-In को कॉन्फ़िगर करने के लिए, इसकी ज़रूरत पड़ेगी.

अपना ऐप्लिकेशन प्रोजेक्ट कॉन्फ़िगर करना

Google साइन इन के लिए, आपके प्रोजेक्ट को आपके OAuth क्लाइंट आईडी और कस्टम यूआरएल स्कीम के साथ कॉन्फ़िगर करना ज़रूरी है. इसके अलावा, बैकएंड की पुष्टि के लिए, अपने सर्वर क्लाइंट आईडी को भी जोड़ा जा सकता है. इसके अलावा, अपने Google Workspace डोमेन के लिए ऐप्लिकेशन को ऑप्टिमाइज़ भी किया जा सकता है.

अपना OAuth क्लाइंट आईडी और कस्टम यूआरएल स्कीम जोड़ना

अपने ऐप्लिकेशन की Info.plist फ़ाइल को अपडेट करें, ताकि आप OAuth क्लाइंट आईडी और उलटे क्लाइंट आईडी के आधार पर कस्टम यूआरएल स्कीम जोड़ सकें.

उलटा क्लाइंट आईडी, आपका क्लाइंट आईडी होता है. इसमें बिंदु से अलग किए गए फ़ील्ड का क्रम उलटा होता है. Cloud Console में मौजूदा iOS OAuth क्लाइंट चुनते समय, यह "iOS यूआरएल स्कीम" में भी दिखता है. उदाहरण के लिए: com.googleusercontent.apps.1234567890-abcdefg

<key>GIDClientID</key>
<string>YOUR_IOS_CLIENT_ID</string>
<key>CFBundleURLTypes</key>
<array>
  <dict>
    <key>CFBundleURLSchemes</key>
    <array>
      <string>YOUR_DOT_REVERSED_IOS_CLIENT_ID</string>
    </array>
  </dict>
</array>

ज़रूरी नहीं: बैकएंड की पुष्टि करने की सुविधा कॉन्फ़िगर करना

अगर आपको बैकएंड की पुष्टि के लिए उपयोगकर्ताओं के आईडी टोकन चाहिए, तो अपने ऐप्लिकेशन की Info.plist फ़ाइल में GIDServerClientID कुंजी भी सेट करें.

ध्यान दें: यह आपके बैकएंड प्रोजेक्ट के लिए OAuth क्लाइंट आईडी है, न कि आपके iOS या macOS ऐप्लिकेशन के लिए आईडी. आपको OAuth सर्वर क्लाइंट आईडी पाना और यहां उसकी जानकारी देनी होगी.

<key>GIDServerClientID</key>
<string>YOUR_SERVER_CLIENT_ID</string>

ज़रूरी नहीं: Google Workspace डोमेन या OpenID रीलम के लिए ऑप्टिमाइज़ करें

अगर आपको Google Workspace डोमेन के लिए साइन-इन फ़्लो को ऑप्टिमाइज़ करना है, तो GIDHostedDomain पैरामीटर का इस्तेमाल करें.

<key>GIDHostedDomain</key>
<string>YOUR_HOSTED_DOMAIN</string>

अगर आपको OpenID रीलम की जानकारी देनी है, तो GIDOpenIDRealm पैरामीटर का इस्तेमाल करें.

<key>GIDOpenIDRealm</key>
<string>YOUR_OPENID_REALM</string>

अपने ऐप्लिकेशन पर हस्ताक्षर करना

आपके ऐप्लिकेशन पर Apple के जारी किए गए सर्टिफ़िकेट का हस्ताक्षर होना चाहिए, ताकि वह macOS और iOS डिवाइसों पर मूल रूप से चल सके. इससे, पासकी की मदद से क्रेडेंशियल सेव किए जा सकेंगे.

अगले चरण

प्रोजेक्ट की डिपेंडेंसी डाउनलोड करने और Xcode प्रोजेक्ट को कॉन्फ़िगर करने के बाद, अपने iOS ऐप्लिकेशन में Google साइन इन जोड़ा जा सकता है.