KakaoGameSDK Android 업그레이드 가이드

Android SDK를 3.17.0으로 업그레이드

kakaoGameSDK

기존 AgeAuthActivity 설정을 사용하셨던 경우, 패키지명 변경이 필요합니다.

<!-- KakaoGame SDK Auth START -->
    <!-- auth 패키지에서 user 패키지로 변경 -->
    <activity android:name="com.kakao.sdk.partner.user.AgeAuthActivity"
              android:exported=”true”>
        <intent-filter>
            <action android:name="android.intent.action.VIEW" />
            <category android:name="android.intent.category.DEFAULT" />
            <category android:name="android.intent.category.BROWSABLE" />
            <data android:host="ageauth" android:scheme="@string/kakao_scheme" />
        </intent-filter>
    </activity>
<!-- KakaoGame SDK Auth END-->

Android SDK를 3.16.0으로 업그레이드

kakaoGameSDK

KGAuthActivity 는 내부 라이브러리에서 자동으로 포함됩니다. 기존에 사용하셨던 경우 설정을 제거합니다.

<!-- 기존 설정된 KGAuthActivity 설정 제거 -->
<!-- KakaoGame SDK Auth START -->
<activity
	android:name="com.kakaogame.KGAuthActivity"
	android:configChanges="orientation|screenSize|keyboard|screenLayout|screenSize|smallestScreenSize"
	android:theme="@android:style/Theme.Translucent.NoTitleBar" />
<!-- KakaoGame SDK Auth END-->

Android SDK를 3.13.3으로 업그레이드

kakaoGameSDK

Android 12 대응
3.13.3 버전에서는 Android 12에 대응하기 위해 타겟 SDK 버전을 31로 올리면서 일부 작업이 필요합니다.
- android:exported 명시적 선언
  - 안드로이드 문서
  - AndroidManifest.xml 수정
    - 메인 액티비티, AuthCodeHandlerActivity, AgeAuthActivity
      - android:exported=”true” 선언
    - KGFirebaseMsgService
      - android:exported=”false” 선언
- compileSdkVersion, targetSdkVersion 31 로 변경
- Android Gradle Plugin Version 4.0.1, Gradle Version 6.1.1 이상으로 변경Android SDK를 3.10.x 버전에서 3.11.0 버전으로 업그레이드

Android SDK를 3.10.x 버전에서 3.11.0 버전으로 업그레이드

kakaoGameSDK

AndroidManifest.xml 수정

카카오 액티비티 추가

<!-- Kakao Auth START -->

<activity android:name="com.kakao.sdk.auth.AuthCodeHandlerActivity">
 <intent-filter>
 <action android:name="android.intent.action.VIEW" />

 <category android:name="android.intent.category.DEFAULT" />
 <category android:name="android.intent.category.BROWSABLE" />

 <data android:host="oauth" android:scheme="@string/kakao_scheme" />
 </intent-filter>
</activity>

<activity android:name="com.kakao.sdk.partner.auth.AgeAuthActivity">
 <intent-filter>
 <action android:name="android.intent.action.VIEW" />

 <category android:name="android.intent.category.DEFAULT" />
 <category android:name="android.intent.category.BROWSABLE" />

 <data android:host="ageauth" android:scheme="@string/kakao_scheme" />
 </intent-filter>
</activity>
<!-- Kakao Auth END -->

기존 카카오 인텐트 필터 삭제

<intent-filter>
<action android:name="android.intent.action.VIEW" />

게임샵 액티비티 삭제

<activity
 android:name="com.kakao.gameshop.sdk.KakaoPaymentActivity"
 android:launchMode="singleTop"
 android:screenOrientation="portrait"
 android:configChanges="keyboard|keyboardHidden|screenLayout|screenSize|orientation"
 android:windowSoftInputMode="adjustResize" />
<activity
 android:name="com.kakao.gameshop.sdk.KakaoPaymentListActivity"
 android:launchMode="singleTop"
 android:screenOrientation="portrait"
 android:configChanges="keyboard|keyboardHidden|screenLayout|screenSize|orientation"
 android:windowSoftInputMode="adjustResize" />
<activity
 android:name="com.kakao.gameshop.sdk.ResultOfBankaActivity"
 android:launchMode="singleTask"
 android:configChanges="keyboard|keyboardHidden|screenLayout|screenSize|orientation">
 <intent-filter>
 <data
 android:host="success_order"
 android:scheme="kakaogameshop20150801" />
 <data
 android:host="cancel_order"
 android:scheme="kakaogameshop20150801" />

 <action android:name="android.intent.action.VIEW" />

 <category android:name="android.intent.category.BROWSABLE" />
 <category android:name="android.intent.category.DEFAULT" />
 </intent-filter>
</activity>

<activity
 android:name="com.kakao.reach.ingame.ui.IngameWebViewActivity"
 android:configChanges="keyboard|keyboardHidden|screenLayout|screenSize|orientation"
 android:screenOrientation="sensor" />
<activity
 android:name="com.kakao.reach.ingame.ui.PlusFriendActivity"
 android:configChanges="keyboard|keyboardHidden|screenLayout|screenSize|orientation"
 android:screenOrientation="portrait" />

기존 카카오 액티비티 삭제

<activity
android:name="com.kakao.auth.authorization.authcode.KakaoWebViewActivity"
android:label="@string/com_kakao_login_button"
android:launchMode="singleTop"
android:configChanges="orientation|screenSize"
android:theme="@style/Theme.Transparent"
android:windowSoftInputMode="adjustResize">
</activity>

<meta-data
android:name="com.kakao.sdk.AppKey"
android:value="@string/kakao_app_key" >
</meta-data>

Gradle Version 5.6.4, Android Gradle Plugin Version 3.6.1로 변경
TargetSDKVersion 30, minSdkVersion 19, buildToolVersion 30.0.3으로 변경

Android SDK를 3.10.4 버전에서 3.10.6 버전으로 업그레이드

KakaoGameSDK

신규 구글 인스톨 레퍼러 적용에 따라 기존 INSTALL_REFERRER 설정을 제거합니다.
- <초대 이벤트 설정>에 따라 적용했던 부분을 제거합니다.
SigninWithApple 사용 시 설정 파일 추가
- SigninWithApple 기능을 사용하고자 하는 개발사에서는 <SigninWithApple 인증 정보 설정>에 따라 xml파일을 추가합니다.

Android SDK를 3.10.2 버전에서 3.10.4 버전으로 업그레이드

KakaoGameSDK

AndroidX 마이그레이션 진행 및 라이브러리 업데이트로 Gradle 최소 지원 버전이 변경되었습니다.
- Gradle: 4.6
- Gradle-tool-version: 3.2.0
- BuildToolVersion: 28.0.2
gradle.properties에 AndroidX 마이그레이션 설정 추가
- android.useAndroidX=true
- android.enableJetifier=true
구글 ads 라이브러리 신규 버전 정책에 따른 설정 추가
- <ADID 를 얻기 위한 구글 설정> 가이드에 따라 AndroidManifest.xml 파일에 'com.google.android.gms.ads.APPLICATION_ID' 값을 추가합니다.

Android SDK를 3.10.1 버전에서 3.10.2 버전으로 업그레이드

3.10.2 버전으로 업그레이드하는 데는 별도의 단계가 필요 없습니다.

Android SDK를 3.10.0 버전에서 3.10.1 버전으로 업그레이드

3.10.1 버전으로 업그레이드하는 데는 별도의 단계가 필요 없습니다.

Android SDK를 3.9.6 버전에서 3.10.0 버전으로 업그레이드

KakaoGameSDK

Repository, Dependency 추가
- < https://kakaogames.atlassian.net/wiki/spaces/KS3GFC/pages/413893728/1.2.1+Android+SDK+Gradle+3.7.0#1.2.3.-SDK-%ED%99%98%EA%B2%BD-%EC%84%A4%EC%A0%95 > 가이드에 따라 'kakao' 저장소를 추가합니다.
유입경로 확인용도 셋팅 추가
- <https://kakaogames.atlassian.net/wiki/spaces/KS3GFC/pages/413828673/1.1+SDK#1.1.5.-%EC%83%88%EB%A1%9C%EC%9A%B4-Intent-%EB%B0%9B%EA%B8%B0-%EC%84%A4%EC%A0%95-%EC%B6%94%EA%B0%80%ED%95%98%EA%B8%B0(%EC%95%88%EB%93%9C%EB%A1%9C%EC%9D%B4%EB%93%9C%EB%A7%8C-%ED%95%B4%EB%8B%B9) > 가이드를 확인하여 onNewIntent 콜백을 추가합니다.
- 기존 urlPromotion 설정을 추가했던 개발사에서는 따로 설정을 추가하실 필요가 없습니다.

Android SDK를 3.9.5 버전에서 3.9.6 버전으로 업그레이드

3.9.6 버전으로 업그레이드하는 데는 별도의 단계가 필요 없습니다.

Android SDK를 3.9.4 버전에서 3.9.5 버전으로 업그레이드

3.9.5 버전으로 업그레이드하는 데는 별도의 단계가 필요 없습니다.

Android SDK를 3.9.2 버전에서 3.9.4 버전으로 업그레이드

3.9.4 버전으로 업그레이드하는 데는 별도의 단계가 필요 없습니다.

Android SDK를 3.9.1 버전에서 3.9.2 버전으로 업그레이드

3.9.2 버전으로 업그레이드하는 데는 별도의 단계가 필요 없습니다.

Android SDK를 3.9.0 버전에서 3.9.1 버전으로 업그레이드

3.9.1 버전으로 업그레이드하는 데는 별도의 단계가 필요 없습니다.

Android SDK를 3.8.4 버전에서 3.9.0 버전으로 업그레이드

3.9.0 버전으로 업그레이드하는 데는 별도의 단계가 필요 없습니다.

Android SDK를 3.8.1 버전에서 3.8.4 버전으로 업그레이드

KakaoGameSDK

3.8.4 버전으로 업그레이드하는 데는 별도의 단계가 필요 없습니다.

구글 정책 변경에 따른 설정 가이드

TargetSDK 28을 설정하는 게임에서 Http 콜 사용시https://kakaogames.atlassian.net/wiki/spaces/KS3GFC/pages/413893728/1.2.1+Android+SDK+Gradle+3.7.0#1.2.5.12.-Http-%EC%82%AC%EC%9A%A9-%EC%84%A4%EC%A0%95 가이드에 따라 설정을 추가합니다.
Http 설정 추가가 필요한 경우 KakaoGameSDK 3.8.4 버전 이상을 사용해야 합니다.

Android SDK를 3.8.0 버전에서 3.8.1 버전으로 업그레이드

3.8.1 버전으로 업그레이드하는 데는 별도의 단계가 필요 없습니다.

Android SDK를 3.7.2 버전에서 3.8.0 버전으로 업그레이드

KakaoGameSDK

페이스북 로그인 시 user_friends 권한이 삭제되었습니다.
user_friends 가 필요한 개발사에서는 kakao_game_facebook_auth.xml 파일 내 "facebook_read_pemissions" 항목에 <item>user_posts</item> 을 추가하여 사용합니다.

Android SDK를 3.7.1 버전에서3.7.2 버전으로 업그레이드

3.7.1 버전으로 업그레이드하는 데는 별도의 단계가 필요 없습니다.

Android SDK를 3.6.6 버전에서 3.7.1 버전으로 업그레이드

KakaoGameSDK

ADT 빌드 지원이 중단되었습니다. 개발사에서는 SDK 설치 가이드에 따라 Gradle 빌드로 빌드해야 합니다.\
페이스북 정책에 따라 showAppInviteDialog API가 제거 되었습니다.
해당 API를 사용하고 있는 개발사는 페이스북 개발자 사이트를 참조하여 해당 기능을 구현해야 합니다.

Android SDK를 3.6.3 버전에서 3.6.6 버전으로 업그레이드

KakaoGameSDK

구글 플레이 서비스 11.8.0 가 설치된 기기에서는 신규 구글 로그인만 지원됩니다.
구글 로그인 및 구글 백그라운드 로그인을 사용하는 게임에서는 반드시 3.6.6 버전 이상을 사용해야 합니다.

Android SDK를 3.6.0 버전에서 3.6.3 버전으로 업그레이드

3.6.3 버전으로 업그레이드하는 데는 별도의 단계가 필요 없습니다.