已知问题

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.0com.google.mlkit:language-id:17.0.1 中出现崩溃,请添加以下规则:
    -keep class com.google.mlkit.nl.languageid.internal.ThickLanguageIdentifier { *; }
    
  • com.google.mlkit:face-detection:16.0.5com.google.android.gms:play-services-mlkit-barcode-scanning:16.1.4 开始,由具有非零 rotationDegrees 的位图构造的 InputImage 会导致 FaceDetection API 出现“无效旋转”MlKitException。请使用早期版本,并等待我们的下一个版本包含针对此问题的修复。
  • BarcodeScanning SDK pior 至 com.google.mlkit:barcode-scanning:16.1.0com.google.android.gms:play-services-mlkit-barcode-scanning:16.1.3 不适用于某些搭载 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 或 fragment 被销毁后执行。如果回调尝试访问在此期间已关闭的检测器,则可能会导致异常。如果您在 activity 中使用机器学习套件,则可以注册 activity 作用域监听器,该监听器会在 activity 停止时自动移除。如果您在 fragment 或其他环境中使用机器学习套件,则可以提供一个自定义执行器,该执行器会在 fragment 被销毁时关闭执行。如需查看示例,请参阅 Vision 快速入门中的 ScopedExecutor.Java

  • 对于使用除位图以外的图片格式进行的图片标签,捆绑的变体比依赖于 Google Play 服务的“瘦”变体的性能更高。

  • 对于 Digital Ink 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 模拟器不支持 Translation 'GoogleMLKit/Translate', '4.0.0' 或更高版本以及智能回复 'GoogleMLKit/SmartReply', '4.0.0' 或更高版本。