KakaoGame SDK for Android Upgrade Guide

Upgrading the Android SDK to 3.14.6

kakaoGameSDK

• Supported Android 13

• In SDK 3.14.6, the following actions are required to allow seamless push permission in Android 13.

  • Android 13) Notification runtime permission Document

  • you need to declare in your app's manifest file

    • <uses-permission android:name="android.permission.POST_NOTIFICATIONS"/>

Upgrading the Android SDK to 3.13.3

kakaoGameSDK

• Supported Android 12

• In SDK 3.13.3, you should modify your settings to support Android 12 Behavior.

  • explictly-declared value for android:exported

    • Safer component exporting

    • Changed AndroidManifest.xml

      • Main Activity, AuthCodeHandlerActivity, AgeAuthActivity

        • declare android:exported=”true”

      • KGFirebaseMsgService

        • declare android:exported=”false”

  • Changed compileSdkVersion, targetSdkVersion to 31

  • Changed Android Gradle Plugin Version to 4.0.1 and Gradle Version to 6.1.1

Upgrading the Android SDK from 3.10.x to 3.11.0

kakaoGameSDK

• Changed AndroidManifest.xml

  • added kakao activity

    <!-- 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 -->

  • removed kakao intent-filter

•  

  • removed kakao gameshop activity

    <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" />

  • removed kakao activity

• Upgrade Gradle Version to 5.6.4, Android Gradle Plugin Version to 3.6.1

• Upgrade TargetSDKVersion to 30, minSdkVersion to 19, buildToolVersion to 30.0.3

Upgrading the Android SDK from 3.10.4 to 3.10.6

KakaoGameSDK

• Remove the existing INSTALL_REFERRER setting according to the new Google Install Referrer.

  • Remove the part applied according to <1.2. Android SDK Installation >.

• Add configuration file when using SigninWithApple

  • Developers who want to use the SigninWithApple function add xml file according to <1.2. Android SDK Installation >.

Upgrading the Android SDK from 3.10.2 to 3.10.4

KakaoGameSDK

• The minimum supported version of Gradle has changed with AndroidX migration and library updates.

  • Gradle: 4.6

  • Gradle-tool-version: 3.2.0

  • BuildToolVersion: 28.0.2

• Add AndroidX migration settings to gradle.properties

  • android.useAndroidX=true
    
    

  • android.enableJetifier=true

• Added setting for applying new version of Google ads library

  • Add the value "com.google.android.gms.ads.APPLICATION_ID" to your AndroidManifest.xml file according to the <1.2. Android SDK Installation > guide.

Upgrading the Android SDK from 3.10.1 to 3.10.2

No special steps are required to upgrade to 3.10.2

Upgrading the Android SDK from 3.10.0 to 3.10.1

No special steps are required to upgrade to 3.10.1.

Upgrading the Android SDK from 3.9.6 to 3.10.0

KakaoGameSDK

• Changed Repository, Dependency

  • Check and apply the changed contents according to <SDK environment setting> guide.

• Added Funnels Settings

  • Add the onNewIntent callback by checking out the <Add new Intent Receiving Settings> guide.

  • Developers who added an existing urlPromotion setting do not need to add additional settings.

Upgrading the Android SDK from 3.9.5 to 3.9.6

No special steps are required to upgrade to 3.9.6.

Upgrading the Android SDK from 3.9.4 to 3.9.5

No special steps are required to upgrade to 3.9.5.

Upgrading the Android SDK from 3.9.2 to 3.9.4

No special steps are required to upgrade to 3.9.4.

Upgrading the Android SDK from 3.9.1 to 3.9.2

KakaoGameSDK

• No special steps are required to upgrade to 3.9.2.

Upgrading the Android SDK from 3.9.0 to 3.9.1

No special steps are required to upgrade to 3.9.1.

Upgrading the Android SDK from 3.8.4 to 3.9.0

No special steps are required to upgrade to 3.9.0.

Upgrading the Android SDK from 3.8.1 to 3.8.4

KakaoGameSDK

• No special steps are required to upgrade to 3.8.4.

Guide for Adapting Google Http Connection Policy

• If targetSdkVersion is set to 28 version or higher, and the game using http requires1.2. Android SDK Installation .

• If your game uses Http on targetSdkVerion 28, you have to apply to KakaoGameSDK v3.8.4.

Upgrading the Android SDK from 3.8.0 to 3.8.1

No special steps are required to upgrade to 3.8.1.

Upgrading the Android SDK from 3.7.2 to 3.8.0

KakaoGameSDK

• Removed the user_friends permission when Login Facebook as default. 

• If you need the 'user_friends' permission, you have to add this line '<item>user_posts</item>' for "facebook_read_pemissions" on your 'kakao_game_facebook_auth.xml' file.
  
  

Upgrading the Android SDK from 3.7.1 to 3.7.2

No special steps are required to upgrade to 3.7.1.

Upgrading the Android SDK from 3.6.6 to 3.7.1

KakaoGameSDK

• ADT build support has been discontinued. Developers should build with the Gradle according to1.2. Android SDK Installation .

• The 'showAppInviteDialog' API has been removed as per Facebook policy.

• Developers using the API must refer to the Facebook developer site to implement the feature.

Upgrading the Android SDK from 3.6.3 to 3.6.6

KakaoGameSDK

• On devices with Google Play Service 11.8.0, only new Google sign-in is supported.

• Games using Google login and Google background login must use version 3.6.6 or later.

Upgrading the Android SDK from 3.6.0 to 3.6.3

No special steps are required to upgrade to 3.6.3