알려진 문제

Android 문제

  • 번들 언어 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 { *; }
  • rotationDegrees가 0이 아닌 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에서 이미지의 형식을 변환하는 데 시간이 더 걸리기 때문입니다.

  • 작업 콜백은 등록된 Activity 또는 Fragment가 소멸된 후에 실행될 수 있습니다. 이렇게 하면 콜백이 그동안 닫힌 감지기에 액세스하려고 하면 예외가 발생할 수 있습니다. Activity에서 ML Kit를 사용하는 경우 Activity가 중지될 때 자동으로 삭제되는 Activity 범위 리스너를 등록할 수 있습니다. Fragment 또는 다른 환경에서 ML Kit를 사용하는 경우 Fragment가 소멸될 때 실행을 종료하는 맞춤 실행자를 제공할 수 있습니다. 예시는 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' 이상에서 지원되지 않습니다.