Masalah umum

Masalah Android

  • Di com.google.mlkit:genai-prompt:1.0.0-beta3 dan com.google.mlkit:genai-prompt:1.0.0-beta4, memanggil download() akan menampilkan java.lang.NoSuchMethodError saat download model selesai atau dibatalkan jika aplikasi me-resolve kotlinx-coroutines ke 1.10.x atau yang lebih lama. Sebagai solusi, sematkan kotlinx-coroutines-android secara eksplisit ke 1.11.0 atau yang lebih baru dalam dependensi Gradle Anda hingga kami memberikan perbaikan dalam rilis berikutnya.
  • Di com.google.mlkit:genai-prompt:1.0.0-beta3 dan com.google.mlkit:genai-prompt:1.0.0-beta4, menjalankan inferensi dengan prefix caching gagal pada model nano-v4 saat ModelConfig ditetapkan ke ModelPreference.FAST. Sebagai solusinya, hapus setelan ModelConfig untuk menggunakan konfigurasi default, hingga kami memberikan perbaikan dalam rilis berikutnya.
  • Di com.google.mlkit:genai-prompt:1.0.0-beta3, memanggil checkStatus() di perangkat non-Pixel akan menampilkan GenAiException yang tidak tertangani. Gunakan versi yang lebih baru (com.google.mlkit:genai-prompt:1.0.0-beta4 atau yang lebih baru).
  • Untuk Language ID yang dipaketkan, aplikasi mungkin mengalami error saat diupgrade ke AGP 7.0.0 atau yang lebih baru. Untuk menghindari error di com.google.mlkit:language-id:16.1.1 atau versi yang lebih lama, sertakan aturan di bawah: 
    -keep class com.google.mlkit.nl.languageid.internal.LanguageIdentificationJni { *; }
     Untuk menghindari error di com.google.mlkit:language-id:17.0.0 atau com.google.mlkit:language-id:17.0.1, sertakan aturan di bawah: 
    -keep class com.google.mlkit.nl.languageid.internal.ThickLanguageIdentifier { *; }
  • InputImage yang dibuat oleh Bitmap dengan rotationDegrees bukan nol menyebabkan MlKitException "rotasi tidak valid" untuk FaceDetection API sejak com.google.mlkit:face-detection:16.0.5 dan com.google.android.gms:play-services-mlkit-barcode-scanning:16.1.4. Gunakan versi sebelumnya dan tunggu rilis berikutnya yang menyertakan perbaikan untuk masalah ini.

  • SDK BarcodeScanning sebelum com.google.mlkit:barcode-scanning:16.1.0 dan com.google.android.gms:play-services-mlkit-barcode-scanning:16.1.3 tidak berfungsi di beberapa perangkat yang berjalan dengan camera-camera2:1.0.0-beta08 atau versi yang lebih baru. Anda dapat menggunakan versi camera-camera2 yang lebih lama untuk mengatasi masalah ini. Contoh: 

    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"

  • Metode native mungkin di-obfuscate oleh aturan kustom di com.google.mlkit:language-id:16.1.1 atau yang lebih lama. Sertakan aturan berikut untuk mempertahankannya jika Anda mengalami error seperti java.lang.UnsatisfiedLinkError: 

    -keepclasseswithmembernames class com.google.mlkit.nl.languageid.internal.LanguageIdentificationJni {
  native <methods>;
}

  • Untuk API Pengenalan Teks, Pelabelan Gambar, serta Deteksi dan Pelacakan Objek, performa dengan CameraX dan Camera2 masih belum setara dengan Camera1, karena memerlukan lebih banyak waktu untuk melakukan konversi format gambar dari CameraX dan Camera2.

  • Callback Task mungkin dijalankan setelah Aktivitas atau Fragmen tempat callback tersebut didaftarkan dihancurkan. Hal ini dapat menyebabkan pengecualian jika callback mencoba mengakses detektor yang telah ditutup sementara. Jika Anda menggunakan ML Kit dalam Aktivitas, Anda dapat mendaftarkan Pemroses cakupan aktivitas, yang otomatis dihapus saat Aktivitas dihentikan. Jika Anda menggunakan ML Kit di Fragment atau lingkungan lain, Anda dapat menyediakan eksekutor kustom yang menghentikan eksekusi saat Fragment dihancurkan. Lihat ScopedExecutor.Java di Panduan Memulai Vision untuk mengetahui contohnya.

  • Untuk Pelabelan Gambar dengan format gambar selain Bitmap, varian paket memiliki performa yang lebih baik daripada varian "ringan" yang bergantung pada Layanan Google Play.

  • Untuk Digital Ink com.google.mlkit:digital-ink-recognition:17.0.0 atau yang lebih lama dan Entity Extraction com.google.mlkit:entity-extraction:16.0.0-beta2 atau yang lebih lama, Anda akan mendapatkan pengecualian runtime berikut jika menetapkan targetSdkVersion ke 31 dan menjalankannya di 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.
    Masalah ini telah diperbaiki dalam rilis terbaru kami.

    Jika Anda lebih suka menggunakan versi yang lebih lama, Anda dapat menetapkan targetSdkVersion ke kurang dari 31 atau menambahkan kode berikut ke build.gradle sebagai solusi. 

    // For apps targeting Android S+, add the following
constraints {
  implementation 'androidx.work:work-runtime:2.7.0-alpha04'
}

Masalah iOS

  • Simulator di Mac berbasis M1 tidak didukung.
  • Simulator X86_64 tidak didukung untuk Translation 'GoogleMLKit/Translate', '4.0.0' atau yang lebih baru dan Smart Reply 'GoogleMLKit/SmartReply', '4.0.0' atau yang lebih baru.