알려진 문제

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 { *; }
  • 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>;
}

  • Text Recognition, Image Labeling, Object Detection and Tracking API의 경우 CameraX 및 Camera2의 성능은 Camera1과 동등하지 않습니다. CameraX 및 Camera2에서 이미지의 형식을 변환하는 데 더 많은 시간이 걸리기 때문입니다.

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

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

  • Digital Ink com.google.mlkit:digital-ink-recognition:17.0.0 이하 버전 및 Entity Extraction 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 시뮬레이터는 Translation 'GoogleMLKit/Translate', '4.0.0' 이상 및 스마트 답장 'GoogleMLKit/SmartReply', '4.0.0' 이상에서 지원되지 않습니다.