با Google Sign-In برای iOS و macOS شروع کنید

قبل از اینکه بتوانید برنامه iOS یا macOS خود را با اجزای Google Sign-In ادغام کنید، باید وابستگی ها را دانلود کرده و پروژه Xcode خود را پیکربندی کنید. مراحل این صفحه دقیقاً این کار را انجام می دهد. سپس مراحل بعدی نحوه ادغام ویژگی های Google Sign-In را در برنامه خود شرح می دهد.

قبل از اینکه شروع کنی

نسخه فعلی Xcode را نصب کنید.

وابستگی های Google Sign-In را در پروژه خود نصب کنید

CocoaPods

  1. اگر قبلاً CocoaPods را نصب نکرده‌اید، مراحل راهنمای شروع به کار CocoaPods را دنبال کنید.

  2. یک پنجره ترمینال را باز کنید و به محل پروژه Xcode برنامه خود بروید.

  3. اگر قبلاً یک Podfile برای برنامه خود ایجاد نکرده اید، اکنون یکی ایجاد کنید: 

    pod init

  4. Podfile ایجاد شده برای برنامه خود را باز کنید و موارد زیر را اضافه کنید:

    pod 'GoogleSignIn'

  5. اگر از SwiftUI استفاده می‌کنید، افزونه pod را برای دکمه «ورود با Google» نیز اضافه کنید:

    pod 'GoogleSignInSwiftSupport'

  6. فایل را ذخیره کرده و اجرا کنید:

    pod install

  7. فایل فضای کاری .xcworkspace ایجاد شده را برای برنامه خود در Xcode باز کنید. از این فایل برای تمام توسعه های آینده برنامه خود استفاده کنید. (توجه داشته باشید که این با فایل پروژه .xcodeproj موجود متفاوت است که در هنگام باز کردن منجر به خطاهای ساخت می شود.)

    برای مثال می توانید به پادفایل برنامه نمونه Objective-C مراجعه کنید.

مدیر بسته سوئیفت

  1. پروژه خود را در Xcode باز کنید.

  2. وابستگی‌های ورود به سیستم Google را به برنامه خود اضافه کنید ( اسناد Xcode ):

    مخزن https://github.com/google/GoogleSignIn-iOS
    نسخه 7.0.0
    محصول بسته بندی GoogleSignIn

  3. اگر از SwiftUI استفاده می کنید، محصول بسته برنامه افزودنی زیر را نیز برای دکمه "ورود به سیستم با Google" اضافه کنید:

    محصول بسته بندی GoogleSignInSwift

شناسه مشتری OAuth دریافت کنید

برنامه شما به شناسه مشتری OAuth نیاز دارد تا خود را در پشتیبان احراز هویت Google شناسایی کند. برای برنامه‌های iOS و macOS ، نوع برنامه شناسه مشتری OAuth باید به‌عنوان iOS پیکربندی شود.

اگر قبلاً شناسه مشتری OAuth ایجاد نکرده اید، برای انجام این کار روی دکمه زیر کلیک کنید.

یک شناسه مشتری OAuth ایجاد کنید

پس از ایجاد شناسه مشتری OAuth، رشته شناسه مشتری را که باید Google Sign-In را در برنامه خود پیکربندی کنید، یادداشت کنید. شما می توانید به صورت اختیاری فایل پیکربندی را که حاوی شناسه مشتری و سایر داده های پیکربندی است، برای مراجعات بعدی دانلود کنید.

اگر قبلاً یک شناسه مشتری OAuth ایجاد کرده اید، می توانید اطلاعات OAuth موجود خود را با کلیک بر روی دکمه زیر بیابید.

شناسه مشتری OAuth موجود را دریافت کنید

شناسه مشتری سرور OAuth دریافت کنید

اکثر برنامه‌ها باید هویت کاربرانی که وارد سیستم شده‌اند را به نوعی از خدمات پشتیبان منتقل کنند. برای انتقال ایمن هویت کاربرانی که با Google وارد سیستم پشتیبان خود شده‌اند، از نشانه‌های شناسه استفاده می‌کنید، همانطور که در تأیید هویت با سرور پشتیبان بحث شده است. بازیابی رمز شناسه کاربر به شناسه مشتری دوم - شناسه مشتری سرور شما - نیاز دارد که نمایانگر باطن شما است.

برای ایجاد شناسه مشتری سرور:

  1. پروژه خود را در کنسول Cloud باز کنید.

  2. شناسه سرویس گیرنده OAuth نوع برنامه وب جدید ایجاد کنید. به رشته شناسه مشتری توجه داشته باشید، که باید Google Sign-In را در برنامه خود پیکربندی کنید.

پروژه برنامه خود را پیکربندی کنید

ورود به سیستم Google مستلزم این است که پروژه شما با شناسه مشتری OAuth و یک طرح URL سفارشی پیکربندی شود. به صورت اختیاری، می‌توانید شناسه سرویس گیرنده سرور خود را برای تأیید اعتبار پشتیبان اضافه کنید یا برنامه خود را برای دامنه Google Workspace خود بهینه کنید.

شناسه مشتری OAuth و طرح URL سفارشی خود را اضافه کنید

فایل Info.plist برنامه خود را به روز کنید تا شناسه مشتری OAuth و یک طرح URL سفارشی بر اساس شناسه مشتری معکوس اضافه شود.

شناسه مشتری معکوس، شناسه مشتری شما با ترتیب فیلدهای مشخص شده با نقطه معکوس است. هنگام انتخاب یک سرویس گیرنده OAuth iOS موجود در کنسول Cloud، این مورد نیز در زیر " طرح URL 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>

اختیاری: احراز هویت باطن را پیکربندی کنید

اگر برای احراز هویت باطن نیاز به دریافت کدهای شناسه کاربران دارید، کلید GIDServerClientID را نیز در فایل Info.plist برنامه خود تنظیم کنید.

<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>

امضای درخواست شما

برنامه شما باید با گواهی صادر شده توسط اپل امضا شود تا به صورت بومی روی دستگاه های macOS و iOS اجرا شود تا اعتبارنامه ها از طریق زنجیره کلید ذخیره شوند.

مراحل بعدی

اکنون که وابستگی‌های پروژه را دانلود کرده‌اید و پروژه Xcode خود را پیکربندی کرده‌اید، می‌توانید Google Sign-In را به برنامه iOS خود اضافه کنید.

،

قبل از اینکه بتوانید برنامه iOS یا macOS خود را با اجزای Google Sign-In ادغام کنید، باید وابستگی ها را دانلود کرده و پروژه Xcode خود را پیکربندی کنید. مراحل این صفحه دقیقاً این کار را انجام می دهد. سپس مراحل بعدی نحوه ادغام ویژگی های Google Sign-In را در برنامه خود شرح می دهد.

قبل از اینکه شروع کنی

نسخه فعلی Xcode را نصب کنید.

وابستگی های Google Sign-In را در پروژه خود نصب کنید

CocoaPods

  1. اگر قبلاً CocoaPods را نصب نکرده‌اید، مراحل راهنمای شروع به کار CocoaPods را دنبال کنید.

  2. یک پنجره ترمینال را باز کنید و به محل پروژه Xcode برنامه خود بروید.

  3. اگر قبلاً یک Podfile برای برنامه خود ایجاد نکرده اید، اکنون یکی ایجاد کنید: 

    pod init

  4. Podfile ایجاد شده برای برنامه خود را باز کنید و موارد زیر را اضافه کنید:

    pod 'GoogleSignIn'

  5. اگر از SwiftUI استفاده می‌کنید، افزونه pod را برای دکمه «ورود با Google» نیز اضافه کنید:

    pod 'GoogleSignInSwiftSupport'

  6. فایل را ذخیره کرده و اجرا کنید:

    pod install

  7. فایل فضای کاری .xcworkspace ایجاد شده را برای برنامه خود در Xcode باز کنید. از این فایل برای تمام توسعه های آینده برنامه خود استفاده کنید. (توجه داشته باشید که این با فایل پروژه .xcodeproj موجود متفاوت است که در هنگام باز کردن منجر به خطاهای ساخت می شود.)

    برای مثال می توانید به پادفایل برنامه نمونه Objective-C مراجعه کنید.

مدیر بسته سوئیفت

  1. پروژه خود را در Xcode باز کنید.

  2. وابستگی‌های ورود به سیستم Google را به برنامه خود اضافه کنید ( اسناد Xcode ):

    مخزن https://github.com/google/GoogleSignIn-iOS
    نسخه 7.0.0
    محصول بسته بندی GoogleSignIn

  3. اگر از SwiftUI استفاده می کنید، محصول بسته برنامه افزودنی زیر را نیز برای دکمه "ورود به سیستم با Google" اضافه کنید:

    محصول بسته بندی GoogleSignInSwift

شناسه مشتری OAuth دریافت کنید

برنامه شما به شناسه مشتری OAuth نیاز دارد تا خود را در پشتیبان احراز هویت Google شناسایی کند. برای برنامه‌های iOS و macOS ، نوع برنامه شناسه مشتری OAuth باید به‌عنوان iOS پیکربندی شود.

اگر قبلاً شناسه مشتری OAuth ایجاد نکرده اید، برای انجام این کار روی دکمه زیر کلیک کنید.

یک شناسه مشتری OAuth ایجاد کنید

پس از ایجاد شناسه مشتری OAuth، رشته شناسه مشتری را که باید Google Sign-In را در برنامه خود پیکربندی کنید، یادداشت کنید. شما می توانید به صورت اختیاری فایل پیکربندی را که حاوی شناسه مشتری و سایر داده های پیکربندی است، برای مراجعات بعدی دانلود کنید.

اگر قبلاً یک شناسه مشتری OAuth ایجاد کرده اید، می توانید اطلاعات OAuth موجود خود را با کلیک بر روی دکمه زیر بیابید.

شناسه مشتری OAuth موجود را دریافت کنید

شناسه مشتری سرور OAuth دریافت کنید

اکثر برنامه‌ها باید هویت کاربرانی که وارد سیستم شده‌اند را به نوعی از خدمات پشتیبان منتقل کنند. برای انتقال ایمن هویت کاربرانی که با Google وارد سیستم پشتیبان خود شده‌اند، از نشانه‌های شناسه استفاده می‌کنید، همانطور که در تأیید هویت با سرور پشتیبان بحث شده است. بازیابی رمز شناسه کاربر به شناسه مشتری دوم - شناسه مشتری سرور شما - نیاز دارد که نمایانگر باطن شما است.

برای ایجاد شناسه مشتری سرور:

  1. پروژه خود را در کنسول Cloud باز کنید.

  2. شناسه سرویس گیرنده OAuth نوع برنامه وب جدید ایجاد کنید. به رشته شناسه مشتری توجه داشته باشید، که باید Google Sign-In را در برنامه خود پیکربندی کنید.

پروژه برنامه خود را پیکربندی کنید

ورود به سیستم Google مستلزم این است که پروژه شما با شناسه مشتری OAuth و یک طرح URL سفارشی پیکربندی شود. به صورت اختیاری، می‌توانید شناسه سرویس گیرنده سرور خود را برای تأیید اعتبار پشتیبان اضافه کنید یا برنامه خود را برای دامنه Google Workspace خود بهینه کنید.

شناسه مشتری OAuth و طرح URL سفارشی خود را اضافه کنید

فایل Info.plist برنامه خود را به روز کنید تا شناسه مشتری OAuth و یک طرح URL سفارشی بر اساس شناسه مشتری معکوس اضافه شود.

شناسه مشتری معکوس، شناسه مشتری شما با ترتیب فیلدهای مشخص شده با نقطه معکوس است. هنگام انتخاب یک سرویس گیرنده OAuth iOS موجود در کنسول Cloud، این مورد نیز در زیر " طرح URL 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>

اختیاری: احراز هویت باطن را پیکربندی کنید

اگر برای احراز هویت باطن نیاز به دریافت کدهای شناسه کاربران دارید، کلید GIDServerClientID را نیز در فایل Info.plist برنامه خود تنظیم کنید.

<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>

امضای درخواست شما

برنامه شما باید با گواهی صادر شده توسط اپل امضا شود تا به صورت بومی روی دستگاه های macOS و iOS اجرا شود تا اعتبارنامه ها از طریق زنجیره کلید ذخیره شوند.

مراحل بعدی

اکنون که وابستگی‌های پروژه را دانلود کرده‌اید و پروژه Xcode خود را پیکربندی کرده‌اید، می‌توانید Google Sign-In را به برنامه iOS خود اضافه کنید.