已知問題

Android 問題

  • 在 com.google.mlkit:genai-prompt:1.0.0-beta3 和 com.google.mlkit:genai-prompt:1.0.0-beta4 中，如果應用程式將 kotlinx-coroutines 解析為 1.10.x 或更早版本，則在模型下載完成或取消時，呼叫 download() 會擲回 java.lang.NoSuchMethodError。在我們於下一個版本提供修正程式之前，請在 Gradle 依附元件中明確將 kotlinx-coroutines-android 固定至 1.11.0 或更新版本，做為因應措施。
  • 在 com.google.mlkit:genai-prompt:1.0.0-beta3 和 com.google.mlkit:genai-prompt:1.0.0-beta4 中，如果 ModelConfig 設為 ModelPreference.FAST，則使用前置字元快取對 nano-v4 模型執行推論會失敗。在我們於下一個版本提供修正程式之前，請省略 ModelConfig 設定，改用預設設定。
  • 在 com.google.mlkit:genai-prompt:1.0.0-beta3 中，在非 Pixel 裝置上呼叫 checkStatus() 會擲回未處理的 GenAiException。請使用較新版本 (com.google.mlkit:genai-prompt:1.0.0-beta4 以上)。
  • 如果使用套裝組合語言 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 起，由 Bitmap 建構且 rotationDegrees 不為零的 InputImage 會導致 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 的圖片格式轉換需要更多時間。

  • Task 回呼可能會在註冊的 Activity 或 Fragment 刪除後執行。如果回呼嘗試存取已關閉的偵測器，可能會導致例外狀況。如果您在 Activity 中使用 ML Kit，可以註冊活動範圍事件監聽器，當活動停止時，系統會自動移除該事件監聽器。如果您在 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 模擬器不支援 Translation 'GoogleMLKit/Translate', '4.0.0' 以上版本和 Smart Reply 'GoogleMLKit/SmartReply', '4.0.0' 以上版本。