iOS ve macOS için Google ile Oturum Açma özelliğini kullanmaya başlama

iOS veya macOS uygulamanızı Google ile Oturum Açma bileşenleriyle entegre etmeye başlamadan önce bağımlılıkları indirmeniz ve Xcode projenizi yapılandırmanız gerekir. Bu sayfadaki adımlar tam olarak bunu yapar. Ardından, sonraki adımlarda Google ile Oturum Açma özelliklerinin uygulamanıza nasıl entegre edileceği açıklanır.

Başlamadan önce

Xcode'un güncel bir sürümünü yükleyin.

Google ile Oturum Açma bağımlılıklarını projenize yükleyin

CocoaPods

  1. CocoaPods'u henüz yüklemediyseniz CocoaPods Başlarken kılavuzundaki adımları uygulayın.

  2. Bir terminal penceresi açın ve uygulamanızın Xcode projesinin konumuna gidin.

  3. Uygulamanız için henüz bir Podfile oluşturmadıysanız hemen bir tane oluşturun:

    pod init

  4. Uygulamanız için oluşturulan Podfile'ı açın ve aşağıdakileri ekleyin:

    pod 'GoogleSignIn'

  5. SwiftUI kullanıyorsanız "Google ile oturum aç" düğmesi için kapsül uzantısını da ekleyin:

    pod 'GoogleSignInSwiftSupport'

  6. Dosyayı kaydedin ve şunu çalıştırın:

    pod install

  7. Uygulamanız için oluşturulan .xcworkspace workspace dosyasını Xcode'da açın. Uygulamanızda gelecekte yapılacak tüm geliştirmeler için bu dosyayı kullanın. (Bunun, dahil edilen .xcodeproj proje dosyasından farklı olduğunu ve açıldığında derleme hatalarına neden olabileceğini unutmayın.)

    Örnek için Objective-C örnek uygulamasının Podfile'ına bakabilirsiniz.

Swift Paket Yöneticisi

  1. Projenizi Xcode'da açın.

  2. Google ile Oturum Açma bağımlılıklarını uygulamanıza ekleyin (Xcode belgeleri):

    Depo https://github.com/google/GoogleSignIn-iOS
    Sürüm 7.0.0
    Paket ürünü GoogleSignIn
  3. SwiftUI kullanıyorsanız "Google ile oturum aç" düğmesi için aşağıdaki uzantı paketi ürününü de ekleyin:

    Paket ürünü GoogleSignInSwift

OAuth istemci kimliği al

Uygulamanızın, kendisini Google'ın kimlik doğrulama arka ucuna tanıtmak için bir OAuth istemci kimliğine ihtiyacı vardır. iOS ve macOS uygulamaları için OAuth istemci kimliği uygulama türü iOS olarak yapılandırılmalıdır.

Henüz OAuth istemci kimliği oluşturmadıysanız bunu yapmak için aşağıdaki düğmeyi tıklayın.

OAuth istemci kimliği oluşturma

OAuth istemci kimliğini oluşturduktan sonra, uygulamanızda Google ile Oturum Açma özelliğini yapılandırmak için ihtiyaç duyacağınız istemci kimliği dizesini not edin. İsteğe bağlı olarak, istemci kimliğinizi ve diğer yapılandırma verilerini içeren yapılandırma dosyasını ileride başvurmak üzere indirebilirsiniz.

Daha önce bir OAuth istemci kimliği oluşturduysanız aşağıdaki düğmeyi tıklayarak mevcut OAuth bilgilerinizi bulabilirsiniz.

Mevcut bir OAuth istemci kimliği alın

Bir OAuth sunucusu istemci kimliği alın

Çoğu uygulamanın, oturum açmış kullanıcıların kimliğini bir tür arka uç hizmetine aktarması gerekir. Google ile oturum açan kullanıcıların kimliğini arka ucunuza güvenli bir şekilde iletmek için Arka uç sunucusuyla kimlik doğrulama bölümünde açıklandığı gibi kimlik jetonları kullanırsınız. Bir kullanıcının kimlik jetonunu almak için arka ucunuzu temsil eden ikinci bir istemci kimliği (sunucu istemci kimliğiniz) gerekir.

Sunucu istemci kimliği oluşturmak için:

  1. Cloud Console'da projenizi açın.

  2. Web uygulaması türünde yeni bir OAuth istemci kimliği oluşturun. Uygulamanızda Google ile Oturum Açma'yı yapılandırmanız için gereken istemci kimliği dizesini not edin.

Uygulama projenizi yapılandırın

Google ile Oturum Açma, projenizin OAuth istemci kimliğiniz ve özel bir URL şeması ile yapılandırılmasını gerektirir. İsteğe bağlı olarak, arka uç kimlik doğrulaması için sunucu istemci kimliğinizi de ekleyebilir veya uygulamanızı Google Workspace alanınız için optimize edebilirsiniz.

OAuth istemci kimliğinizi ve özel URL şemanızı ekleyin

OAuth istemci kimliğinizi ve ters çevrilen istemci kimliğini temel alan bir özel URL şeması eklemek için uygulamanızın Info.plist dosyasını güncelleyin.

Ters istemci kimliği, noktayla ayrılmış alanların sırası ters olacak şekilde istemci kimliğinizdir. Bu değer, Cloud konsolunda mevcut bir iOS OAuth istemcisini seçerken "iOS URL şeması" altında da gösterilir. Örneğin: 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>

İsteğe bağlı: Arka uç kimlik doğrulamasını yapılandırma

Arka uç kimlik doğrulaması için kullanıcıların kimlik jetonlarını almanız gerekiyorsa uygulamanızın Info.plist dosyasında GIDServerClientID anahtarını da ayarlayın.

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

İsteğe bağlı: Bir Google Workspace alanı veya OpenID erişim alanı için optimize etme

Bir Google Workspace alanı için oturum açma akışını optimize etmek istiyorsanız GIDHostedDomain parametresini kullanın.

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

Bir OpenID erişim alanı belirtmek istiyorsanız GIDOpenIDRealm parametresini kullanın.

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

Uygulamanızı imzalama

Kimlik bilgilerinin anahtar zinciri üzerinden saklanabilmesi için uygulamanızın macOS ve iOS cihazlarda yerel olarak çalışması için Apple tarafından verilen bir sertifikayla imzalanması gerekir.

Sonraki adımlar

Proje bağımlılıklarını indirdiğinize ve Xcode projenizi yapılandırdığınıza göre artık Google ile Oturum Açma özelliğini iOS uygulamanıza ekleyebilirsiniz.