연동하기

시작하기전에

이 문서는 DFINERY iOS SDK를 iOS 앱에 통합하는 방법을 다룹니다.

더 자세히 알아보려면 리소스 및 샘플을 참조하세요.

SDK 지원 환경

• iOS 12.0 +

• Xcode 16.1 +

SDK 설치

DFINERY iOS SDK는 CocoaPods, Swift Package Manager(SPM), 수동 설치를 지원합니다.

CocoaPods

1. CocoaPods 설치

최신 버전의 CocoaPods을 설치해주세요

2. 의존성 추가

Xcode 프로젝트 폴더에 Podfile 추가 후 Podfile에 Dfinery SDK 의존성을 추가해주세요

target 'YourAppTarget' do  
  pod 'DfinerySDK'
end

target 'YourServiceExtension' do  
  pod 'DfinerySDKServiceExtension'
end

3. 의존성 설치

터미널에서 다음의 명령어로 SDK를 설치해 주세요

pod install

Swift Package Manager(SPM)

1. Xcode에서 패키지 의존성 추가

2. DFINERY SDK GitHub 저장소 입력

저장소 명은 https://github.com/IGAWorksDev/dfinery-ios-sdk 입니다.

3. Dependency Rule 입력 및 타겟에 DfinerySDK 추가

4. ServiceExtension 타겟에 DfinerySDKServiceExtension 추가

Dfinery SDK는 유의적 버전(Semantic versioning)2.0을 따릅니다.

수동 설치

1. 프레임워크 다운로드

여기에서 최신 프레임워크를 다운로드해 주세요

2. 프로젝트에 프레임워크 추가

Xcode의 Targets -> General -> Frameworks, Libraries, and Embedded Content -> + 클릭 -> Add Others... -> Add Files.. 를 통해 다운로드받은 프레임워크를 추가해 주세요

SDK 초기화

AppDelegate 수정

Swift

AppDelegate.Swift 파일에 다음과 같이 SDK를 import 합니다.

import DfinerySDK

AppDelegate 클래스에 sdk초기화 코드를 추가합니다.

@main
class AppDelegate: UIResponder, UIApplicationDelegate {

    func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {

        Dfinery.shared().sdkInit(serviceId: "SERVICE_ID")
        
        return true
    }
}

Objective-C

SDK 설정

로그 활성화하기

디버그 로그를 보려면 DFConfig.LOG_LEVEL에 DFLogLevel을 설정합니다. 설정된 로그 레벨에 따라 로그가 debug console에 표시됩니다. Log의 Subsystem은 (BundleIdentifier).dfineryLogger 입니다.

DFLogLevel	값	설명
DFLogLevel.error	6	Error 로그만 표시
DFLogLevel.warning	5	Warning, Error 로그 표시
DFLogLevel.info	4	Info, Warning, Error 로그 표시
DFLogLevel.debug	3	Debug, Info, Warning, Error 로그 표시
DFLogLevel.verbose	2	Verbose, Debug, Info, Warning, Error 로그 표시

Swift

Dfinery.shared().sdkInit(
    serviceId: "SERVICE_ID",
    config: [DFConfig.LOG_LEVEL: DFLogLevel.verbose]
)

Objective-C

완료

SDK 설치 및 초기화가 완료되었습니다.