알려진 문제

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>;
}

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

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