연동하기

시작하기전에

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

SDK 지원 환경

• iOS 12.0 +

• Xcode 15.0 +

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

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

#import <DfinerySDK/DfinerySDK.h>

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

@implementation AppDelegate

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    
    [[Dfinery shared] sdkInitWithServiceId:@"SERVICE_ID"];

    return YES;
}

SDK 설정

로그 활성화하기

debug를 위한 로그 활성화 설정입니다. 해당 값 설정 시 로그가 debug conosole에 표시됩니다.

Swift

Dfinery.shared().sdkInit(
    serviceId: "SERVICE_ID",
    config: [DFConfig.LOG_ENABLE: true]
)

Objective-C

[[Dfinery shared] sdkInit:@"SERVICE_ID"
                withConfig:@{DFConfig.LOG_ENABLE: @YES}];

완료

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