Pierwsze kroki z Logowaniem przez Google na iOS i macOS

Zanim zaczniesz integrować aplikację na iOS lub macOS z komponentami Logowania przez Google, musisz pobrać zależności i skonfigurować projekt Xcode. Kroki na ta strona właśnie to robi. W kolejnych krokach opisz, jak zintegrować funkcji Logowania przez Google w aplikacji.

Zanim zaczniesz

Zainstaluj aktualną wersję Xcode.

Zainstaluj w projekcie zależności logowania Google

CocoaPods

  1. Jeśli nie masz jeszcze zainstalowanych CocoaPods, wykonaj czynności opisane w CocoaPods Pierwsze kroki Google.

  2. Otwórz okno terminala i przejdź do lokalizacji kodu Xcode Twojej aplikacji. w projektach AI.

  3. Jeśli nie masz jeszcze pliku Podfile dla swojej aplikacji, utwórz go. teraz: 

    pod init

  4. Otwórz plik Podfile utworzony dla Twojej aplikacji i dodaj: 

    pod 'GoogleSignIn'

  5. Jeśli używasz SwiftUI, dodaj też rozszerzenie poda dla interfejsu API logowania z Google” przycisk: 

    pod 'GoogleSignInSwiftSupport'

  6. Zapisz plik i uruchom: 

    pod install

  7. Otwórz wygenerowany plik obszaru roboczego .xcworkspace dla swojej aplikacji w Xcode. Używaj tego pliku we wszystkich przyszłych procesach deweloperskich dotyczących Twojej aplikacji. (Uwaga różni się od dołączonego pliku project .xcodeproj, który spowodowałoby błąd kompilacji).

    Zapoznaj się z przykładową aplikacją Objective-C Plik Podfile .

Menedżer pakietów Swift

  1. Otwórz swój projekt w Xcode.

  2. Dodaj do aplikacji zależności logowania Google (dokumentacja Xcode):

    Repozytorium https://github.com/google/GoogleSignIn-iOS
    Wersja 7.0.0
    Produkt w pakiecie GoogleSignIn

  3. Jeśli używasz SwiftUI, dodaj również poniższy pakiet rozszerzeń dla opcji „Zaloguj się przez Google” przycisk:

    Produkt w pakiecie GoogleSignInSwift

Uzyskiwanie identyfikatora klienta OAuth

Twoja aplikacja wymaga identyfikatora klienta OAuth, aby można było identyfikować się z uwierzytelnianiem Google z backendem. W przypadku aplikacji na iOS i macOS typ aplikacji Identyfikator klienta OAuth musi być skonfigurowany jako iOS.

Jeśli nie masz jeszcze utworzonego identyfikatora klienta OAuth, kliknij przycisk poniżej.

Tworzenie identyfikatora klienta OAuth

Po utworzeniu identyfikatora klienta OAuth zanotuj jego ciąg znaków, który musisz skonfigurować Logowanie przez Google w swojej aplikacji. Opcjonalnie możesz pobierz plik konfiguracji, który zawiera identyfikator klienta i inne do wykorzystania w przyszłości.

Jeśli masz już utworzony identyfikator klienta OAuth, aby dowiedzieć się więcej, kliknij przycisk poniżej.

Uzyskiwanie istniejącego identyfikatora klienta OAuth

Uzyskiwanie identyfikatora klienta serwera OAuth

Większość aplikacji musi przekazywać tożsamość zalogowanych użytkowników do usługi backendu jakiegoś rodzaju. Aby bezpiecznie przekazywać tożsamość użytkowników, którzy zalogowali się przez Google z backendem należy używać tokenów tożsamości zgodnie z opisem w artykule Uwierzytelnianie przy użyciu serwera backendu. Do odzyskania tokena identyfikatora użytkownika jest wymagany drugi identyfikator klienta – serwer. identyfikator klienta, który reprezentuje Twój backend.

Aby utworzyć identyfikator klienta serwera:

  1. Otwórz projekt w Konsola Cloud.

  2. Utwórz nową aplikację internetową o identyfikatorze klienta OAuth. Zwróć uwagę na identyfikatora klienta. Musisz skonfigurować Logowanie przez Google, .

Skonfiguruj projekt aplikacji

Logowanie przez Google wymaga skonfigurowania w projekcie identyfikatora klienta OAuth i schemat niestandardowego adresu URL. Opcjonalnie możesz też dodać identyfikator klienta serwera dla uwierzytelnianie backendu lub zoptymalizować aplikację pod kątem Domena Workspace.

Dodaj identyfikator klienta OAuth i niestandardowy schemat adresu URL

Zaktualizuj plik Info.plist swojej aplikacji, aby dodać OAuth Client-ID i schemat niestandardowego adresu URL oparty na odwróconym identyfikatorze klienta.

Odwrócony identyfikator klienta to Twój identyfikator klienta w kolejności: . Możesz też sprawdzić to w sekcji „Schemat adresu URL iOS”. podczas wyboru istniejącego klienta OAuth na iOS w chmurze konsoli. Na przykład: 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>

Opcjonalnie: skonfiguruj uwierzytelnianie backendu

Jeśli musisz pobrać Tokeny tożsamości na potrzeby uwierzytelniania backendu, ustaw też klucz GIDServerClientID w pliku Info.plist aplikacji.

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

Opcjonalnie: optymalizacja pod kątem domeny Google Workspace lub obszaru OpenID

Użyj parametru GIDHostedDomain, jeśli chcesz zoptymalizować proces logowania się domena Google Workspace.

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

Aby określić obszar OpenID, użyj parametru GIDOpenIDRealm.

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

Podpisywanie zgłoszenia

Aby aplikacja mogła działać, musi być podpisana certyfikatem wydanym przez Apple natywnie na urządzeniach z systemem macOS i iOS w celu przechowywania danych logowania pęk kluczy.

Dalsze kroki

Po pobraniu zależności projektu i skonfigurowaniu Xcode projektu, możesz dodać Logowanie przez Google do aplikacji na iOS.