Flutter

Platform Channels를 사용하여 Flutter 앱에 Human Token Journey를 통합하세요.

Markdown

통합은 MethodChannel을 사용하여 iOS에서는 ASWebAuthenticationSession, Android에서는 Custom Tabs에 위임합니다. 외부 패키지가 필요 없습니다.

사전 요구 사항

• Flutter 3.x 이상
• iOS용 Xcode 14+
• Android용 Android Studio
• 앱의 고유한 URL 스킴 (예: myapp)

단계 1: URL 스킴 정의

고유한 스킴을 선택하세요 (예: myapp). 프로세스 생성 시 callbackUri로 사용됩니다:

callbackUri: myapp://callback

단계 2: Dart 서비스 생성

// lib/services/unico_service.dart
import 'package:flutter/services.dart';

class UnicoService {
  static const _channel = MethodChannel('unico_plugin');

  Future<String?> openSession(String url) async {
    try {
      final result = await _channel.invokeMethod<String>('openSession', {'url': url});
      if (result != null) {
        final uri = Uri.parse(result);
        return uri.queryParameters['id'];
      }
      return null;
    } on PlatformException {
      return null;
    }
  }
}

단계 3: iOS 플러그인 구현

// ios/Runner/UnicoPlugin.swift
import Flutter
import AuthenticationServices

class UnicoPlugin: NSObject, FlutterPlugin, ASWebAuthenticationPresentationContextProviding {
    private var session: ASWebAuthenticationSession?

    static func register(with registrar: FlutterPluginRegistrar) {
        let channel = FlutterMethodChannel(name: "unico_plugin", binaryMessenger: registrar.messenger())
        let instance = UnicoPlugin()
        registrar.addMethodCallDelegate(instance, channel: channel)
    }

    func handle(_ call: FlutterMethodCall, result: @escaping FlutterResult) {
        guard call.method == "openSession",
              let args = call.arguments as? [String: Any],
              let urlString = args["url"] as? String,
              let url = URL(string: urlString) else {
            result(FlutterMethodNotImplemented)
            return
        }

        let newSession = ASWebAuthenticationSession(
            url: url,
            callbackURLScheme: "myapp"
        ) { callbackURL, error in
            self.session = nil
            if let callbackURL = callbackURL {
                result(callbackURL.absoluteString)
            } else {
                result(FlutterError(code: "SESSION_ERROR",
                                    message: error?.localizedDescription ?? "Session cancelled",
                                    details: nil))
            }
        }
        newSession.presentationContextProvider = self
        newSession.prefersEphemeralWebBrowserSession = true
        newSession.start()
        session = newSession
    }

    func presentationAnchor(for session: ASWebAuthenticationSession) -> ASPresentationAnchor {
        guard let windowScene = UIApplication.shared.connectedScenes.first as? UIWindowScene,
              let window = windowScene.windows.first else {
            return ASPresentationAnchor()
        }
        return window
    }
}

AppDelegate.swift에 등록:

UnicoPlugin.register(with: self.registrar(forPlugin: "UnicoPlugin")!)

단계 4: Android 플러그인 구현

android/app/build.gradle에 의존성 추가:

implementation("androidx.browser:browser:1.5.0")

// android/app/src/main/kotlin/<your.package>/UnicoPlugin.kt
package com.yourapp

import android.content.Intent
import android.net.Uri
import androidx.browser.customtabs.CustomTabsIntent
import io.flutter.embedding.engine.plugins.FlutterPlugin
import io.flutter.embedding.engine.plugins.activity.ActivityAware
import io.flutter.embedding.engine.plugins.activity.ActivityPluginBinding
import io.flutter.plugin.common.MethodCall
import io.flutter.plugin.common.MethodChannel

class UnicoPlugin : FlutterPlugin, MethodChannel.MethodCallHandler, ActivityAware {
    private var channel: MethodChannel? = null
    private var binding: ActivityPluginBinding? = null
    private var pendingResult: MethodChannel.Result? = null

    override fun onAttachedToEngine(flutterBinding: FlutterPlugin.FlutterPluginBinding) {
        channel = MethodChannel(flutterBinding.binaryMessenger, "unico_plugin")
        channel?.setMethodCallHandler(this)
    }

    override fun onMethodCall(call: MethodCall, result: MethodChannel.Result) {
        if (call.method == "openSession") {
            val url = call.argument<String>("url") ?: return result.error("MISSING_URL", "URL is required", null)
            pendingResult = result
            val activity = binding?.activity ?: return result.error("NO_ACTIVITY", "No activity", null)
            CustomTabsIntent.Builder().build().launchUrl(activity, Uri.parse(url))
        } else {
            result.notImplemented()
        }
    }

    fun handleRedirect(uri: Uri) {
        if (uri.scheme == "myapp") {
            pendingResult?.success(uri.toString())
            pendingResult = null
        }
    }

    override fun onAttachedToActivity(binding: ActivityPluginBinding) { this.binding = binding }
    override fun onDetachedFromActivity() { binding = null }
    override fun onReattachedToActivityForConfigChanges(binding: ActivityPluginBinding) { this.binding = binding }
    override fun onDetachedFromActivityForConfigChanges() { binding = null }
    override fun onDetachedFromEngine(binding: FlutterPlugin.FlutterPluginBinding) { channel = null }
}

MainActivity.kt에 등록하고 리디렉션을 처리:

override fun configureFlutterEngine(flutterEngine: FlutterEngine) {
    super.configureFlutterEngine(flutterEngine)
    flutterEngine.plugins.add(UnicoPlugin())
}

override fun onNewIntent(intent: Intent) {
    super.onNewIntent(intent)
    intent.data?.let { uri ->
        if (uri.scheme == "myapp") {
            val plugin = flutterEngine?.plugins?.get(UnicoPlugin::class.java) as? UnicoPlugin
            plugin?.handleRedirect(uri)
        }
    }
}

단계 5: URL 스킴 구성

iOS

Info.plist에 추가:

<key>CFBundleURLTypes</key>
<array>
    <dict>
        <key>CFBundleURLSchemes</key>
        <array>
            <string>myapp</string>
        </array>
    </dict>
</array>

Android

메인 <activity> 내부의 AndroidManifest.xml에 추가:

<intent-filter>
    <action android:name="android.intent.action.VIEW" />
    <category android:name="android.intent.category.DEFAULT" />
    <category android:name="android.intent.category.BROWSABLE" />
    <data android:scheme="myapp" android:host="callback" />
</intent-filter>

단계 6: 여정 시작

final unicoService = UnicoService();
final processId = await unicoService.openSession(processLink);

if (processId != null) {
  // Journey completed — send processId to your backend via Get Process
} else {
  // User canceled
}

파일 요약

파일	목적
lib/services/unico_service.dart	Dart MethodChannel 서비스
ios/Runner/UnicoPlugin.swift	iOS — ASWebAuthenticationSession
ios/Runner/AppDelegate.swift	플러그인 등록
android/.../UnicoPlugin.kt	Android — Custom Tabs
android/.../MainActivity.kt	플러그인 등록 + 리디렉션 처리
Info.plist	iOS URL 스킴
AndroidManifest.xml	Android Intent 필터