{"type":"doc","content":[{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{"minLevel":{"value":"1"},"maxLevel":{"value":"6"},"outline":{"value":"false"},"style":{"value":"none"},"type":{"value":"list"},"printable":{"value":"true"}},"macroMetadata":{"macroId":{"value":"85cc4792-1877-4505-b9fb-a0192ce010a0"},"schemaVersion":{"value":"1"},"title":"목차"}},"localId":"e2b0cbf4-68e2-4e47-849c-1ed391ddcb6c"}},{"type":"rule"},{"type":"heading","attrs":{"level":3},"content":[{"text":"1. Installation Environment","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"IDE: ","type":"text"},{"text":"Android Studio","type":"text","marks":[{"type":"link","attrs":{"href":"https://developer.android.com/studio/"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"JDK: JDK 8 or higher","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Android SDK: Android 14 (API 34)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"OS : Android 6.0, API 23 or higher","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Use Gradle Version 6.1.1","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"2. SDK Environment Setup","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"2.1. build.gradle(project level)","type":"text"}]},{"type":"codeBlock","content":[{"text":"\nbuildscript {\n repositories {\n google()\n mavenCentral()\n }\n dependencies {\n classpath 'com.android.tools.build:gradle:4.0.1'\n // Requires at least version 3.1.2\n classpath 'com.google.gms:google-services:4.3.3'\n }\n}\n \nallprojects {\n repositories {\n google()\n mavenCentral()\n \n maven {\n url 'https://devrepo.kakao.com/nexus/content/groups/public/'\n name 'kakao'\n }\n maven {\n url 'https://s3.ap-northeast-2.amazonaws.com/kakao-sdk-release/release/'\n name 'Kakaogames'\n }\n }\n}\n","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"2.2. gradle.properties","type":"text"}]},{"type":"codeBlock","content":[{"text":"# Project-wide Gradle settings.\norg.gradle.jvmargs=-Xmx4608M\nKAKAO_GAME_SDK_VERSION=4.0.0\n \n# Add the following two settings\nandroid.useAndroidX=true\nandroid.enableJetifier=true","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"2.3. build.gradle(app level)","type":"text"}]},{"type":"paragraph","content":[{"text":"In the build.gradle file of the applied application, selectively configure the necessary modules as shown below.","type":"text"}]},{"type":"codeBlock","content":[{"text":"\napply plugin: 'com.android.application'\n \nandroid {\n ...\n \n // Required to use Java 8 language features\n compileOptions {\n sourceCompatibility JavaVersion.VERSION_1_8\n targetCompatibility JavaVersion.VERSION_1_8\n }\n}\n...\n \ndependencies {\n // Required for games using guest authentication.\n implementation \"com.kakaogame.publishing:idp_device:$KAKAO_GAME_SDK_VERSION\"\n \n // Required for games using Kakao authentication.\n implementation \"com.kakaogame.publishing:idp_kakao:$KAKAO_GAME_SDK_VERSION\"\n \n // Required for games using Apple authentication.\n implementation \"com.kakaogame.publishing:idp_siwa:$KAKAO_GAME_SDK_VERSION\"\n \n // Required to use the main features of the Game SDK.\n implementation \"com.kakaogame.publishing:gamesdk:$KAKAO_GAME_SDK_VERSION\"\n}\n \napply plugin: 'com.google.gms.google-services' // Google Services plugin\n","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"2.4. External Library Dependencies","type":"text"}]},{"type":"paragraph","content":[{"text":"The necessary libraries are set as dependencies with the versions listed below. These are automatically included when connecting to the Kakao Game SDK.","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":1436.0,"localId":"21d87955-aa47-410a-a975-29b46b324a93"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[113.0]},"content":[{"type":"paragraph","content":[{"text":"SDK version","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[176.0]},"content":[{"type":"paragraph","content":[{"text":"Module","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[1147.0]},"content":[{"type":"paragraph","content":[{"text":"External Libraries","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":6,"colwidth":[113.0]},"content":[{"type":"paragraph","content":[{"text":"4.0.1","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[176.0]},"content":[{"type":"paragraph","content":[{"text":"gamesdk","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1147.0]},"content":[{"type":"paragraph","content":[{"text":"com.google.android.gms:play-services-ads-identifier:18.0.0","type":"text"},{"type":"hardBreak"},{"text":"androidx.appcompat:appcompat:1.3.1","type":"text"},{"type":"hardBreak"},{"text":"androidx.legacy:legacy-support-v4:1.0.0","type":"text"},{"type":"hardBreak"},{"text":"androidx.core:core-ktx:1.6.0","type":"text"},{"type":"hardBreak"},{"text":"org.jetbrains.kotlin:kotlin-stdlib-jdk7:1.5.31","type":"text"},{"type":"hardBreak"},{"text":"org.jetbrains.kotlinx:kotlinx-coroutines-core:1.1.0","type":"text"},{"type":"hardBreak"},{"text":"org.jetbrains.kotlinx:kotlinx-coroutines-android:1.1.0","type":"text"},{"type":"hardBreak"},{"text":"androidx.databinding:viewbinding:7.0.4","type":"text"},{"type":"hardBreak"},{"text":"com.google.android.play:review:2.0.0","type":"text"},{"type":"hardBreak"},{"text":"com.google.android.play:app-update:2.0.0","type":"text"},{"type":"hardBreak"},{"text":"com.android.installreferrer:installreferrer:2.2","type":"text"},{"type":"hardBreak"},{"text":"com.github.bumptech.glide:glide:4.10.0","type":"text"},{"type":"hardBreak"},{"text":"androidx.cardview:cardview:1.0.0","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[176.0]},"content":[{"type":"paragraph","content":[{"text":"idp_kakao","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1147.0]},"content":[{"type":"paragraph","content":[{"text":"com.kakao.sdk:{module}:2.13.0","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[176.0]},"content":[{"type":"paragraph","content":[{"text":"idp_facebook","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1147.0]},"content":[{"type":"paragraph","content":[{"text":"com.facebook.android:facebook-android-sdk:14.1.1","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[176.0]},"content":[{"type":"paragraph","content":[{"text":"idp_googlegame","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1147.0]},"content":[{"type":"paragraph","content":[{"text":"com.google.android.gms:play-services-auth:20.6.0","type":"text"},{"type":"hardBreak"},{"text":"com.google.android.gms:play-services-games-v2:17.0.0","type":"text"},{"type":"hardBreak"},{"text":"androidx.annotation:annotation:1.0.0","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[176.0]},"content":[{"type":"paragraph","content":[{"text":"security","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1147.0]},"content":[{"type":"paragraph","content":[{"text":"com.google.android.material:material:1.6.1","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[176.0]},"content":[{"type":"paragraph","content":[{"text":"payment","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1147.0]},"content":[{"type":"paragraph","content":[{"text":"com.android.billingclient:billing:6.0.1","type":"text"},{"type":"hardBreak"},{"text":"androidx.recyclerview:recyclerview:1.0.0","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":7,"colwidth":[113.0]},"content":[{"type":"paragraph","content":[{"text":"4.4.0","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[176.0]},"content":[{"type":"paragraph","content":[{"text":"gamesdk","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1147.0]},"content":[{"type":"paragraph","content":[{"text":"com.google.android.gms:play-services-ads-identifier:18.0.0","type":"text"},{"type":"hardBreak"},{"text":"androidx.appcompat:appcompat:1.6.1","type":"text"},{"type":"hardBreak"},{"text":"androidx.legacy:legacy-support-v4:1.0.0","type":"text"},{"type":"hardBreak"},{"text":"androidx.core:core-ktx:1.10.0","type":"text"},{"type":"hardBreak"},{"text":"org.jetbrains.kotlin:kotlin-stdlib-jdk8:1.8.10","type":"text"},{"type":"hardBreak"},{"text":"org.jetbrains.kotlinx:kotlinx-coroutines-core:1.1.0","type":"text"},{"type":"hardBreak"},{"text":"org.jetbrains.kotlinx:kotlinx-coroutines-android:1.1.0","type":"text"},{"type":"hardBreak"},{"text":"androidx.databinding:viewbinding:7.0.4","type":"text"},{"type":"hardBreak"},{"text":"com.google.android.play:review:2.0.0","type":"text"},{"type":"hardBreak"},{"text":"com.google.android.play:review-ktx:2.0.0","type":"text"},{"type":"hardBreak"},{"text":"com.google.android.play:app-update:2.0.0","type":"text"},{"type":"hardBreak"},{"text":"com.google.android.play:app-update-ktx:2.0.0","type":"text"},{"type":"hardBreak"},{"text":"com.android.installreferrer:installreferrer:2.2","type":"text"},{"type":"hardBreak"},{"text":"com.github.bumptech.glide:glide:4.10.0","type":"text"},{"type":"hardBreak"},{"text":"androidx.cardview:cardview:1.0.0","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[176.0]},"content":[{"type":"paragraph","content":[{"text":"idp_kakao","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1147.0]},"content":[{"type":"paragraph","content":[{"text":"com.kakao.sdk:{module}:2.18.0","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[176.0]},"content":[{"type":"paragraph","content":[{"text":"idp_facebook","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1147.0]},"content":[{"type":"paragraph","content":[{"text":"com.facebook.android:facebook-android-sdk:14.1.1","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[176.0]},"content":[{"type":"paragraph","content":[{"text":"idp_googlegame","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1147.0]},"content":[{"type":"paragraph","content":[{"text":"com.google.android.gms:play-services-auth:20.6.0","type":"text"},{"type":"hardBreak"},{"text":"com.google.android.gms:play-services-games-v2:17.0.0","type":"text"},{"type":"hardBreak"},{"text":"androidx.annotation:annotation:1.0.0","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[176.0]},"content":[{"type":"paragraph","content":[{"text":"security","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1147.0]},"content":[{"type":"paragraph","content":[{"text":"com.google.android.material:material:1.6.1","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[176.0]},"content":[{"type":"paragraph","content":[{"text":"payment","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1147.0]},"content":[{"type":"paragraph","content":[{"text":"com.android.billingclient:billing:6.0.1","type":"text"},{"type":"hardBreak"},{"text":"androidx.recyclerview:recyclerview:1.0.0","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[176.0]},"content":[{"type":"paragraph","content":[{"text":"firebase","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1147.0]},"content":[{"type":"paragraph","content":[{"text":"com.google.firebase:firebase-bom:32.8.1","type":"text"},{"type":"hardBreak"},{"text":"com.google.firebase:firebase-analytics","type":"text"},{"type":"hardBreak"},{"text":"com.google.firebase:firebase-perf","type":"text"},{"type":"hardBreak"},{"text":"com.google.firebase:firebase-crashlytics","type":"text"},{"type":"hardBreak"},{"text":"com.google.firebase:firebase-messaging","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":" If the game uses external libraries that overlap with the above libraries and dependencies, you can remove the conflicting links as shown below and use the higher version.","type":"text"}]},{"type":"paragraph","content":[{"text":"build.gradle(app level)","type":"text","marks":[{"type":"strong"}]}]},{"type":"table","attrs":{"layout":"default","width":1800.0,"localId":"b1ce9124-8938-4dde-84f0-0a3a04fec400"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1,"colwidth":[760.0]},"content":[{"type":"codeBlock","content":[{"text":"\ndependencies {\n ...\n implementation ('com.kakaogame:gamesdk:{KAKAO_SDK_VERSION}') {\n exclude group: 'com.google.android.gms', module: 'play-services-ads' // The library you want to remove\n exclude group: 'com.android.support' // You can also remove the entire group of libraries. This can be adjusted if there is a build error due to version mismatches in support libraries.\n ...\n }\n}\n","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":" Below is an example of changing the Facebook SDK version to the desired version in the game.","type":"text"}]},{"type":"paragraph","content":[{"text":"build.gradle(app level)","type":"text","marks":[{"type":"strong"}]}]},{"type":"table","attrs":{"layout":"default","width":1800.0,"localId":"85e92ed7-7cd7-4b72-a05b-0086442eadb0"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1,"colwidth":[760.0]},"content":[{"type":"codeBlock","content":[{"text":"\ndependencies {\n ...\n implementation ('com.kakaogame:idp_facebook:{KAKAO_SDK_VERSION}') {\n exclude group: 'com.facebook.android', module: 'facebook-android-sdk'\n }\n \n implementation 'com.facebook.android:facebook-android-sdk:4.39.0'\n}\n","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"If your development team does not use Crashlytics, you can remove it as shown below.","type":"text"}]},{"type":"paragraph","content":[{"text":"build.gradle(app level)","type":"text","marks":[{"type":"strong"}]}]},{"type":"table","attrs":{"layout":"default","width":1800.0,"localId":"1b3fef1a-7a12-453e-b0ac-9199aabfc40a"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1,"colwidth":[760.0]},"content":[{"type":"codeBlock","content":[{"text":"\ndependencies {\n ...\n implementation (\"com.kakaogame:firebase:$KAKAO_GAME_SDK_VERSION\") {\n exclude group: 'com.crashlytics.sdk.android', module: 'crashlytics'\n }\n}\n","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"3. IDP Authentication Information Setup","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"3.1. Kakao Authentication Information Setup","type":"text"}]},{"type":"paragraph","content":[{"text":"Add the following resource file and set the values in src/main/res/values/kakao_game_kakao_auth.xml.","type":"text"}]},{"type":"paragraph","content":[{"text":"The value for \"Kakao App Key\" needs to be replaced with the issued key.","type":"text"}]},{"type":"paragraph","content":[{"text":"res/values/kakao_game_kakao_auth.xml","type":"text","marks":[{"type":"strong"}]}]},{"type":"table","attrs":{"layout":"default","width":1800.0,"localId":"cb2ce20a-3735-45ee-8342-59da8d958b68"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1,"colwidth":[760.0]},"content":[{"type":"codeBlock","content":[{"text":"\n\n \n\n [Kakao App Key]\n kakao[Kakao App Key]\n kakaotalk\n kakaolink\n kakaostory\n\n","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"3.2. SigninWithApple Authentication Information Setup","type":"text"}]},{"type":"paragraph","content":[{"text":"Add the following resource file and set the values in src/main/res/values/kakao_game_siwa_auth.xml.","type":"text"}]},{"type":"paragraph","content":[{"text":"The value for \"SIWA Client ID\" needs to be replaced with the issued key from Apple.","type":"text"}]},{"type":"paragraph","content":[{"text":"res/values/kakao_game_siwa_auth.xml","type":"text","marks":[{"type":"strong"}]}]},{"type":"table","attrs":{"layout":"default","width":1800.0,"localId":"94918782-077a-47c3-823f-cf1cfc81b7c4"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1,"colwidth":[760.0]},"content":[{"type":"codeBlock","content":[{"text":"\n\n\n [SIWA Client ID]\n\n","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"4. AndroidManifest.xml File Configuration","type":"text"}]},{"type":"paragraph","content":[{"text":"The AndroidManifest.xml file of the game app must be configured with the following settings.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"4.1. Common Settings","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Set the minimum supported SDK version to 23 or higher","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"android:minSdkVersion=\"23\"","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Set the SDK target version to 31.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Explicit declaration for android:exported is required.","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The SDK commonly uses the following permissions","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"android.permission.INTERNET","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"android.permission.ACCESS_NETWORK_STATE","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Add settings for handling multiple screens.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"To support screen splitting on Android phones and foldable phones, add the following to the application settings.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"android:resizeableActivity=\"true\"","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Add the following to each added Activity.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"android:configChanges=\"orientation|screenSize|keyboard|screenLayout|screenSize|smallestScreenSize\"","type":"text"}]}]}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"For API 23 and above, you can specify whether the app uses cleartext network traffic, such as plain text HTTP.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"android:usesCleartextTraffic=\"true\"","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Add URLScheme","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The main Activity of the game should include the following intent filter settings.","type":"text"}]},{"type":"paragraph","content":[{"text":"The scheme is composed of \"kakaogame\" + the app ID. (For example, if the app ID is 123456, the scheme value will be \"kakaogame123456\")","type":"text"}]}]}]}]}]},{"type":"paragraph","content":[{"text":"AndroidManifest.xml (Common Settings)","type":"text","marks":[{"type":"strong"}]}]},{"type":"table","attrs":{"layout":"default","width":1800.0,"localId":"90fd7ca2-bd3f-49a9-a2d6-3540d199be20"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1,"colwidth":[760.0]},"content":[{"type":"codeBlock","content":[{"text":"\n\n\n\n\n\n \n\n\n\n\n \n\n \n \n \n \n \n \n\n \n \n \n \n \n \n ...\n \n \n\n\n","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"4.2. Kakao Authentication Configuration","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The main Activity must include the following intent filter declaration.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"You need to declare AuthCodeHandlerActivity and add its intent filter.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"For Android 12, the exported attribute must be explicitly declared.","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"paragraph","content":[{"text":"AndroidManifest.xml (Kakao Authentication Configuration)","type":"text","marks":[{"type":"strong"}]}]},{"type":"table","attrs":{"layout":"default","width":1800.0,"localId":"fa35854d-57ca-4c57-b277-9450088bacbf"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1,"colwidth":[760.0]},"content":[{"type":"codeBlock","content":[{"text":"\n\n\n\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n\n\n","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"4.3. HTTP Usage Configuration","type":"text"}]},{"type":"paragraph","content":[{"text":"If targetSdkVersion is set to version 28 or higher and the game uses HTTP communication, the following configuration is necessary.","type":"text"}]},{"type":"paragraph","content":[{"text":"The Kakao Game SDK does not use HTTP internally. This setting is only needed if the developer requires HTTP calls for issues like CDN.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Setting the domain that requires HTTP calls","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Create the res/xml/network_security_config.xml file and add the domain that requires HTTP communication.","type":"text"}]},{"type":"paragraph","content":[{"text":"network_security_config.xml","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":"\n\n\n \n \n example.com\n \n\n","type":"text"}]},{"type":"paragraph"}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In the Application section of the AndroidManifest.xml, set the file created above as networkSecurityConfig.","type":"text"}]},{"type":"paragraph","content":[{"text":"AndroidManifest.xml","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":"\n\n","type":"text"}]}]}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"4.4. Game Supported Language Resources","type":"text"}]},{"type":"paragraph","content":[{"text":"If there are additional language packs in the library that are not supported by the game, and you want to remove them, you can delete the corresponding folder at the location below.","type":"text"}]},{"type":"paragraph","content":[{"text":"For example, if you want to remove the Japanese language settings, delete the KakaoGameSDK>res>values-ja folder.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"5. Key Hash Verification and Registration Method","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"To build the app, you need to register the key hash of the build machine, and you can check the key hash using the following method.","type":"text"}]},{"type":"paragraph","content":[{"text":"Obtain the debug key hash and release key hash according to the guide below and register them in the [Game Center > Game Management > Key Hash Registration] menu.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"5.1. Obtaining the Debug Key Hash","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"When you install the Android SDK, a development certificate is stored in the debug.keystore file under the alias androiddebugkey. The method to verify the certificate is as follows. (Note: This is not the actual method to obtain the key hash.)","type":"text"}]},{"type":"codeBlock","content":[{"text":"\nkeytool -exportcert -alias androiddebugkey -keystore {debug_keystore_path} -storepass android -keypass android\n","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The key hash that needs to be registered in the keystore should be obtained by performing the following command.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"This must be executed on the machine where the sample was built.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Please use OpenSSL version 1.0.2 or higher.","type":"text"}]}]}]},{"type":"codeBlock","content":[{"text":"\n keytool -exportcert -alias androiddebugkey -keystore {debug_keystore_path} -storepass android -keypass android | openssl sha1 -binary | openssl base64\n","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The above method is guaranteed to work on Linux, but may not provide correct values in a Windows environment.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If you encounter key hash errors, try the following method as well.","type":"text"}]}]}]},{"type":"codeBlock","content":[{"text":"\nkeytool -exportcert -alias androiddebugkey -keystore {debug_keystore_path} > ./debug.txt\nopenssl sha1 -binary debug.txt > debug_sha.txt\nopenssl base64 -in debug_sha.txt > debug_base64.txt\n","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"[debug_keystore_path]","type":"text","marks":[{"type":"strong"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"OS X and Linux: You can check it under Eclipse \"ADT > Preferences > Android > Build > Default debug keystore\". (e.g., ~/.android/debug.keystore)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Windows: You can check it under Eclipse \"Window > Preferences > Android > Build > Default debug keystore\".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Windows Vista and Windows 7: (e.g., C:\\Users\\.android\\debug.keystore)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Windows XP: (e.g., C:\\Documents and Settings\\.android\\debug.keystore)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"keytool is located under $JAVA_HOME/bin.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"For Windows, you will need to download and install OpenSSL.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"5.2. Obtaining the Release Key Hash","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":1800.0,"localId":"6d16f835-b158-4361-b893-e2e9f9dd8162"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"background":"#f0f0f0","rowspan":1,"colwidth":[760.0]},"content":[{"type":"codeBlock","content":[{"text":"\nkeytool -exportcert -alias [release_key_alias] -keystore [release_keystore_path] | openssl sha1 -binary | openssl base64\n","type":"text"}]}]}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Checking for invalid android_key_hash Errors","type":"text","marks":[{"type":"strong"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If you continue to receive errors after registering the key hash in the Game Center, you can verify whether you are using the correct key hash as follows:","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Temporarily modify the onCreate() method in the MainActivity class in the game as follows.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"MainActivity","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":"\n@Override\npublic void onCreate(Bundle savedInstanceState) {\n super.onCreate(savedInstanceState);\n \n // Add code to print out the key hash\n try {\n android.content.pm.Signature[] signatures;\n if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.P) {\n PackageInfo packageInfo = getPackageManager().getPackageInfo(packageName, PackageManager.GET_SIGNING_CERTIFICATES);\n if (packageInfo == null\n || packageInfo.signingInfo == null) {\n Log.e(\"KeyHash:\", \"KeyHash is Null. \");\n }\n if(packageInfo.signingInfo.hasMultipleSigners()){\n signatures = packageInfo.signingInfo.getApkContentsSigners();\n } else {\n signatures = packageInfo.signingInfo.getSigningCertificateHistory();\n }\n } else {\n PackageInfo info = getPackageManager().getPackageInfo(packageName, PackageManager.GET_SIGNATURES);\n signatures = info.signatures;\n }\n\n for (android.content.pm.Signature signature : signatures) {\n MessageDigest md = MessageDigest.getInstance(\"SHA\");\n md.update(signature.toByteArray());\n Log.e(\"KeyHash:\", Base64.encodeToString(md.digest(), Base64.DEFAULT));\n }\n } catch (PackageManager.NameNotFoundException e) {\n e.printStackTrace();\n } catch (NoSuchAlgorithmException e) {\n e.printStackTrace();\n }\n}\n","type":"text"}]},{"type":"paragraph","content":[{"text":"Run the above code and check the key hash from the message displayed in the Logcat output as follows.","type":"text"}]}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"6. Build Verification","type":"text"}]},{"type":"paragraph","content":[{"text":"Verify that the project builds successfully.","type":"text"}]}],"version":1}

지원되지 않는 브라우저