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

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

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

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

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

CocoaPods

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

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

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

   pod init

4. अपने ऐप्लिकेशन के लिए बनाया गया Podfile खोलें और यह डेटा जोड़ें:

   pod 'GoogleSignIn'

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

   pod 'GoogleSignInSwiftSupport'

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

   pod install

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

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

स्विफ़्ट पैकेज मैनेजर

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

2. अपने ऐप्लिकेशन में 'Google साइन-इन' डिपेंडेंसी जोड़ें (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 से साइन इन करने वाले उपयोगकर्ताओं की पहचान आपके बैकएंड में सुरक्षित तरीके से पास करने के लिए, आपको आईडी टोकन का इस्तेमाल करना होगा. इस बारे में बैकएंड सर्वर से पुष्टि करें में बताया गया है. उपयोगकर्ता का आईडी टोकन वापस पाने के लिए, एक दूसरे Client-ID की ज़रूरत होती है. आपके सर्वर क्लाइंट आईडी से आपका बैकएंड दिखता है.

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

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

2. वेब ऐप्लिकेशन का नया OAuth क्लाइंट आईडी बनाएं. Client-ID स्ट्रिंग पर ध्यान दें. इसे आपको अपने ऐप्लिकेशन में 'Google साइन-इन' को कॉन्फ़िगर करना होगा.

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

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

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

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

उलटा हुआ क्लाइंट आईडी आपका क्लाइंट आईडी होता है. इसमें बिंदु से सीमांकित फ़ील्ड का क्रम उलटा होता है. 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 साइन-इन जोड़ा जा सकता है.