iOS ve macOS için Google ile Oturum Açma'yı kullanmaya başlama

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

Başlamadan önce

Xcode'un geçerli sürümünü yükleyin.

Google ile Oturum Açma bağımlılarını projenize yükleme

CocoaPods

  1. Henüz CocoaPods yüklemediyseniz CocoaPods Başlangıç 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 şimdi bir tane oluşturun:

    pod init

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

    pod 'GoogleSignIn'

  5. SwiftUI kullanıyorsanız "Google ile oturum aç" düğmesinin 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. Bu dosyayı ileride uygulamanızda yapılacak tüm geliştirmeler için kullanın. (Bu işlemin, dahil olan .xcodeproj proje dosyasından farklı olduğunu unutmayın. Bu işlem, açıldığında derleme hatalarına neden olur.)

    Örnek için Objective-C örnek uygulamasının Podfile dosyasını inceleyebilirsiniz.

Swift Package Manager

  1. Xcode'da projenizi açın.

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

    Depo https://github.com/google/GoogleSignIn-iOS
    Sürüm 6.0.2
    Paket ürünü Google ile Oturum Açma
  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 alma

Uygulamanızın kendisini Google'ın kimlik doğrulama arka ucu olarak tanımlayabilmesi için OAuth istemci kimliği gerekir. iOS ve macOS uygulamalarında OAuth istemci kimliği uygulama türü iOS olarak yapılandırılmalıdır.

Önceden 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ırmanız gereken istemci kimliği dizesini not edin. İsteğe bağlı olarak, gelecekte başvurmak üzere istemci kimliğinizi ve diğer yapılandırma verilerini içeren yapılandırma dosyasını indirebilirsiniz.

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

Mevcut OAuth istemci kimliğini alın

OAuth sunucu istemci kimliği alma

Çoğu uygulamanın, oturum açmış kullanıcıların kimliğini bir tür arka uç hizmetine iletmesi 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, arka ucunuzu temsil eden ikinci bir istemci kimliği (sunucu istemci kimliğiniz) gerektirir.

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

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

  2. Yeni bir Web uygulaması türü OAuth istemci kimliği oluşturun. Uygulamanızda istemci oturum açma özelliğini yapılandırmak için kullanacağınız 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 düzeniyle 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

Uygulamanızın Info.plist dosyasını güncelleyerek OAuth istemci kimliğinizi ve ters istemci kimliğini temel alan özel bir URL şeması ekleyin.

Ters çevrilmiş müşteri kimliği, noktayla ayrılmış alanların sırası değiştirilerek kullanılan müşteri kimliğinizdir. Bu aynı zamanda Cloud Console'da 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ı kimliği jetonları 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ı: Google Workspace alanı veya OpenID alanı için optimizasyon yapın

Bir Google Workspace alanının 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>

Başvurunuz imzalanıyor

Tuş zinciri aracılığıyla kimlik bilgilerini depolamak üzere 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ı indirip Xcode projenizi yapılandırdığınıza göre, iOS uygulamanıza Google ile Oturum Açma'yı ekleyebilirsiniz.