🤖 Android 설정

이 문서는 'Test Solution' Flutter SDK를 네이티브 Android 앱에 통합하기 위한 설정 방법을 안내합니다.

시작하기 > 설치 가이드 문서에 따라 프로젝트에 Flutter Module이 추가되었다고 가정합니다.

---

1. AndroidManifest.xml 설정

• SDK는 API 서버와 통신하기 위해 인터넷 권한이 필요합니다. app/src/main/AndroidManifest.xml 파일에 아래 권한을 추가했는지 확인하세요.
• 추가로, Flutter는 안드로이드 앱 내에서 플러터 화면을 표시하기 위해 FlutterActivity를 제공합니다. 다른 모든 Activity와 마찬가지로 FlutterActivity 도 AndroidManifest.xml에 반드시 등록해야 합니다.

AndroidManifest.xml

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android">

    <uses-permission android:name="android.permission.INTERNET" />

    <application
        ...>
        <activity
            android:name="io.flutter.embedding.android.FlutterActivity"
            android:configChanges="orientation|keyboardHidden|keyboard|screenSize|locale|layoutDirection|fontScale|screenLayout|density|uiMode"
            android:hardwareAccelerated="true"
            android:windowSoftInputMode="adjustResize"
            />
    </application>
</manifest>

---

2. SDK 실행 및 통신 설정

Host 앱과 SDK(Flutter)는 **MethodChannel**을 통해 통신합니다. 테스트를 시작하고, 결과를 콜백으로 받기 위한 설정이 필요합니다.

MethodChannel 설정

MainActivity.kt 또는 SDK를 호출할 Activity에서 MethodChannel을 설정합니다. 성능을 위해 FlutterEngine을 캐싱하여 사용하는 것을 권장합니다.

다음은 Application.kt 의 캐싱 예제 코드 입니다.

Application.kt

class MyApplication : Application() {
    companion object {
        const val FLUTTER_ENGINE_ID = "test_solution_engine"
        const val CHANNEL_NAME = "com.mscbrain.sdk.test_solution_sdk/channel"
    }

    lateinit var flutterEngine: FlutterEngine
    lateinit var methodChannel: MethodChannel

    override fun onCreate() {
        super.onCreate()

        flutterEngine = FlutterEngine(this)
        flutterEngine
            .dartExecutor
            .executeDartEntrypoint(
                DartExecutor.DartEntrypoint.createDefault()
            )

        FlutterEngineCache
            .getInstance()
            .put(FLUTTER_ENGINE_ID, flutterEngine)

        methodChannel = MethodChannel(
            flutterEngine.dartExecutor.binaryMessenger,
            CHANNEL_NAME
        )

        methodChannel.setMethodCallHandler { call, result ->
            when (call.method) {
                "onResult" -> {
                    // 테스트 완료 또는 결과 수신
                    println("Flutter sent a result: ${call.arguments}")
                    result.success(null) // 응답 전송
                }

                "onInfo" -> {
                    // SDK version 수신 (getSDKVersion 요청 시)
                    println("Flutter sent a version: ${call.arguments}")
                    result.success(null)
                }

                "onLog" -> {
                    // SDK 로그 수신 (enableHostLogging = true 일 때)
                    println("Flutter sent a log: ${call.arguments}")
                    result.success(null)
                }

                else -> {
                    result.notImplemented()
                }
            }
        }
    }
}

아래는 MainActivity.kt의 전체 예제 코드입니다.

Views (XML)

MainActivity.kt

package com.example.yourapp

import android.os.Bundle
import android.widget.Button
import androidx.appcompat.app.AppCompatActivity
import com.example.myandroidapp.MyApplication.Companion.FLUTTER_ENGINE_ID
import com.example.myandroidapp.databinding.ActivityMainBinding
import io.flutter.embedding.android.FlutterActivity

class MainActivity : AppCompatActivity() {
    private lateinit var binding: ActivityMainBinding

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        binding = ActivityMainBinding.inflate(layoutInflater)
        setContentView(binding.root)

        findViewById<Button>(R.id.start_test_button).setOnClickListener {
            startTestSolution()
        }
    }

    private fun startTestSolution() {
        startActivity(
            FlutterActivity
                .withCachedEngine(FLUTTER_ENGINE_ID)
                .build(this)
        )

        // 테스트 시작 파라미터 구성
        val arguments = mapOf(
            // 필수 값
            "goodsId" to "[GOODS_ID]",
            "suid" to "[SUID]",
            "language" to "[LANGUAGE]",
            // 선택 값
            "isDevelopment" to true,
            "enableHostLogging" to true,
            "themeColor" to 0xFF7E57C2, // 예시: 보라색
            "themeMode" to "light",
            "titleText" to "나의 성격 유형 찾기",
            "customData" to mapOf("userId" to "12345", "source" to "app_event")
        )

        // `startTest` 메소드 호출
        (application as MyApplication).methodChannel.invokeMethod("startTest", arguments)
    }
}

Jetpack Compose

MainActivity.kt

package com.example.yourapp

import android.content.Context
import android.os.Bundle
import androidx.activity.ComponentActivity
import androidx.activity.compose.setContent
import androidx.activity.enableEdgeToEdge
import androidx.compose.foundation.layout.Box
import androidx.compose.foundation.layout.fillMaxSize
import androidx.compose.material3.Button
import androidx.compose.material3.Text
import androidx.compose.runtime.Composable
import androidx.compose.ui.Alignment
import androidx.compose.ui.Modifier
import androidx.compose.ui.platform.LocalContext
import com.example.mycomposeapp.ui.theme.MyComposeAppTheme
import io.flutter.embedding.android.FlutterActivity

class MainActivity : ComponentActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        enableEdgeToEdge()
        setContent {
            MyComposeAppTheme {
                MainScreen()
            }
        }
    }
}

@Composable
fun MainScreen() {
    val context = LocalContext.current
    val application = context.applicationContext as MyApplication

    Box(Modifier.fillMaxSize(), Alignment.Center) {
        Button({
            startTestSolution(context, application)
        }) {
            Text("테스트 시작")
        }
    }
}

private fun startTestSolution(context: Context, application: MyApplication) {
    context.startActivity(
        FlutterActivity
            .withCachedEngine(MyApplication.FLUTTER_ENGINE_ID)
            .build(context)
    )

    // 테스트 시작 파라미터 구성
    val arguments = mapOf(
        // 필수 값
        "goodsId" to "[GOODS_ID]",
        "suid" to "[SUID]",
        "language" to "[LANGUAGE]",
        // 선택 값
        "isDevelopment" to true,
        "enableHostLogging" to true,
        "themeColor" to 0xFF7E57C2, // 예시: 보라색
        "themeMode" to "light",
        "titleText" to "나의 성격 유형 찾기",
        "customData" to mapOf("userId" to "12345", "source" to "app_event")
    )

    // `startTest` 메소드 호출
    application.methodChannel.invokeMethod("startTest", arguments)
}

코드 설명

1. FlutterEngine 캐싱: 앱 실행 시 미리 FlutterEngine을 생성하여 캐시에 저장합니다. 이렇게 하면 SDK 화면(FlutterActivity)을 띄울 때 로딩 속도가 매우 빨라집니다. 이 코드는 Application 클래스의 onCreate()에서 실행하는 것이 가장 이상적입니다.
2. MethodChannel 초기화: Host와 SDK가 통신할 채널을 생성합니다. 채널 이름(CHANNEL_NAME)은 SDK 측에 정의된 이름과 반드시 동일해야 합니다.
3. setMethodCallHandler: SDK가 Host 쪽으로 메소드를 호출할 때(onResult, onLog, onInfo) 이를 수신하는 리스너입니다. when 구문을 사용하여 각 메소드 이름에 따라 분기 처리를 합니다.
4. 테스트 시작: 버튼 클릭 등 특정 이벤트가 발생했을 때 캐시된 FlutterEngine을 사용하여 FlutterActivity를 실행합니다.
5. invokeMethod("startTest", ...): FlutterActivity가 실행된 후, startTest 메소드를 호출하여 필수 및 선택 파라미터를 Map 형태로 SDK에 전달합니다.

정보

Activity 뿐만 아니라 Fragment 도 지원합니다. FlutterFragment(Flutter Docs)를 참고해주세요.