SDK 연동

핵클 SDK 기능을 사용하기 위해서는 반드시 SDK 연동 작업이 필요합니다.

1 단계 : 의존성 추가

CocoaPods

pod 'Hackle', '~> 2.4.2'

Swift Package Manager

// ...
dependencies: [
    .package(url: "https://github.com/hackle-io/hackle-ios-sdk.git", 
                          .upToNextMinor("2.4.2"))
],
targets: [
    .target(
        name: "YOUR_TARGET",
        dependencies: ["Hackle"]
    )
],
// ...

2 단계 : SDK 초기화

핵클 서버로부터 SDK 연동에 필요한 정보들을 가져와서 SDK에 저장합니다. 이 작업은 비동기로 실행되며 콜백을 통해 초기화가 완료된 것을 알 수 있습니다.
Hackle.initialize() 메소드에 SDK 키콜백을 전달하여 초기화합니다.

import Hackle

// YOUR_APP_SDK_KEY 자리에 SDK 키를 넣습니다.
Hackle.initialize(sdkKey: "YOUR_APP_SDK_KEY") {
    // SDK ready to use.
}
@import Hackle;

// YOUR_APP_SDK_KEY 자리에 SDK 키를 넣습니다.
[Hackle initializeWithSdkKey:@"YOUR_APP_SDK_KEY" completion:^{
    // SDK ready to use.
}];

🚧

SDK 초기화는 반드시 한 번만 수행합니다

Hackle.initialize() 메소드는 반드시 한 번 호출되어야 합니다.

권장 초기화 전략: 로딩 화면을 통한 초기화

앱을 즉시 시작하지 않고 로딩 화면을 표시하고 SDK를 초기화합니다.
이후 콜백을 통해 로딩 화면을 닫고 사용자가 앱과 상호작용을 시작할 수 있도록 합니다.

이 전략을 사용하는 경우 로딩 화면에 제한 시간을 두는 것이 좋습니다.

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

let hackleApp = Hackle.app()
HackleApp *hackleApp = [Hackle app];

Did this page help you?