Latest 0.13.0
Homepage https://github.com/nhnent/toastcloud.sdk
License Apache License, Version 2.0
Platforms ios 8.0, requires ARC
Dependencies ToastCore
Frameworks Foundation, UIKit, CoreLocation
Authors

TOAST > TOAST SDK 사용 가이드 > 시작하기 > iOS

지원 환경

  • iOS 8.0 이상
  • XCode 최신 버전(버전 9 이상)

TOAST SDK의 구성

iOS용 TOAST SDK의 구성은 다음과 같습니다.

TOAST SDK가 제공하는 서비스 중 원하는 기능을 선택해 적용할 수 있습니다.

Service Cocoapods Pod Name Framework Dependency Build Settings
All ToastSDK ToastCore.framework
ToastCommon.framework
ToastLogger.framework
ToastIAP.framework
Mandatory ToastCore
ToastCommon
ToastCore.framework
ToastCommon.framework
OTHER_LDFLAGS = (
"-ObjC",
"-lc++"
);
TOAST Log & Crash ToastLogger ToastLogger.framework [External & Optional]
* CrashReporter.framework
ENABLE_BITCODE = NO;
TOAST IAP ToastIAP ToastIAP.framework StoreKit.framework

[Optional]
libsqlite3.tdb

TOAST Push ToastPush ToastPush.framework UserNotifications.framework

[Optional]
PushKit.framework

TOAST SDK를 Xcode 프로젝트에 적용

1. Cococapods를 사용해 TOAST SDK 적용

Podfile을 생성하여 TOAST SDK에 대한 Pod을 추가합니다.

platform :ios, '8.0'
use_frameworks!

target '{YOUR PROJECT TARGET NAME}' do
pod 'ToastSDK'
end

생성된 Workspace를 열어 사용할 SDK를 가져옵니다(import).

#import <ToastCore/ToastCore.h>
#import <ToastLogger/ToastLogger.h>
#import <ToastIAP/ToastIAP.h>
#import <ToastPush/ToastPush.h>

2. 바이너리를 다운로드하여 TOAST SDK 적용

SDK 가져오기(import)

TOAST의 Downloads 페이지에서 전체 iOS SDK를 다운로드할 수 있습니다.

import_frameworks

TOAST Logger의 Crash Report 기능을 사용하려면 함께 배포되는 CrashReporter.framework도 프로젝트에 추가해야 합니다.

import_external_framework

프로젝트에 다음과 같이 프레임워크(framework)가 추가된 것을 확인합니다.

import_frameworks_complete

TOAST IAP 기능을 사용하려면 StoreKit.framework를 추가해야 합니다.

linked__storekit_frameworks

linked_frameworks

TOAST Push 기능을 사용하려면 UserNotifications.framework를 추가해야 합니다.

linked__usernotifications_frameworks

TOAST Push 의 VoIP 기능을 사용하려면 PushKit.framework를 추가해야 합니다.

linked__pushkit_frameworks

linked_frameworks

Project Settings

Build SettingsOther Linker Flags-lc++-ObjC 항목을 추가합니다.

Project Target > Build Settings > Linking > Other Linker Flags를 클릭해 추가할 수 있습니다.

other_linker_flags

CrashReporter.framewor를 직접 다운로드하거나 빌드한 경우에는 Build Setting의 Enable Bitcode의 값을 NO로 변경해야 합니다.

Project Target > Build Settings > Build Options > Enable Bitcode을 클릭하고 NO를 클릭합니다.

enable_bitcode

TOAST의 Downloads 페이지에서 다운로드 받은 CrashReporter.framework는 bitCode를 지원합니다.

프레임워크 가져오기

사용하려는 프레임워크를 가져옵니다(import).

#import <ToastCore/ToastCore.h>
#import <ToastLogger/ToastLogger.h>
#import <ToastIAP/ToastIAP.h>
#import <ToastPush/ToastPush.h>

UserID 설정

TOASAT SDK에 사용자 ID를 설정할 수 있습니다.
설정한 UserID는 TOAST SDK의 각 모듈에서 공통으로 사용됩니다.
TOAST Logger의 로그 전송 API를 호출할 때마다 설정한 사용자 ID를 로그와 함께 서버로 전송합니다.

UserID API 명세

@interface ToastSDK : NSObject

//...

+ (void)setUserID:(NSString *)userID;

//...

@end

UserID 설정 사용 예

[ToastSDK setUserID:@"TOAST-USER"];

디버그 모드 설정

TOAST SDK의 내부 로그를 확인하기 위해 디버그 모드를 설정할 수 있습니다.
TOAST SDK와 관련해 문의하실 때는 디버그 모드를 활성화해서 전달해 주시면 빠르게 지원해드릴 수 있습니다.

디버그 모드 설정 API 명세

@interface ToastSDK : NSObject

//...

+ (void)setDebugMode:(BOOL)debugMode;

//...

@end

디버그 모드 설정 사용 예

// Set Debug Mode.
[ToastSDK setDebugMode:YES];// or NO

[주의] 앱을 릴리스할 경우, 반드시 디버그 모드를 비활성화해야 합니다.

TOAST Service 사용

Latest podspec

{
    "name": "ToastDFP",
    "version": "0.13.0",
    "summary": "ToastSDK ToastDFP Version 0.13.0",
    "homepage": "https://github.com/nhnent/toastcloud.sdk",
    "license": {
        "type": "Apache License, Version 2.0",
        "file": "toastcloud.sdk-0.13.0/LICENSE.md"
    },
    "authors": {
        "hyup1028-nhnent": "[email protected]"
    },
    "source": {
        "http": "https://github.com/nhnent/toastcloud.sdk/archive/0.13.0.zip"
    },
    "platforms": {
        "ios": "8.0"
    },
    "requires_arc": true,
    "ios": {
        "vendored_frameworks": "toastcloud.sdk-0.13.0/Frameworks/ToastDFP.framework"
    },
    "frameworks": [
        "Foundation",
        "UIKit",
        "CoreLocation"
    ],
    "libraries": "resolv.9",
    "dependencies": {
        "ToastCore": [
            "0.13.0"
        ]
    }
}

Pin It on Pinterest

Share This