Skip to content
스토브
마지막 업데이트

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.02.9.x
StoveSGSBase SGSLog SGSAuth SGSAuthUI SGSView
StoveProvidersSGSAuthApple SGSAuthFacebook SGSAuthGoogle SGSAuthNaver SGSAuthLine SGSAuthSteam
StoveIAP2SGSIAP2
StovePushSGSPush
StovePushExtensionSGSPushExtension (알림 서비스 익스텐션)
StoveGameLog (신규)(기본 모듈에 포함)
제거 (대체 모듈 없음)SGSGamingServices

Android (Gradle 좌표, 그룹은 모두 com.stove)

3.0.02.9.x
stovebase log auth auth-ui view
stove-providersauth-google auth-googleplaygames auth-facebook auth-naver auth-line auth-steam auth-apple
stove-iapiap
stove-iap-googleiap-google
stove-iap-huaweiiap-huawei
stove-iap-onestoreiap-onestore
stove-pushpush
stove-push-firebasepush-firebase
stove-push-huaweipush-huawei
stove-gamelog (신규)(기본 모듈에 포함)
제거 (대체 모듈 없음)gamingservices
  • StoveGameLog · stove-gamelog 는 게임 로그를 쓰는 게임만 추가해요.
  • SGSGamingServices · gamingservices 는 의존성에서 빼기만 하면 돼요. GPG User ID 기능은 StoveProviders 에 들어 있어요.
자세히 보기 — 플랫폼별로 바뀌는 코드
플랫폼바뀌는 것그대로인 것
AndroidGradle 좌표import 패키지 (com.stove.auth… 등)
iOSpod 이름, #import 경로 (<SGSAuth/SGSAuth.h> → <Stove/Stove.h>, Swift 는 import Stove)클래스 이름 (SGSAuth 등), 헤더 파일 이름
Unity.unitypackage 구성, Podfile · mainTemplate.gradleC# using Stove.StoveSDK, 인증 · 결제 · 푸시 호출 코드
Unreal.uproject · *.Build.cs · _APL.xml 의 플러그인 목록헤더 #include, stove:: 호출 코드

2. 점검 · 제재 · 강제 업데이트 때 앱 종료를 게임에서 처리해요.

이제 SDK 가 안내 화면을 닫을 때 앱을 강제로 종료하지 않아요. 결과의 State 를 보고 앱을 종료하거나 진행을 막아 주세요.

⚠️ 처리하지 않으면 유저가 안내 화면을 닫은 뒤에도 게임을 계속 진행할 수 있어요.

📌 처리 방법과 플랫폼별 코드는 점검/업데이트 가이드의 "앱 종료 처리 (3.0.0 이상)" 를 확인해 주세요.

3. 게임 로그를 쓴다면 코드 수정이 필요해요.

게임 로그가 별도 모듈로 분리되었어요. 의존성을 추가하고, 게임 로그를 쓰기 전에 GameLog.Configure 를 한 번 호출해야 해요.

📌 수정 방법은 담당 기술 PL 에게 문의해 주세요.

자세히 보기 — 추가할 의존성 · 바뀐 API

추가할 의존성

플랫폼의존성
Androidcom.stove:stove-gamelog
iOSStoveGameLog pod
UnityStoveGameLog 패키지
UnrealStoveGameLog 플러그인

바뀐 API

  • GameLog.Configure 가 추가되었어요. 게임 로그를 쓰기 전에 한 번 호출해요.
  • GameLog.Add 의 콜백 타입이 Result 에서 GameLogResult 로 바뀌었어요.
  • Android 는 패키지가 com.stove.log.game 에서 com.stove.gamelog.domain 으로 바뀌었고, add · flush 에서 Context 인자가 빠졌어요.

4. 로그인 오류 코드로 분기한다면 원인 코드 확인 방식을 바꿔요.

로그인 실패 시 60000번대 오류 코드가 올 수 있어요. Data API · SDK UI API(AuthUI 등) 연동 방식과 관계없이, 오류 코드로 분기해 후속 처리(로그아웃 등)를 하는 코드가 있다면 원인 코드를 origin_code 에서 확인하도록 바꿔요. 오류 코드로 분기하지 않는 게임은 할 일이 없어요. 적용 예시는 로그인(이용자 흐름) 의 통합 로그인 코드를 참고해 주세요.

📌 60000번대 오류 코드 전체 목록은 에러 코드 통합 > Mobile SDK > 3.0.0 신규 오류 코드에서 확인할 수 있어요.

자세히 보기 — 원인 코드 확인
  • 원래 원인 코드는 결과의 userInfo["origin_code"] 에 담겨요.
  • 오류 코드로 분기하는 코드가 있다면 60000번대 코드와 origin_code 를 함께 확인해요.
  • 아래 표에 없는 기존 오류 코드는 신규 오류 코드 60000 으로 와요. 기존 코드는 origin_code 에 그대로 담겨요. 예: 10124, 11300, 44052.
  • 같은 기존 오류 코드라도 로그인 방식에 따라 신규 오류 코드가 달라질 수 있어요.
신규 오류 코드기존 오류 코드설명
6020013004정회원 전환 실패 (이미 사용 중인 계정)
60003406710게임 탈퇴 진행
6000141005토큰 오류
6000241006토큰 오류
6000141007이메일 로그인 실패 (미가입 회원)
6030041007써드파티 로그인, 회원가입 필요 (미가입 회원)
6000143000이메일 로그인 실패 (미등록 이메일)
6030043000써드파티 로그인, 회원가입 필요 (미등록 이메일)
6000143002비밀번호 5회 이상 오류
6030443002캡챠 필요 (비밀번호 5회 이상 오류)
6010043101로그인 제재
6010043102반복 로그인 실패로 차단
6010043103중복 로그인 제재
6010043104서비스 이용 제한
6000344000비활성화 계정
6000344001탈퇴 신청
6000344002탈퇴 완료
6000344004해외 로그인 차단
6020045000이미 연동된 계정
6020045004이미 메인으로 사용 중
6040045006GUID 미등록
6030145006게임 가입 필요
6020045011이미 서브로 사용 중

5. MemberNo 게임이라면 enable_guid 를 false 로 설정해요.

MemberNo 게임 식별을 위해 아래 설정이 필요해요. GUID 게임은 할 일이 없어요.

플랫폼설정 위치키값
AndroidAndroidManifest.xml 의 <application> meta-datacom.stove.config.enable_guidfalse
iOSInfo.plistStoveEnableGUID (Boolean)NO
자세히 보기 — 설정 예시

Android

AndroidManifest.xml 의 <application> 안에 추가해요.

xml
<meta-data
    android:name="com.stove.config.enable_guid"
    android:value="false" />

iOS

앱 타겟의 Info.plist 에 추가해요.

xml
<key>StoveEnableGUID</key>
<false/>

새로운 기능

  • 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 / compileSdk24 / 35 / 35
Android Gradle Plugin / Kotlin / Java8.6.1 / 1.9.25 / 17



문의가 필요하신가요?