버전 비교

버전 이전 버전 12 새 버전 현재
변경한 사람

Eric

KG_SDKDEV

에 저장

키

  • 이 줄이 추가되었습니다.
  • 이 줄이 삭제되었습니다.
  • 서식이 변경되었습니다.
목차
minLevel1
maxLevel6
include
outlinefalse
indent
stylenone
exclude
typelist
class
printabletrue

...

참고사항

권장 버전을 사용하지 않을 경우, 아래와 같은 문제가 있습니다.

  • "USING MEMORYADRESSES FROM MORE THAN 16GB OF MEMORY" 메시지와 함께 앱 실행시 크래쉬가 발생할 수 있습니다. (관련 이슈)

  • 2018.x 버전에서 Android 12 이상 빌드시 검은 화면만 뜨는 버그가 있습니다.

  • gradle이 6.7.1를 사용하게 되면서 특정 유니티 버전 이하에서는 업그레이드가 필요합니다.

...

파일

설명

KakaoGamesSDK.unitypackage

  • 배포되는 unitypackage 파일입니다.

  • 종속 항목이 포함되어 있습니다.

com.kakaogames.sdk-[버전].tgz

  • 배포되는 tgz 파일입니다.

  • 종속 항목이 포함되어 있지 않습니다.

    • https://developers.google.com/unity/archive?hl=ko 종속 항목을 추가해줍니다.

    • EDM, FirebaseApp, FirebaseCrashlytics tgz 파일을 다운받아서 순서대로 설치해주거나 FirebaseCrashlytics.unitypackage를 설치해주어야합니다.

SampleApp.zip

  • 샘플 프로젝트입니다.

ApiReference.zip

  • 카카오게임 Unity SDK의 API 레퍼런스 문서입니다.

3. SDK 설치

3.1. unitypackage 파일로 설치하기

먼저 Unity에서 게임 프로젝트를 오픈합니다.
KakaoGamesSDK.unitypackage를 실행하면, Unity에서 import할 수 있는 메뉴가 뜹니다. 모든 항목이 체크된 상태로 import를 진행합니다.

참고사항

macOS에서 빌드하는 경우 아래와 같은 경고창이 발생할 수 있습니다.

...

? 클릭 > 개인정보 보호 및 보안 설정 열기 클릭 > 확인 없이 허용 클릭 후

...

...

3.1

...

SDK에서 newtonsoft-json을 사용하게 되면서 해당 패키지를 필수로 설치해야 합니다.

프로젝트 루트 디렉토리에서 Packages/manifest.json을 열고 "com.unity.nuget.newtonsoft-json": "3.0.2" 을 추가합니다.

코드 블럭
languagejson
{
  "dependencies": {
    //...
    "com.unity.nuget.newtonsoft-json": "3.0.2"
    }
}

...

.

...

정보

Package Manager로 설치하는 경우 자동으로 설치됩니다.

...

 Package Manager로 설치하기(

...

Scoped Registry)

  1. Window Project Settings - Package Manager를 열어 줍니다Manager - Scoped Registries에 아래와 같이 스코프를 설정해줍니다.

    Image Removed스크린샷 2024-10-16 오후 7.23.22.pngImage Added

  2. Add Package from tarball… 를 통해 종속 패키지를 설치해줍니다.

    Image Removed

  3. EDM, Firebase App, Firebase Crashlytics 순서로 설치해줍니다.

    Image Removed

  4. 마찬가지로 com.kakaogames.sdk-<버전>.tgz 파일로 패키지를 설치해줍니다.

    Image RemovedImage Removed

    Package Manager를 열고 My Registry로 변경후 SDK를 설치합니다.

    스크린샷 2024-10-16 오후 7.24.00.pngImage Added

  5. 시작화면을 띄웁니다.

    스크린샷 2024-10-16 오후 7.16.01.pngImage Added

  6. 필수 플러그인을 설치합니다.

    스크린샷 2024-10-16 오후 7.27.26.pngImage Added

4. 카카오 게임 SDK 설정

...

 

2021.3

2022.3

필수로 사용하는 항목

 

스크린샷 2024-04-25 오후 4.20.09.png

 

 

스크린샷 2024-04-25 오후 4.19.22.png

 

AndroidManifest.xml

SDK 내부 로직에 의해 자동으로 생성됩니다.

SDK 내부 로직에 의해 자동으로 생성됩니다.

mainTemplate.gradle

반드시 체크가 필요하며 필요한 디펜던시스는 EDM에 의해 자동 세팅됩니다.

External Dependency Manager를 통해 Android Dependencies가 세팅됩니다.

반드시 체크가 필요하며 필요한 디펜던시스는 EDM에 의해 자동 세팅됩니다.

External Dependency Manager를 통해 Android Dependencies가 세팅됩니다.

launcherTemplate.gradle

자동생성된 파일에

코드 블럭
apply plugin: 'com.google.firebase.firebase-perf'
apply plugin: 'com.google.firebase.crashlytics'

해당 구문을 추가해야합니다.

자동생성된 파일에

코드 블럭
apply plugin: 'com.google.firebase.firebase-perf'
apply plugin: 'com.google.firebase.crashlytics'

해당 구문을 추가해야합니다.

자동 생성된 파일을 사용하시면 됩니다.

자동 생성된 파일을 사용하시면 됩니다.

baseProjectTemplate.gradle

자동생성된 파일에

코드 블럭
classpath 'com.google.gms:google-services:4.3.3'
classpath 'com.google.firebase:perf-plugin:1.2.0'
classpath 'com.google.firebase:firebase-crashlytics-gradle:2.2.0'

해당 구문을 추가해야합니다.

자동 생성된 파일에

코드 블럭
// Make sure that you have the Google services Gradle plugin dependency
id 'com.google.gms.google-services' version "4.3.15" apply false
// Add the dependency for the Performance Monitoring Gradle plugin
id 'com.google.firebase.firebase-perf' version "1.4.2" apply false
// Add the dependency for the Crashlytics Gradle plugin
id 'com.google.firebase.crashlytics' version "2.9.8" apply false

해당 구문을 추가해야합니다.

gradleTemplate.properties

유니티와 EDM에 의해 자동 생성된 파일을 사용하시면 됩니다.

유니티와 EDM에 의해 자동 생성된 파일을 사용하시면 됩니다.

settingTemplate.gradle

2021.3 버전에는 해당 파일이 없습니다.

자동 생성된 파일을 사용하시면 됩니다.

4.3.2. Permission 설정

Assets/Plugins/Android/AndroidManifest.xml 파일에 게임에서 사용할 permission을 추가할 수 있습니다.

...