중요: 2024년 5월 1일부터 Apple에서는 GoogleSignIn-iOS와 같이 흔히 사용되는 SDK를 사용하는 iOS 애플리케이션의 개인 정보 보호 매니페스트 및 서명을 요구합니다. 2024년 5월 1일 전에 GoogleSignIn-iOS v7.1.0 이상으로 업그레이드하세요. 업그레이드 가이드를 따르세요.
Google은 AI 기술을 사용하여 콘텐츠를 사용자의 기본 언어로 번역합니다. AI 번역에는 오류가 있을 수 있습니다.
Google 로그인 iOS 및 macOS SDK 출시 노트
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
10.1.0
CocoaPods 배포를 지원 중단합니다. CocoaPods에 게시된 마지막 버전으로, 2026년 12월 2일에 읽기 전용이 됩니다. MIGRATING_FROM_COCOAPODS.md를 사용하여 Swift Package Manager로 이전하세요. (#656)
AppCheckCore 12.x를 지원하므로 Swift Package Manager를 사용하는 앱이 이제 Firebase 13으로 업그레이드할 수 있습니다 (podspec은 AppCheckCore 11.x 또는 12.x도 허용함). AppCheckCore 11.x에서는 토큰이나 오류를 반환하지 않는 커스텀 앱 체크 제공자가 이제 성공으로 간주되며 실패한 앱 체크 준비가 더 이상 성공으로 보고되지 않습니다. (#626)
GIDGoogleUser의 동시 실행 문제를 해결합니다.
이제 accessToken, refreshToken, idToken, profile의 키-값 관찰자는 이 중 하나가 변경될 때마다 알림을 받으므로 절반만 업데이트된 사용자를 보지 않습니다 (profile는 이전에 알림을 전송하지 않음). 이제 configuration는 사용자가 생성될 때 고정되며, 이후 토큰 업데이트를 반영하지 않을 수 있습니다. (#651)
이제 GIDGoogleUser가 내부 잠금을 보유하는 동안 키-값 관찰자에게 알림이 전송됩니다. 동일한 사용자를 다시 호출하는 것은 괜찮지만 옵저버는 해당 사용자를 업데이트하는 다른 스레드에서 동기식으로 대기해서는 안 됩니다 (예: dispatch_sync 사용). (#652)
범위가 추가되는 동안 토큰 새로고침이 진행 중일 때 grantedScopes 및 accessToken가 더 이상 범위 추가 전 값으로 되돌아가지 않습니다. (#653)
동시 업데이트 중에 리더에게 더 이상 이전 토큰과 새 토큰이 혼합되어 표시되지 않습니다. (#645)
Device Policy 앱을 다시 시작한 후 로그인을 계속할 때 맞춤 nonce 및 요청된 claims가 삭제되는 문제를 수정했습니다. (#637)
키 창 없이 오류가 발생한 후 앱의 나머지 수명 동안 EMM 해결 대화상자가 표시되지 않고 EMM 오류가 kGIDSignInErrorCodeEMM 대신 kGIDSignInErrorCodeUnknown 또는 기본 OAuth 오류로 보고되는 문제가 해결되었습니다. (#642)
서버 오류 응답의 error 키에 문자열이 아닌 값이 포함된 경우 발생하는 비정상 종료를 수정했습니다. (#638)
중요: AppAuth 3.0.0 및 GTMAppAuth 6.0.0으로 업데이트합니다. 이 업데이트는 최소 배포 타겟을 iOS 15.0 및 macOS 12.0으로 높이고, GTMSessionFetcher 종속 항목을 확장하여 4.x 및 5.x를 허용하며, 버전별 Swift Package Manager 매니페스트의 이름을 Package@swift-5.7.swift로 바꿉니다. 이전 OS 버전을 계속 지원해야 하는 프로젝트는 GoogleSignIn 9.2.0을 유지해야 합니다. (#628)
Google 로그인을 삽입하는 SDK가 새 gidwrapper 매개변수를 통해 Google의 진단 로그에서 자체 식별할 수 있도록 GIDSignIn.wrapperIdentifier를 추가합니다. 선택사항이며 기존 동작은 변경되지 않습니다. (#625)
signIn 및 addScopes 메서드에 대해 중첩된 콜백이 호출되지 않는 문제를 수정합니다.
(#29)
6.0.0
iOS용 Google 로그인이 이제 오픈소스입니다.
Swift Package Manager 지원
M1 Mac에서 시뮬레이터를 지원합니다.
API 노출 영역 업데이트
GIDSignIn
sharedInstance는 이제 클래스 속성입니다.
signIn는 이제 signInWithConfiguration:presentingViewController:callback:이며 항상 기본 프로필 범위를 요청합니다.
addScopes:presentingViewController:callback:는 현재 로그인한 사용자에게 기본 프로필 이외의 범위를 추가하는 새로운 방법입니다.
restorePreviousSignIn는 이제 restorePreviousSignInWithCallback:입니다.
disconnect는 이제 disconnectWithCallback:입니다.
GIDSignInDelegate 프로토콜이 삭제되고 GIDSignInCallback 및 GIDDisconnectCallback 블록으로 대체되었습니다.
모든 로그인 흐름 구성 속성이 GIDConfiguration로 이동되었습니다.
사용자를 로그인하는 데 필요한 구성을 나타내기 위해 GIDConfiguration 클래스가 추가되었습니다.
GIDAuthentication
getTokensWithHandler:는 이제 doWithFreshTokens:입니다.
GIDAuthenticationHandler typedef의 이름이 GIDAuthenticationAction로 변경되었습니다.
refreshTokensWithHandler:가 삭제되었습니다. 대신 doWithFreshTokens:를 사용하세요.
GIDSignInButton는 더 이상 내부적으로 GIDSignIn를 호출하지 않으며, signInWithConfiguration:presentingViewController:callback:를 호출하여 로그인 흐름을 시작하려면 IBAction 또는 이와 유사한 항목에 연결해야 합니다.
5.0.2
사용자가 로그인 과정에서 iOS의 동의 대화상자를 취소할 때 잘못된 오류 코드가 signIn:didSignInForUser:withError:에 전송되는 문제를 수정합니다.
5.0.1
iOS 13에서 로그인 흐름을 올바르게 시작할 수 없는 문제가 해결되었습니다.
ZIP 배포에는 Xcode 11 이상이 필요합니다.
5.0.0
GIDSignIn 변경사항
uiDelegate를 presentingViewController로 대체했습니다.
hasAuthInKeychain를 hasPreviousSignIn로 대체했습니다.
signInSilently를 restorePreviousSignIn로 대체했습니다.
지원 중단된 kGIDSignInErrorCodeNoSignInHandlersInstalled 오류 코드가 삭제되었습니다.
GIDAuthentication 변경사항
지원 중단된 메서드 getAccessTokenWithHandler: 및 refreshAccessTokenWithHandler:가 삭제되었습니다.
GIDGoogleUser 변경사항
지원 중단된 속성 accessibleScopes를 삭제했습니다. 대신 grantedScopes를 사용하세요.
AppAuth 및 GTMAppAuth에 대한 종속 항목을 추가합니다.
GoogleToolboxForMac에 대한 종속 항목을 삭제합니다.
iOS 7에 대한 지원이 중단되었습니다.
4.4.0
GTM OAuth 2에 대한 종속 항목을 삭제합니다.
4.3.0
Google의 엔터프라이즈 모바일 관리를 지원합니다.
4.2.0
grantedScopes를 GIDGoogleUser에 추가하여 로그인 성공 후 부여된 범위를 확인할 수 있습니다.
GIDGoogleUser의 accessibleScopes 지원이 중단되었습니다. 대신 grantedScopes를 사용하세요.
hi (힌디어) 및 fr-CA (프랑스어 (캐나다))에 대해 GIDSignInButton를 현지화합니다.
시스템 LocalAuthentication 프레임워크에 종속 항목을 추가합니다.
4.1.2
GoogleSignIn CocoaPod에 pod try 지원을 추가합니다.
4.1.1
iOS 11에서 GIDSignInUIDelegate의 signInWillDispatch:error:가 호출되지 않는 문제가 해결되었습니다. SFAuthenticationSession은 앱의 뷰 컨트롤러에서 표시되지 않으므로 iOS 11에서는 signIn:presentViewController: 및 signIn:dismissViewController:가 호출되지 않습니다.
4.1.0
iOS 11에서 SFAuthenticationSession을 사용합니다.
4.0.2
더 이상 GoogleAppUtilities에 종속되지 않습니다.
4.0.1
오픈소스 포드 종속 항목으로 전환합니다.
로그인 버튼의 모양이 더 이상 요청된 범위에 따라 달라지지 않습니다.
4.0.0
이제 GoogleSignIn 포드가 정적 프레임워크 형식을 취합니다. Objective-C에서 #import <GoogleSignIn/GoogleSignIn.h>를 사용하여 가져옵니다.
모듈 지원을 추가합니다. 모듈이 사용 설정된 경우 Objective-C에서 @import GoogleSignIn;를 사용할 수 있으며, 브리지 헤더를 사용하지 않고 Swift에서 import GoogleSignIn를 사용할 수도 있습니다.
독립형 ZIP 배포 사용자의 경우 이제 여러 프레임워크가 제공되며 모두 프로젝트에 추가해야 합니다. 이러한 분해를 통해 중복된 종속 항목이 있는 경우 더 많은 유연성을 확보할 수 있습니다.
GIDSignIn에서 지원 중단된 메서드 checkGoogleSignInAppInstalled를 삭제합니다.
GIDSignIn에서 allowsSignInWithBrowser 및 allowsSignInWithWebView 속성을 삭제합니다.
더 이상 앱에서 지원하는 URL 스키마로 번들 ID를 추가할 필요가 없습니다.
3.0.0
GIDProfileData에 givenName 및 familyName 속성을 제공합니다.
GIDSignIn에서 loginHint 속성을 설정하여 로그인 과정에서 사용자의 ID 또는 이메일 주소를 미리 채울 수 있습니다.
iOS 9 (베타)와 호환됩니다. 이 버전의 로그인 SDK에는 비트코드가 포함되어 있지 않으므로 Xcode 7을 사용하는 경우 프로젝트에서 ENABLE_BITCODE를 NO로 설정해야 합니다.
GIDSignInButton의 자동 레이아웃 제약 조건에 대한 설명 식별자를 추가합니다.
signInSilently에 더 이상 uiDelegate 설정이 필요하지 않습니다.
2.1.0
GIDSignInButton의 자동 레이아웃 문제가 해결되었습니다.
GIDAuthentication에서 액세스 토큰을 새로고침하는 API를 추가합니다.
GIDSignIn에서 할당되지 않은 clientID에 대한 예외 설명이 개선되었습니다.
기타 사소한 버그 수정
2.0.1
버그 수정
2.0.0
브라우저로 앱을 전환하는 대신 UIWebView를 통한 로그인을 지원하며,
새로운 allowsSignInWithWebView 속성으로 구성할 수 있습니다.
이제 allowsSignInWithBrowser 속성을 통해 브라우저로 전환하는 앱 전환과 allowsSignInWithWebView 속성을 통한 인앱 웹 보기를 사용 중지한 앱은 사용자에게 App Store에서 Google 앱을 다운로드하도록 안내하는 메시지를 표시할 수 있습니다.
자동 레이아웃이 사용 설정된 경우 로그인 버튼 크기 조정 문제 수정
이제 signInSilently는 문서에 명시된 대로 hasAuthInKeychain가 NO일 때 오류와 함께 대리자를 호출합니다.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2026-11-09(UTC)"],[],[]]
