CMP Migration TroubleShooting

[easyhooon]

• Android Studio Wizard 에서 모듈 생성시, KMP 모듈을 찾을 수 없음
  • [KMP Kotlin Multiplatform Shared Module 을 생성할 수 없는 문제 해결
• 모든 core, feature 모듈을 kmp 모듈로 변경해야함
  • 우선 composeApp 모듈 내에서 모놀리틱 구조로 migration 진행
  • cmp migration 완료 후 다시 모듈화
• string, drawable, font, raw 등의 리소스들이 생성되지 않음
  • 이전 resource 참조 관련 문제들을 우선 해결하고 rebuild 할 경우 Res.~~ auto import 됨
  • 8003a14
• landscapist bundle 로 라이브러리 의존성 추가할 경우, iOS 에서 라이브러리 인식이 되지 않음
  • https://youtrack.jetbrains.com/issue/KT-71289/Support-declaring-Kotlin-Multiplatform-dependencies-at-project-level
    -> composeApp 모듈에는 아직 bom 형태로 라이브러리를 추가할 수 없나봄(각각 버전을 명시하여 추가 -> 해결)
    -> 이러한 대안이 있음
• Toast 대응
  • CMPToast
  • https://www.jetbrains.com/help/kotlin-multiplatform-dev/compose-multiplatform-resources-usage.html#strings 문서 내 non-composable code 적용 -> scope.lauch { showToast(getString(Res.string.~~) }
  • UiText sealed class 제거(위의 문서의 getString 함수로 대체 가능)
  • Toast 와 같이 호출하는 곳에서는 scope.launch 로 감싸면 되지만, 단순 Text 대입 혹은 동등 비교의 경우 전체 함수를 suspend 함수로 변경해야하는 문제가 존재 -> 일단은 @composable 어노테이션을 붙혀 컴포저블 함수로 만들거나, 하드코딩의 방식으로 임시 해결
• Preview 대응
  • androidApp 모듈에 몰아넣어서 작성할수있다곤하는데, 그 방법을 알아봐야함
  • 곧 있으면 composeApp 모듈에서도 Preview 를 지원할 것으로 보임
  • https://youtrack.jetbrains.com/issue/KTIJ-32720/
• Room, DataStore Koin 을 통한 KMP 에서의 의존성 주입
  • reference) https://github.com/philipplackner/CMP-Bookpedia
• 망할놈의 context 를 commonMain 에서 어떻게 빼내야할까?(actual 함수에만 주입하는 방법...koin!)
  • App Version 을 가져오는 actual/expect 구현에서 context 가 필요
    -> platform 모듈을 통한 androidApplication or androidContext 주입
  • reference) Full Guide to Dependency Injection With Koin for Compose Multiplatform
  • CMP-Bookpedia Modules.android
  • c49e79c
• setting.gradle.kts removeUnusedEntriesAfterDays deprecated -> 해당 블록 제거
  • reference) https://docs.gradle.org/current/userguide/upgrading_version_8.html
• Locale 대응
  • java.time.format.DateTimeParseException: Text 'com.nexters.bandalart.core.common.extension.LocalDateTime@beb47a...' could not be parsed at index 0
    -> toString 함수 오버라이딩 하여 해결, 기본 toString() 구현(Object 의 toString)을 사용하고 있어서, 클래스 이름과 해시코드가 출력되고 있었음 7f4495f
• 아직 지원하지 않는 Compose API
  • LocalConfiguration -> BoxWithConstraints 을 통해 화면의 세로, 가로 길이를 구하는 방식으로 대체 bb203e7
  • LineBreak -> 이건 ㄹㅇ 미지원이긴 한데 적용 안해도 나름 괜찮은듯
  • isImeVisible -> WindowInsets.ime.getBottom() 으로 대체
  • LineBreak 는 우선 주석처리
• Emit the compilation warning on expect/actual classes. The warning must mention that expect/actual classes are in Beta
• https://slack-chats.kotlinlang.org/t/22895004/i-have-a-question-about-the-new-constructedby-and-roomdataba
  -> 아래 코드 composeApp 모듈 build.gradle.kts 에 추가하여 해결

   dependencies {
      ksp(libs.room.compiler)
      add("kspAndroid",libs.room.compiler)
      add("kspIosSimulatorArm64",libs.room.compiler)
      add("kspIosX64",libs.room.compiler)
      add("kspIosArm64",libs.room.compiler)
  }

• Caused by: org.koin.core.error.NoDefinitionFoundException: No definition found for type 'com.nexters.bandalart.feature.splash.SplashViewModel'. Check your Modules configuration and add missing type and/or qualifier! -> composeApp 모듈 SourceSets 내에 viewmodel 의존성 추가 안함(머쓱...)
• https://youtrack.jetbrains.com/issue/KT-71324/KMM-Xcode-run-shell-script-issues-No-such-module-ComposeApp
  -> Android Studio 에서 ./gradlew :composeApp:linkDebugFrameworkIosSimulatorArm64 와 같은 명령어를 통해, iOS 쪽 빌드를 먼저 해주고 Xcode 에서 빌드하도록 하자.
• LocalDateTime 대응(메인 목표 만료일 설정)
• Can't find env_blacklist file at /Users/yijihun/.konan/kotlin-native-prebuilt-macos-x86_64-2.1.10/tools/env_blacklist.
  -> Kotlin Multiplatform Wizard 을 통해 프로젝트를 만들어 빌드 후 누락된 파일이 설치되어 문제를 해결
• expect/actual migration 이유 이미지 관련 로직(공유, 갤러리 저장) 정상화(에러 해결)
  • [externalShareFoBitmap] message: Calling startActivity() from outside of an Activity context requires the FLAG_ACTIVITY_NEW_TASK flag. Is this really what you want?
    -> 55a5ddc
  • ImageBitmap to UiImage
    • reference)
    • https://medium.com/mobile-innovation-network/imagebitmap-to-uiimage-compose-multiplatform-0e1f121d7da8
    • Image to UiImage in droidkaigi2024
  • 이미지 저장은 FileKit 라이브러리의 도움을 받을수도...?
  • 이미지 저장 및 공유시 색이 바래지는 이슈(옅어지는 문제)
    -> iOS와 Android Compose의 이미지 색상 데이터 저장 방식 비교 확인 RGBA(Compoise ImageBitmap) vs BGRA(iOS CGBitmapContext)
    -> 해결 Image to UiImage in droidkaigi2024
• iOS iPhone SE2 환경 반응형 대응(Android 작은 기기에서도 마찬가지 일 것이라 추측)
  • 완료 화면 Lottie 와 Title 이 겹쳐보이는 문제 해결 -> Lottie 라이브러리 변경 이후 크기 지정해줘야 했음
• iOS 환경 바텀시트 내에 텍스트필드에서 자소분리 문제 해결
  • https://youtrack.jetbrains.com/issue/CMP-7670/iOS-Korean-text-input-shows-decomposed-syllables-in-TextField-within-M3-BottomSheet
  • f2dbe08
• Xcode 켰을 때 코드가 보이지 않는 문제 해결
• CMP 변경 이후 빌드시 생성되는 파일들로 인해, lint 검사 실패하는 문제 해결
• androidx-lifecycle-runtime-compose 라이브러리 인식 안되는 문제 -> org.jetbrains.androidx.lifecycle-runtime-compose 로 교체
• fail to resolive firebase-analaytics, crashlytics, config
• iOS App Archive 과정 중 OOM: Java heap space -> gradle.properties java heap space 값 수정 (2GB -> 4GB)
• 앱 스크린샷에 알파값이 포함되어 이미지 첨부되지 않는 문제 -> PNG 파일 JPEG 으로 변경 (JPEG은 투명도를 지원하지 않음)
• iOS 심사 개인정보 보호 매니페스트 관련 대응
  • reference)
  • https://h1guitar.tistory.com/323
• iOS 앱 용량이 Android 앱보다 6배 큰 건에 대하여...
• Koin Annotation 방식으로 리팩토링