- 마지막 업데이트
3.0.0 업그레이드 안내
3.0.0 은 모든 모듈을 함께 배포한 버전이에요. 이 페이지에서 전체 모듈의 변경 사항과 업그레이드 절차를 한 번에 안내해요. 모듈별 변경은 각 모듈 릴리즈 노트에도 정리돼 있어요.
3.0.0 (2026-10-08)
SDK 모듈이 통합되어 의존성 교체가 필요해요.
인증 · 결제 · 푸시 호출 코드는 대부분 그대로예요. 아래 업그레이드 시 해야 할 일에서 우리 게임에 해당하는 항목만 확인하면 돼요.
한눈에 보기
| 변경 | 영향받는 게임 | 해야 할 일 |
|---|---|---|
| 모듈 통합 | 전체 | 필수 — 의존성 교체 |
| 점검 · 제재 · 강제 업데이트 시 앱 자동 종료 제거 | 전체 | 필수 — 게임에서 종료 처리 |
| 게임 로그 모듈 분리 | 게임 로그를 쓰는 게임 | 필수 — 코드 수정 (GameLog.Configure 호출) |
| 로그인 오류 코드 추가 | 로그인 오류 코드로 분기하는 게임 | 확인 — origin_code 로 원인 코드 확인 |
| MemberNo 게임 설정 추가 | MemberNo 게임 | 필수 — enable_guid 를 false 로 설정 |
업그레이드 시 해야 할 일
1. 의존성을 3.0.0 모듈로 바꿔요.
모듈이 통합되면서 이름이 바뀌었어요. 2.9.x 모듈과 함께 쓸 수 없으니 모두 교체해요.
💡 Unity · Unreal 은 마이그레이션 가이드를 따라 주세요.
iOS (CocoaPods pod)
| 3.0.0 | 2.9.x |
|---|---|
Stove | SGSBase SGSLog SGSAuth SGSAuthUI SGSView |
StoveProviders | SGSAuthApple SGSAuthFacebook SGSAuthGoogle SGSAuthNaver SGSAuthLine SGSAuthSteam |
StoveIAP2 | SGSIAP2 |
StovePush | SGSPush |
StovePushExtension | SGSPushExtension (알림 서비스 익스텐션) |
StoveGameLog (신규) | (기본 모듈에 포함) |
| 제거 (대체 모듈 없음) | SGSGamingServices |
Android (Gradle 좌표, 그룹은 모두 com.stove)
| 3.0.0 | 2.9.x |
|---|---|
stove | base log auth auth-ui view |
stove-providers | auth-google auth-googleplaygames auth-facebook auth-naver auth-line auth-steam auth-apple |
stove-iap | iap |
stove-iap-google | iap-google |
stove-iap-huawei | iap-huawei |
stove-iap-onestore | iap-onestore |
stove-push | push |
stove-push-firebase | push-firebase |
stove-push-huawei | push-huawei |
stove-gamelog (신규) | (기본 모듈에 포함) |
| 제거 (대체 모듈 없음) | gamingservices |
StoveGameLog·stove-gamelog는 게임 로그를 쓰는 게임만 추가해요.SGSGamingServices·gamingservices는 의존성에서 빼기만 하면 돼요. GPG User ID 기능은StoveProviders에 들어 있어요.
2. 점검 · 제재 · 강제 업데이트 때 앱 종료를 게임에서 처리해요.
이제 SDK 가 안내 화면을 닫을 때 앱을 강제로 종료하지 않아요. 결과의 State 를 보고 앱을 종료하거나 진행을 막아 주세요.
⚠️ 처리하지 않으면 유저가 안내 화면을 닫은 뒤에도 게임을 계속 진행할 수 있어요.
📌 처리 방법과 플랫폼별 코드는 점검/업데이트 가이드의 "앱 종료 처리 (3.0.0 이상)" 를 확인해 주세요.
3. 게임 로그를 쓴다면 코드 수정이 필요해요.
게임 로그가 별도 모듈로 분리되었어요. 의존성을 추가하고, 게임 로그를 쓰기 전에 GameLog.Configure 를 한 번 호출해야 해요.
📌 수정 방법은 담당 기술 PL 에게 문의해 주세요.
4. 로그인 오류 코드로 분기한다면 원인 코드 확인 방식을 바꿔요.
로그인 실패 시 60000번대 오류 코드가 올 수 있어요. Data API · SDK UI API(AuthUI 등) 연동 방식과 관계없이, 오류 코드로 분기해 후속 처리(로그아웃 등)를 하는 코드가 있다면 원인 코드를 origin_code 에서 확인하도록 바꿔요. 오류 코드로 분기하지 않는 게임은 할 일이 없어요. 적용 예시는 로그인(이용자 흐름) 의 통합 로그인 코드를 참고해 주세요.
📌 60000번대 오류 코드 전체 목록은 에러 코드 통합 > Mobile SDK > 3.0.0 신규 오류 코드에서 확인할 수 있어요.
5. MemberNo 게임이라면 enable_guid 를 false 로 설정해요.
MemberNo 게임 식별을 위해 아래 설정이 필요해요. GUID 게임은 할 일이 없어요.
| 플랫폼 | 설정 위치 | 키 | 값 |
|---|---|---|---|
| Android | AndroidManifest.xml 의 <application> meta-data | com.stove.config.enable_guid | false |
| iOS | Info.plist | StoveEnableGUID (Boolean) | NO |
새로운 기능
- Unity · Unreal 에서 게스트 시작 · 본인 인증 유형 지정 · 기기 등록 상태 조회를 더 간단히 쓸 수 있어요.
기존 방식도 그대로 동작해요. 사용 방법은 로그인 · 본인 확인 · 기기 등록 가이드의 "3.0.0 부터" 안내를 확인해 주세요. - Unity · Unreal 에서 iOS 푸시 권한을 원하는 시점에 요청할 수 있어요.
iOS 전용이에요. Unity 는Push.RequestAuthorization, Unreal 은Push::RequestAuthorization을 iOS 빌드에서만 호출해요(Unity#if UNITY_IOS· Unreal#if PLATFORM_IOS). 호출하지 않으면 이전처럼 로그인할 때 SDK 가 권한을 요청해요. Android 는 SDK 가 권한을 요청하므로 이 API 가 없어요. - iOS UIScene 을 지원해요.
SceneDelegate 를 쓰는 앱은 SceneDelegate 에서 받은 URL 을 SDK 에 전달해야 해요. 전달하지 않으면 외부 로그인 후 앱으로 돌아오지 않아요. 적용 방법은 엔진별 가이드를 확인해 주세요. (Native iOS · Unity · Unreal)
개선 사항
💡 아래 항목은 게임에서 따로 할 일이 없어요.
- 로그인 후 안내를 서버에서 조정해요.
글로벌 서비스 최적화를 위해 인증 관련 서버 API 를 통합했어요. 약관 재동의 · 기기 등록 · 계정 상태 안내를 SDK 업데이트 없이 조정할 수 있어요. 안내 화면은 SDK UI API 로 연동한 게임에서만 표시돼요. - 일부 Android 기기에서 Google 로그인이 되지 않던 문제를 개선했어요.
특정 기기의 Google 프레임워크 문제로 로그인이 실패하는 경우가 있어, SDK 내부에서 호출하는 Google 로그인 API 를 Google Sign-In(play-services-auth)으로 바꿨어요. 게임의 로그인 호출 방식과 유저가 보는 로그인 화면은 그대로예요.
버그 수정
- iOS 결제가 완료됐는데 실패로 알리던 문제를 고쳤어요.
결제와 검증이 정상적으로 끝났는데도 트랜잭션 종료 단계의 불필요한 오류를 게임에 전달하던 문제예요. - iOS
initialize가 응답 없이 멈추던 문제를 고쳤어요.
앱 버전 등 초기화에 필요한 값이 비어 있을 때 콜백이 오지 않던 문제예요. - 원격 설정을 받지 못했는데
initialize가 성공하던 문제를 고쳤어요.
응답 본문이 깨졌거나, Android 에서 네트워크 오류가 났을 때 이전에 저장된 설정으로 성공 처리하던 문제예요. 이제 실패를 반환하니 재시도나 안내 처리를 확인해 주세요. - iOS 푸시 등록 오류를 고쳤어요.
등록 정보가 바뀌지 않았을 때 콜백이 두 번 오거나, 서버와 등록 정보가 어긋나던 문제예요.
요구 환경
💡 2.9.x 와 같아요. 각 플랫폼(Apple · Google · 엔진)의 정책을 따라요.
| 항목 | 3.0.0 |
|---|---|
| iOS 최소 버전 | 15.0 |
| Android minSdk / targetSdk / compileSdk | 24 / 35 / 35 |
| Android Gradle Plugin / Kotlin / Java | 8.6.1 / 1.9.25 / 17 |
- 개발자센터 이용/스마일게이트 퍼블리싱 게임 관련: stove.developers@smilegate.com
- 스토브 스토어 입점/스토브 스튜디오 관련: store.support@smilegate.com