本頁面由 Cloud Translation API 翻譯而成。

已知問題

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 { *; }
```
由 Bitmap 建構且包含非 0rororo 常變的 InputImage 會產生「無效旋轉」 FaceDetection API 的 MlKitException (自 com.google.mlkit:face-detection:16.0.5 起) 和 com.google.android.gms:play-services-mlkit-barcode-scanning:16.1.4。請使用更早的時間更新版本，並等待下一個版本修正此問題。

「com.google.mlkit:barcode-scanning:16.1.0」的條碼掃描 SDK 和com.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
工作回呼可能會在呼叫 Activity 或 Fragment 後才執行已註冊。這可能會導致發生例外狀況，會嘗試存取目前已關閉的偵測工具。如果您是在活動中使用 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' 以上版本。