Masalah umum

Masalah Android

  • Untuk ID Bahasa paket, aplikasi mungkin error saat mengupgrade ke AGP 7.0.0 atau yang lebih baru. Untuk menghindari error di com.google.mlkit:language-id:16.1.1 atau yang lebih lama, sertakan aturan di bawah ini:
    -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 ini:
    -keep class com.google.mlkit.nl.languageid.internal.ThickLanguageIdentifier { *; }
    
  • InputImage yang dibuat oleh Bitmap dengan rotasi non-zeroDegrees menyebabkan "rotasi tidak valid" MlKitException 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.
  • BarcodeScanning SDK sejak 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 menjalankan camera-camera2:1.0.0-beta08 versi atau yang lebih baru. Anda dapat menggunakan versi lama camera-camera2 untuk mengabaikan 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 Objek dan Pelacakan, performa dengan CameraX dan Camera2 masih belum setara dengan Camera1, karena memerlukan lebih banyak waktu untuk melakukan konversi format untuk gambar dari CameraX dan Camera2.

  • Callback Task dapat dieksekusi setelah Aktivitas atau Fragmen tempatnya terdaftar telah dihancurkan. Hal ini dapat menyebabkan pengecualian jika callback mencoba mengakses detektor yang telah ditutup selama proses ini. Jika menggunakan ML Kit dalam Aktivitas, Anda dapat mendaftarkan pemroses cakupan Aktivitas, yang otomatis dihapus saat Aktivitas dihentikan. Jika menggunakan ML Kit dalam Fragment atau lingkungan lainnya, 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 yang dipaketkan memiliki performa yang lebih baik daripada varian "tipis" yang bergantung pada Layanan Google Play.

  • Untuk Digital Ink com.google.mlkit:digital-ink-recognition:17.0.0 atau yang lebih lama dan Ekstraksi Entity 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 lebih suka menggunakan versi yang lebih lama, Anda dapat menetapkan targetSdkVersion ke kurang dari 31 atau menambahkan kode berikut ke build.gradle sebagai solusinya.

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

Masalah iOS

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