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
Henüz CocoaPods yüklemediyseniz CocoaPods Başlangıç kılavuzundaki adımları uygulayın.
Bir terminal penceresi açın ve uygulamanızın Xcode projesinin konumuna gidin.
Uygulamanız için henüz bir Podfile oluşturmadıysanız şimdi bir tane oluşturun:
pod init
Uygulamanız için oluşturulan Podfile dosyasını açın ve aşağıdakileri ekleyin:
pod 'GoogleSignIn'
SwiftUI kullanıyorsanız "Google ile oturum aç" düğmesinin kapsül uzantısını da ekleyin:
pod 'GoogleSignInSwiftSupport'
Dosyayı kaydedin ve şunu çalıştırın:
pod install
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
Xcode'da projenizi açın.
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 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:
Cloud Console'da projenizi açın.
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.