알려진 문제

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 { *; }
  • com.google.mlkit:face-detection:16.0.5 및 com.google.android.gms:play-services-mlkit-barcode-scanning:16.1.4 이후 FaceDetection API의 경우 0이 아닌 rotationDegrees로 Bitmap에서 생성된 InputImage로 인해 '잘못된 회전' 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의 이미지 형식 변환에 시간이 더 오래 걸리므로 CameraX 및 Camera2의 성능은 여전히 Camera1과 동일하지 않습니다.

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

  • Bitmap 이외의 이미지 형식으로 이미지 라벨링을 하는 경우 번들 변형이 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' 이상에서 지원되지 않습니다.