시작하기

iOS Setup

SDK 이용하여 연동시

사전 준비

아래 2가지 항목을 eng@fairytech.ai로 전달해 주시면, 프로젝트 설정 후에 Project ID, SDK API Key, SDK Version을 회신드립니다.

개발용 Bundle ID
배포용 Bundle ID

플레이스홀더	입력할 값
`{PROJECT_ID}`	Fairy에서 제공한 프로젝트 식별자
`{SDK_API_KEY}`	Fairy에서 제공한 Moment SDK 초기화용 API Key
`{SDK_VERSION}`	Fairy에서 제공한 iOS SDK 버전. 예: `1.1.4`

STEP 1) Project ID, API Key 설정 (v 1.1.4 이상)

configure 함수를 호출하여 명시적으로 SDK를 초기화해야 합니다. 앱이 시작되는 시점인 AppDelegate의 didFinishLaunchingWithOptions 메서드 내에서 호출하는 것을 권장합니다. (SDK를 사용하기 전에만 초기화를 하면 됩니다.)

(필요시) Info.plist 설정 제거
기존에 Info.plist에 등록되어 있던 아래 키 값들은 더 이상 사용하지 않으므로 제거해 주십시오.
- MomentApiKey
- MomentProjectId

Configure 함수 호출 MomentCashbackService를 사용하기 전에 반드시 API Key와 Project ID를 설정해야 합니다.

import UIKit
import Moment // SDK 모듈 임포트
@main
class AppDelegate: UIResponder, UIApplicationDelegate {
    func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {

        // [필수] Moment SDK 초기화
        // 발급받은 API Key와 Project ID를 입력해주세요.
        MomentCashbackService.configure(
            apiKey: "{SDK_API_KEY}",
            projectId: "{PROJECT_ID}"
        )

        // (선택 사항) 개발/상용 환경에 따라 키 값을 분기 처리할 수 있습니다.
        /*
        #if DEBUG
        MomentCashbackService.configure(apiKey: "DEV_KEY", projectId: "DEV_ID")
        #else
        MomentCashbackService.configure(apiKey: "PROD_KEY", projectId: "PROD_ID")
        #endif
        */
        return true
    }
}

주의: configure 함수를 호출하지 않고 다른 SDK 기능을 사용할 경우, 초기화 에러가 발생할 수 있습니다. 반드시 앱 실행 초기에 호출해 주십시오.

STEP 2) Moment Cashback Framework 추가

Swift Package Manager

XCode에서 Github login을 해주세요. (repo에 인증이 걸려있지 않아 아무 계정을 사용하셔도 무관합니다)
File → Add Packages에서 아래의 url을 넣어주세요.

'<https://github.com/fairytech-external/Cashback-iOS>'

Dependency rule을 Up to Next Minor Version로 설정해주세요.

Cocoapods

platform :ios, '14.0'
use_frameworks!

target 'CashbackDemo' do
  pod 'Moment', :podspec => 'https://github.com/fairytech-external/Cashback-iOS/releases/download/{SDK_VERSION}/Moment.podspec'
end

(⬆️ sample Podfile)
{SDK_VERSION}에는 Fairy에서 제공한 버전을 입력합니다. 현재 1.1.3부터 사용할 수 있습니다.

현재 ‘Moment’는 정적 Framework로 빌드되어, pod 설치 이후 다른 추가 작업 없이 사용 가능합니다.

xcframework direct import

https://github.com/fairytech-external/Cashback-iOS에서 코드를 다운로드 받아주세요.
App Source Root > Frameworks 폴더에 다운로드 받은 Moment.xcframework 를 넣어주세요.
General > Frameworks, Libraries, and Embedded Contents에서 Moment.xcframework 를 Embed & Sign으로 변경해주세요.

Targets > Build Phases > Link Binary With Libraies에서 Moment.xcframework 가 Required되어있는지 확인해주세요.

SDK 이용하지 않고 연동시

사용하실 프로젝트의 Project ID 와 해당 project의 Web API Key 를 준비해주세요. 직접 전달드린 Project ID 및 Web API Key 를 모르실 경우, 콘솔을 통해 확인하실 수 있습니다.