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şenleri ile entegre etmeye başlamadan önce, bağımlılıkları indirmeniz ve Xcode projenizi yapılandırmanız gerekir. Sıradaki adım bu sayfa da tam olarak bunu yapıyor. Ardından sonraki adımlarda entegrasyon uygulamanıza Google ile Oturum Açma özelliklerini ekler.

Başlamadan önce

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

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

CocoaPods

  1. Daha önce yüklü CocoaPods yüklü değilse şu adımları uygulayın: CocoaPods Başlarken rehberini inceleyin.

  2. Bir terminal penceresi açın ve uygulamanızın Xcode'unun bulunduğu konuma gidin belirler.

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

    pod init

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

    pod 'GoogleSignIn'
    .

  5. SwiftUI kullanıyorsanız "Oturum açma" bölümü için kapsül uzantısını da ekleyin. Google ile" düğme:

    pod 'GoogleSignInSwiftSupport'
    .

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

    pod install
    .

  7. Uygulamanız için oluşturulan .xcworkspace workspace dosyasını şurada açın: Xcode'a gidin. Uygulamanızda gelecekte yapılacak tüm geliştirmeler için bu dosyayı kullanın. ( ekteki .xcodeproj proje dosyasından farklı olduğunu açıldığı zaman yapı hatalarına neden olur.)

    Objective-C örnek uygulamasının Podfile inceleyebilirsiniz.

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 dokümanları):

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

    Paket ürün GoogleSignInSwift

OAuth istemci kimliği alın

Uygulamanızın kendisini Google'ın kimlik doğrulamasına tanıtmak için OAuth istemci kimliğine ihtiyacı var arka uçta olması gerekir. 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 düğmeyi tıklayın bunu yapabilirsiniz.

OAuth istemci kimliği oluşturma

OAuth istemci kimliğini oluşturduktan sonra, istemci kimliği dizesini not alın. Bu dize uygulamanızda Google ile Oturum Açma'yı yapılandırmanız gerekir. İsterseniz yapılandırma dosyasını indirin. Bu dosya, istemci kimliğinizi ve diğer yapılandırma verilerini kullanabilirsiniz.

Daha önce OAuth istemci kimliği oluşturduysanız mevcut OAuth istemcinizi bulabilirsiniz. bilgi edinmek için aşağıdaki düğmeyi tıklayın.

Mevcut bir OAuth istemci kimliği alın

OAuth sunucusu istemci kimliği alın

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

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

  1. Projenizi Cloud Console.

  2. Web uygulaması türünde yeni bir OAuth istemci kimliği oluşturun. Şunları not edin: istemci kimliği dizesidir. uygulamasını indirin.

Uygulama projenizi yapılandırın

Google ile Oturum Açma için projenizin OAuth istemci kimliğinizle yapılandırılması gerekir ve özel bir URL şeması içerir. İsterseniz sunucu istemci kimliğinizi de ekleyebilirsiniz: arka uç kimlik doğrulaması yapabilir veya uygulamanızı Google Workspace alanı.

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

OAuth'unuzu eklemek için uygulamanızın Info.plist dosyasını güncelleyin. Client-ID ve ters istemci kimliğine dayalı bir özel URL şeması.

Ters çevrilmiş istemci kimliği, noktayla ayrılmış sıralamaya sahip istemci kimliğinizdir. alanları tersine çevrildi. Bu, "iOS URL şeması" altında da gösterilir bir Bulutta mevcut iOS OAuth istemcisi konsolu hakkında daha fazla bilgi edinin. Örnek: 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

Kullanıcıların Arka uç kimlik doğrulaması için kimlik jetonları, ayrıca uygulamanızın Info.plist dosyasında GIDServerClientID anahtarını ayarlayın.

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

İsteğe bağlı: Google Workspace alanı veya RFC alanı için optimizasyon yapın

Oturum açma akışını optimize etmek istiyorsanız GIDHostedDomain parametresini kullanın: Google Workspace alanı

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

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

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

Uygulamanızı imzalama

Uygulamanızın çalışması için Apple tarafından verilen bir sertifikayla imzalanması gerekir macOS ve iOS cihazlarda yerel olarak kullanarak kimlik bilgilerini anahtarlık.

Sonraki adımlar

Artık proje bağımlılıklarını indirdiğinize ve Xcode'unuzu yapılandırdığınıza göre Google ile Oturum Açma hizmetini iOS uygulamanıza ekleyebilirsiniz.