iOS(아이폰) 연동하기

플레어레인을 사용하여 iOS(아이폰) 앱 푸시 알림을 코드 1줄로 구현할 수 있습니다.
1. 사전 준
비
타 푸시 솔루션과 함께 사용할 수 있습니다!
병행 사용을 위해서는 iOS: Swizzling 비활성화﻿ 가이드를 참고하여 몇 가지 작업을 추가해야합니다.
﻿플레어레인 관리자 에서 회원가입 후 프로젝트 생성
﻿
2. 인증 값 설정
아래 가이드를 참고하여 플레어레인에 푸시 발송에 필요한 인증 값을 입력합니다.
﻿iOS: APNS 인증 정보 설정﻿﻿
﻿
3. CocoaPods을 사용하여 SDK 연동
내 Xcode  프로젝트에 CocoaPods 설치가 되어있는지 확인합니다. 처음일 경우 여기를 참고하세요

Podfile 파일의 상단에 platform :ios, '12.0'혹은 그 이상을 입력합니다

Podfile에 다음 코드를 추가합니다.
Podfile
target 'YOUR_PROJECT_NAME' do

  // 아래 줄 추가
  pod 'FlareLane', '1.4.0'
  
end
target 'YOUR_PROJECT_NAME' do

  // 아래 줄 추가
  pod 'FlareLane', '1.4.0'
  
end
﻿
    4. 터미널에서 pod install을 통해 설치 완료합니다.

    5. <YOUR_PROJECT_NAME>.xcworkspace 파일을 열어 Xcode 프로젝트를 실행합니다.
﻿
4. Capability 추가 
대상 PROJECT의 Deployment Target 을 12.0 혹은 그이상으로 입력합니다.

대상 TARGET의 Minimum Deployments 를 12.0 혹은 그 이상으로 입력합니다.

앱푸시 발송 권한을 추가합니다. Target 의 "Signing & Capabilites" 탭으로 들어와 좌상단의 "+ Capability" 를 클릭합니다.

"Push Notifications" 를 선택하여 추가합니다
﻿Apple Developer Program 에 가입된 Apple 계정만 Push Notifications Capability를 추가할 수 있습니다
﻿
﻿
5. 초기화 코드 작성
SwiftUI vs Storyboard. 우리 프로젝트의 User Interface는 무엇인가요? 
SwiftUI 로 설정된 경우 4-1 부터
Storyboard 로 설정된 경우 4-2 부터 진행합니다.
5-1. (SwiftUI만) AppDelegate.swift 생성
SwiftUI 프로젝트는 AppDelegate.swift가 생성되어 있지 않기 때문에 먼저 파일 생성이 필요합니다.
AppDelegate.swift 파일을 새로 만들고 기존 <YOUR_PROJECT_NAME>App.swift 파일을 일부 수정합니다.
(추가)AppDelegate.swift
(기존)<YOUR_PROJECT_NAME>App.swift
import UIKit

class AppDelegate: NSObject, UIApplicationDelegate {
  func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey : Any]? = nil) -> Bool {
    return true
  }
}

import UIKit

class AppDelegate: NSObject, UIApplicationDelegate {
  func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey : Any]? = nil) -> Bool {
    return true
  }
}
﻿
5-2. AppDelegate 내부 연동 코드 작성 
AppDelegate 파일에 다음과 같은 초기화 코드를 입력합니다. 프로젝트 ID는 콘솔의 [프로젝트] 페이지에서 확인할 수 있습니다.
플레어레인 SDK가 제공하는 함수 리스트는  Mobile Push SDK Reference﻿ 에서 확인할 수 있습니다.
Switft(AppDelegate.swift)
Objective-C(AppDelegate.m)
// 1. SDK 사용을 위해 import 코드 추가
import FlareLane

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

    // 2. 아래 init 코드 추가
    // 알림 권한 팝업 타이밍을 제어하려면 세 번째 파라미터를 false로 설정 후 적절한 시점에 .subscribe() 함수 실행
    FlareLane.initWithLaunchOptions(launchOptions, projectId: "PROJECT_ID", requestPermissionOnLaunch: true)
  }
}
// 1. SDK 사용을 위해 import 코드 추가
import FlareLane

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

    // 2. 아래 init 코드 추가
    // 알림 권한 팝업 타이밍을 제어하려면 세 번째 파라미터를 false로 설정 후 적절한 시점에 .subscribe() 함수 실행
    FlareLane.initWithLaunchOptions(launchOptions, projectId: "PROJECT_ID", requestPermissionOnLaunch: true)
  }
}
﻿
﻿
6. 테스트
여기까지 모두 완료하셨으면 앱 빌드, 실행 시 자동으로 플레어레인 전체 기기 리스트에 추가됩니다.
실제 배포 전, 푸시를 실제 발송하여 기기에 잘 오는지, 푸시 클릭 시 통계에 잘 잡히는지 반드시 직접 확인하시기 바랍니다.
﻿
7. 추가 개발 연동
푸시 알림에 이미지 첨부를 하고 싶습니다.
[iOS] iOS: Rich Notification﻿ 을 참고하여 Notification Extension 세팅을 합니다.
초개인화 마케팅을 위해 고객 데이터를 연동합니다.
 고객 여정 자동화﻿ 및 메시지 개인화﻿ 등 초개인화 푸시 마케팅에 필요한 고객 데이터 연동﻿을 진행합니다.
푸시 클릭 시 동작을 정의하고 싶습니다.
﻿Mobile Push SDK Reference﻿ 내 setNotificationConvertedHandler 함수를 사용합니다.
﻿