알려진 문제

Android 문제

  • com.google.mlkit:genai-prompt:1.0.0-beta3 및 com.google.mlkit:genai-prompt:1.0.0-beta4에서 앱이 kotlinx-coroutines를 1.10.x 이하로 확인하는 경우 모델 다운로드가 완료되거나 취소되면 download()를 호출하면 java.lang.NoSuchMethodError가 발생합니다. 해결 방법으로 다음 출시에서 수정사항이 제공될 때까지 Gradle 종속 항목에서 kotlinx-coroutines-android를 1.11.0 이상으로 명시적으로 고정합니다.
  • com.google.mlkit:genai-prompt:1.0.0-beta3 및 com.google.mlkit:genai-prompt:1.0.0-beta4에서 ModelConfig가 ModelPreference.FAST로 설정된 경우 nano-v4 모델에서 프리픽스 캐싱을 사용하여 추론을 실행하면 실패합니다. 해결 방법으로 다음 출시에서 수정사항이 제공될 때까지 ModelConfig 설정을 생략하여 기본 구성을 사용하세요.
  • com.google.mlkit:genai-prompt:1.0.0-beta3에서 Pixel 외 기기에 checkStatus()를 호출하면 처리되지 않은 GenAiException가 발생합니다. 이후 버전(com.google.mlkit:genai-prompt:1.0.0-beta4 이상)을 사용합니다.
  • 번들 언어 ID의 경우 AGP 7.0.0 이상으로 업그레이드할 때 앱이 비정상 종료될 수 있습니다. com.google.mlkit:language-id:16.1.1 이하 버전에서 비정상 종료를 방지하려면 아래 규칙을 포함하세요. 
    -keep class com.google.mlkit.nl.languageid.internal.LanguageIdentificationJni { *; }
     com.google.mlkit:language-id:17.0.0 또는 com.google.mlkit:language-id:17.0.1에서 비정상 종료를 방지하려면 아래 규칙을 포함하세요. 
    -keep class com.google.mlkit.nl.languageid.internal.ThickLanguageIdentifier { *; }
  • 0이 아닌 rotationDegrees를 사용하여 Bitmap으로 구성된 InputImage는 com.google.mlkit:face-detection:16.0.5 및 com.google.android.gms:play-services-mlkit-barcode-scanning:16.1.4 이후 FaceDetection API에 '잘못된 회전' MlKitException을 일으킵니다. 이전 버전을 사용하고 이 문제의 수정사항이 포함된 다음 출시를 기다려 주세요.

  • com.google.mlkit:barcode-scanning:16.1.0 및 com.google.android.gms:play-services-mlkit-barcode-scanning:16.1.3 이전의 BarcodeScanning SDK는 camera-camera2:1.0.0-beta08 버전 이상을 실행하는 일부 기기에서 작동하지 않습니다. 이전 버전의 camera-camera2를 사용하여 이 문제를 우회할 수 있습니다. 예를 들면 다음과 같습니다. 

    implementation "androidx.camera:camera-core:1.0.0-beta07"
implementation "androidx.camera:camera-camera2:1.0.0-beta07"
implementation "androidx.camera:camera-view:1.0.0-alpha14"
implementation "androidx.camera:camera-extensions:1.0.0-alpha14"
implementation "androidx.camera:camera-lifecycle:1.0.0-beta07"

  • com.google.mlkit:language-id:16.1.1 이하 버전에서는 네이티브 메서드가 맞춤 규칙에 의해 난독화될 수 있습니다. java.lang.UnsatisfiedLinkError와 같은 오류가 발생하면 다음 규칙을 포함하여 유지합니다. 

    -keepclasseswithmembernames class com.google.mlkit.nl.languageid.internal.LanguageIdentificationJni {
  native <methods>;
}

  • 텍스트 인식, 이미지 라벨 지정, 객체 감지 및 추적 API의 경우 CameraX 및 Camera2의 성능은 여전히 Camera1과 동등하지 않습니다. CameraX 및 Camera2의 이미지 형식 변환에 더 많은 시간이 걸리기 때문입니다.

  • Task 콜백은 등록된 Activity 또는 프래그먼트가 소멸된 후에 실행될 수 있습니다. 이로 인해 콜백이 그동안 닫힌 감지기에 액세스하려고 하면 예외가 발생할 수 있습니다. 활동에서 ML Kit를 사용하는 경우 Activity 범위 리스너를 등록할 수 있으며, 이 리스너는 Activity가 중지되면 자동으로 삭제됩니다. 프래그먼트나 다른 환경에서 ML Kit를 사용하는 경우 프래그먼트가 소멸될 때 실행을 종료하는 커스텀 실행자를 제공할 수 있습니다. 예시는 Vision 빠른 시작의 ScopedExecutor.Java를 참조하세요.

  • 비트맵 이외의 이미지 형식을 사용하는 이미지 라벨 지정의 경우 번들 변형이 Google Play 서비스에 종속된 '씬' 변형보다 성능이 우수합니다.

  • 디지털 잉크 com.google.mlkit:digital-ink-recognition:17.0.0 이하 및 항목 추출 com.google.mlkit:entity-extraction:16.0.0-beta2 이하의 경우 targetSdkVersion을 31로 설정하고 Android S에서 실행하면 다음과 같은 런타임 예외가 발생합니다. 

    Targeting S+ (version 31 and above) requires that one of FLAG_IMMUTABLE or FLAG_MUTABLE be specified when creating a PendingIntent.
AndroidRuntime: Strongly consider using FLAG_IMMUTABLE, only use FLAG_MUTABLE if some functionality depends on the PendingIntent being mutable, e.g. if it needs to be used with inline replies or bubbles.
    이 문제는 최신 버전에서 해결되었습니다.

    이전 버전을 사용하려면 targetSdkVersion을 31 미만으로 설정하거나 해결 방법으로 build.gradle에 다음을 추가하면 됩니다. 

    // For apps targeting Android S+, add the following
constraints {
  implementation 'androidx.work:work-runtime:2.7.0-alpha04'
}

iOS 문제

  • M1 기반 Mac의 시뮬레이터는 지원되지 않습니다.
  • X86_64 시뮬레이터는 번역 'GoogleMLKit/Translate', '4.0.0' 이상 및 스마트 답장 'GoogleMLKit/SmartReply', '4.0.0' 이상에서 지원되지 않습니다.