Unity

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

• Android API 16 (4.1 Jelly Bean) 이상

• iOS 10 이상

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);
    }
}

모든 설정 옵션

설정	기능	기본값	지원 버전
ExposureEventDedupIntervalMillis*	동일한 사용자가 연속으로 발생시킨 동일한 A/B 테스트, 기능플래그 분배결과에 대한 노출 이벤트를 제거합니다.	60000 (1분)	1.7.0+
Debug	모든 기능에 대한 로그를 콘솔에 출력하고, 이벤트를 즉시 전송합니다.	false	1.7.0+
PollingIntervalMillis	대시보드에서 설정한 정보를 주기적으로 업데이트 할 수 있습니다. 최솟값 : 60000 (60초)	-1 (주기적으로 업데이트하지 않음)	1.7.0+

^* 1.9.0 이후부터 앱 종료 후 재시작 시에도 지원합니다.)

인스턴스 가져오기

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

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

Hackle hackle = Hackle.GetInstance();