📘

Hackle Unity SDK는 Android SDK, iOS SDK 를 기반으로 작동합니다. 아래 OS를 지원합니다.

• Android API 16 (4.1 Jelly Bean) 이상
• iOS 10 이상

❗️

Unity Editor

Unity SDK는 Desktop이나 Editor를 지원하지 않습니다.

SDK 설치

Unity Package Manager를 통해 SDK 설치가 필요합니다.

여기를 클릭하여, SDK를 다운로드 받습니다.

Unity에서 Assets > Import Package > Custom Package를 클릭합니다.
다운받은 package를 선택하고, import 하면 설치가 완료됩니다.

Android ProGuard / R8

ProGuard, R8을 사용하는 경우, aar 아티팩트에 난독화 규칙이 자동으로 포함됩니다. 이 경우가 아니라면 아래 규칙을 포함시켜야 합니다.

-keep class io.hackle.android.** { *; }
-keep class io.hackle.sdk.** { *; }

📘

SDK 설치 후 앱 재설치

Unity SDK는 Android, iOS SDK가 포함되어 있습니다.
기존에 테스트 중이던 앱을 새롭게 빌드해야 연동이 완료됩니다.

업데이트 시 유의사항

업데이트를 하시는 경우, 기존 import 된 라이브러리 중 위의 선택된 라이브러리 삭제 후 다시 import 작업을 진행해야합니다.

• hackle-android-sdk-x.x.x
• hackle-android-unity-wrapper-x.x.x
• hackle-sdk-common-x.x.x
• hackle-sdk-core-x.x.x
• ios-arm64_armv7
• ios-arm64_i386_x86_64-simulator

Android SDK 의존성 관리

Android에서는 아래와 같은 의존성 라이브러리를 가지고 있습니다.
Unity SDK가 Android 환경에서 동작을 하지 않는 경우 아래 라이브러리가 존재하는지 확인이 필요합니다.

• hackle-android-sdk-2.12.0
• hackle-android-unity-wrapper-1.5.0
• hackle-sdk-common-2.9.0
• hackle-sdk-core-2.9.0
• core-common
• gson
• kotlin-stdlib
• lifecycle-common
• lifecycle-extensions
• lifecycle-process
• lifecycle-runtime
• okhttp
• okio

SDK 초기화

SDK를 사용하기 위해서 반드시 Hackle을 초기화 해야 합니다. Hackle을 초기화 하기 위해 SDK 키가 필요합니다.

• Hackle은 SDK의 기능을 사용하기 위한 메소드들을 제공하는 클래스입니다.
• Initialize() 메소드에 SDK 키를 전달하여 초기화하고, 초기화 완료 시까지 기다리기 위해 await를 합니다.
• SDK 키는 핵클 서비스의 대시보드 안에 위치한 SDK 연동 정보에서 확인하실 수 있습니다.

using System.Collections;
using System.Collections.Generic;
using UnityEngine;

public class HackleInit : MonoBehaviour
{
    async void Awake () {
        await Hackle.Initialize(YOUR_APP_SDK_KEY);
    }
}

초기화 설정정보

설정정보를 포함하여 SDK를 초기화 할 수 있습니다.

using System.Collections;
using System.Collections.Generic;
using UnityEngine;

public class HackleInit : MonoBehaviour
{
    async void Awake () {
      HackleConfig config = new HackleConfig.Builder()
        .Build();
      await Hackle.Initialize("YOUR_APP_SDK_KEY", config: config);
    }
}

모든 설정 옵션

인스턴스 가져오기

초기화 이후 아래 코드를 통해 Hackle 인스턴스를 가져올 수 있습니다.

using System.Collections;
using System.Collections.Generic;
using UnityEngine;

Hackle hackle = Hackle.GetInstance();