📱 iOS 설정

이 문서는 네이티브 iOS 프로젝트(Swift 기반)에 'Test Solution SDK'를 통합하기 위한 구체적인 설정 방법을 안내합니다.

'시작하기' 섹션의 설치 가이드를 통해 프로젝트에 Flutter Module이 추가되었다고 가정합니다.

`FlutterEngine` 유지관리 클래스 생성

앱의 생명주기 동안 유지할 별도의 관리 클래스를 만듭니다.

UIKit (Storyboard)
SwiftUI

FlutterEngineManager.swift
import Foundation
import Flutter
import FlutterPluginRegistrant

class FlutterEngineManager: NSObject, FlutterAppLifeCycleProvider {
    static let shared = FlutterEngineManager()
    
    let flutterEngine: FlutterEngine
    
    private let lifecycleDelegate = FlutterPluginAppLifeCycleDelegate()

    private override init() {
        self.flutterEngine = FlutterEngine(name: "MSCFlutterEngine")
        super.init()
        
        flutterEngine.run()
        GeneratedPluginRegistrant.register(with: self.flutterEngine)
    }
    
    func add(_ delegate: any FlutterApplicationLifeCycleDelegate) {
        lifecycleDelegate.add(delegate)
    }
}

AppDelegate.swift 파일은 iOS 앱의 생명주기를 관리하고 Flutter Engine을 초기화하는 핵심적인 역할을 합니다.

AppDelegate.swift
import UIKit

@main
class AppDelegate: UIResponder, UIApplicationDelegate {
    
    func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
        let _ = FlutterEngineManager.shared
        return true
    }
    
    // ...
}

ViewController.swift 파일에 테스트를 시작하는 버튼과 관련 코드를 추가합니다.

ViewController.swift
import UIKit
import Flutter

class ViewController: UIViewController {
    
    private let CHANNEL: String = "com.mscbrain.sdk.test_solution_sdk/channel"
    
    override func viewDidLoad() {
        super.viewDidLoad()
        
        let button = UIButton(type:UIButton.ButtonType.custom)
        button.addTarget(self, action: #selector(showFlutter), for: .touchUpInside)
        button.setTitle("테스트 시작", for: UIControl.State.normal)
        button.frame = CGRect(x: 80.0, y: 210.0, width: 160.0, height: 40.0)
        button.backgroundColor = UIColor.orange
        self.view.addSubview(button)
    }
    
    @objc func showFlutter() {
        let flutterEngine = FlutterEngineManager.shared.flutterEngine
        let flutterViewController = FlutterViewController(engine: flutterEngine, nibName: nil, bundle: nil)
        flutterViewController.modalPresentationStyle = .fullScreen
        
        let channel = FlutterMethodChannel(name: CHANNEL, binaryMessenger: flutterViewController.binaryMessenger)
        channel.setMethodCallHandler({(call: FlutterMethodCall, result: @escaping FlutterResult) -> Void in
            
            switch call.method {
            case "onResult":
                guard let resultMap = call.arguments as? [String: Any],
                    let status = resultMap["status"] as? String else {
                    return
                }
                
                print("onResult received: \(resultMap)")

                if status == "COMPLETED" {
                    // 테스트 완료 후 처리 로직
                } else if status == "ERROR" {
                    // 오류 처리 로직
                }
                break

            case "onInfo":
                guard let versionMap = call.arguments as? [String: Any] else { return }
                print("TestSolutionSDK_VERSION: \(versionMap)") // 버전 정보 출력
                break

            case "onLog":
                guard let logMap = call.arguments as? [String: Any] else { return }
                print("TestSolutionSDK_LOG: \(logMap)") // 디버그 로그 출력
                break
                
            default:
                result(FlutterMethodNotImplemented)
            }
        })
        
        let startData: [String: Any] = [
            // 필수 값
            "goodsId": "[GOODS_ID]",
            "suid": "[SUID]",
            "language": "[LANGUAGE]",
            // 선택 값
            "isDevelopment": true,
            "enableHostLogging": true,
            "themeColor": 0xFF7E52F3, // 예시: 보라색 (AARRGGBB)
            "themeMode": "light",
            "titleText": "나의 성격 유형 찾기"
        ]
        
        channel.invokeMethod("startTest", arguments: startData)
        
        present(flutterViewController, animated: true, completion: nil)

    }
}

주요 흐름 요약

앱 실행: AppDelegate에서 FlutterEngine을 미리 생성하고 실행합니다. SDK 화면을 요청하기 전에 이미 엔진이 메모리에 로드되어 준비된 상태가 됩니다. 이로 인해 SDK 화면이 나타나는 속도가 매우 빨라집니다. 🚀
통신 채널 설정: 네이티브와 SDK 간의 통신 채널인 FlutterMethodChannel을 설정하여 SDK로부터 onResult, onLog, onInfo 를 수신할 준비를 합니다.
테스트 시작: ViewController에서 사용자가 버튼을 누르면, channel.invokeMethod("startTest", arguments: startData) 코드를 통해 "startTest"라는 이름의 메소드를 호출하면서 startData를 SDK로 전달합니다.
화면 표시: FlutterViewController를 생성하여 사용자에게 보여줍니다.
결과 수신: SDK에서 onResult, onInfo, onLog를 호출하고, 이 신호를 받아 네이티브에서 후속 작업을 처리합니다.

FlutterEngineManager.swift
import Flutter
import FlutterPluginRegistrant

@Observable
class FlutterEngineManager {
    let engine: FlutterEngine
    
    init() {
        self.engine = FlutterEngine(name: "MSCFlutterEngine")
        
        engine.run()
        GeneratedPluginRegistrant.register(with: self.engine)
    }
}

MyApp.swift
import SwiftUI

@main
struct MyApp: App {
    @State private var flutterEngineManager = FlutterEngineManager()
    
    var body: some Scene {
        WindowGroup {
            ContentView()
                .environment(flutterEngineManager)
        }
    }
}

FlutterViewController를 감싸서 SwiftUI 뷰처럼 사용할 수 있게 해주는 래퍼 구조체를 만듭니다. 이 파일에 Flutter 채널 통신 로직까지 함께 넣어 관리하는 것이 편리합니다.

FlutterView.swift
import SwiftUI
import Flutter

struct FlutterView: UIViewControllerRepresentable {
    @Environment(FlutterEngineManager.self) private var flutterEngineManager
    
    private let CHANNEL: String = "com.mscbrain.sdk.test_solution_sdk/channel"
    
    func makeUIViewController(context: Context) -> some UIViewController {
        let flutterViewController = FlutterViewController(engine: flutterEngineManager.engine, nibName: nil, bundle: nil)
        let channel = FlutterMethodChannel(name: CHANNEL, binaryMessenger: flutterViewController.binaryMessenger)
        channel.setMethodCallHandler({(call: FlutterMethodCall, result: @escaping FlutterResult) -> Void in
            
            switch call.method {
            case "onResult":
                guard let resultMap = call.arguments as? [String: Any],
                    let status = resultMap["status"] as? String else {
                    return
                }
                
                print("onResult received: \(resultMap)")

                if status == "COMPLETED" {
                    // 테스트 완료 후 처리 로직
                } else if status == "ERROR" {
                    // 오류 처리 로직
                }
                break

            case "onInfo":
                guard let versionMap = call.arguments as? [String: Any] else { return }
                print("TestSolutionSDK_VERSION: \(versionMap)") // 버전 정보 출력
                break

            case "onLog":
                guard let logMap = call.arguments as? [String: Any] else { return }
                print("TestSolutionSDK_LOG: \(logMap)") // 디버그 로그 출력
                break
                
            default:
                result(FlutterMethodNotImplemented)
            }
        })
        
        let startData: [String: Any] = [
            // 필수 값
            "goodsId": "[GOODS_ID]",
            "suid": "[SUID]",
            "language": "[LANGUAGE]",
            // 선택 값
            "isDevelopment": true,
            "enableHostLogging": true,
            "themeColor": 0xFF7E52F3, // 예시: 보라색 (AARRGGBB)
            "themeMode": "light",
            "titleText": "나의 성격 유형 찾기"
        ]
        
        channel.invokeMethod("startTest", arguments: startData)
        
        return flutterViewController
    }
    
    func updateUIViewController(_ uiViewController: UIViewControllerType, context: Context) {
    }
}

메인 SwiftUI 뷰(ContentView)에서 버튼을 만들고, 버튼을 탭하면 위에서 만든 FlutterView를 전체 화면으로 띄우도록 구현합니다.

ContentView.swift
import SwiftUI

struct ContentView: View {
    @State private var isShowingFlutter = false

    var body: some View {
        VStack {
            Button("테스트 시작") {
                self.isShowingFlutter = true
            }
            .padding()
            .background(Color.orange)
            .foregroundColor(.white)
            .cornerRadius(8)
        }
        .fullScreenCover(isPresented: $isShowingFlutter) {
            FlutterView()
                .ignoresSafeArea()
        }
    }
}

주요 흐름 요약

앱 실행: MyApp이 실행되고 FlutterEngineManager 가 생성됩니다. 이때 Flutter 엔진이 미리 초기화(pre-warming) 됩니다. 🚀
통신 채널 설정: 네이티브와 SDK 간의 통신 채널인 FlutterMethodChannel을 설정하여 SDK로부터 onResult, onLog, onInfo 를 수신할 준비를 합니다.
테스트 시작: makeUIViewController 내부에서 채널과 핸들러가 설정된 직후, channel.invokeMethod("startTest", arguments: startData) 코드를 통해 "startTest"라는 이름의 메소드를 호출하면서 startData를 SDK로 전달합니다.
화면 표시: FlutterViewController를 생성하여 사용자에게 보여줍니다.
결과 수신: SDK가 결과를 보내거나 로그를 전달할 때 미리 등록해둔 setMethodCallHandler가 호출되고, 핸들러 내부에서 메소드 이름을 구분하여 각각에 맞는 후속 작업을 처리합니다.

FlutterEngine 유지관리 클래스 생성​

주요 흐름 요약​

주요 흐름 요약​

`FlutterEngine` 유지관리 클래스 생성

주요 흐름 요약

주요 흐름 요약