Masalah umum

Masalah Android

  • Untuk ID Bahasa yang di-bundle, aplikasi dapat mengalami 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:
    -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 non-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 mencakup 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 versi camera-camera2:1.0.0-beta08 atau 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 diperlukan lebih banyak waktu untuk melakukan konversi format gambar dari CameraX dan Camera2.

  • Callback Task dapat dieksekusi setelah Aktivitas atau Fragmen tempat callback tersebut didaftarkan dihancurkan. Hal ini dapat menyebabkan pengecualian jika callback mencoba mengakses detektor yang telah ditutup sementara itu. Jika Anda menggunakan ML Kit dalam Aktivitas, Anda dapat mendaftarkan listener cakupan Aktivitas, yang akan dihapus secara otomatis 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 "tipis" yang bergantung pada Layanan Google Play.

  • Untuk Tinta Digital com.google.mlkit:digital-ink-recognition:17.0.0 atau yang lebih lama dan Ekstraksi Entitas com.google.mlkit:entity-extraction:16.0.0-beta2 atau yang lebih lama, Anda akan mendapatkan pengecualian runtime berikut jika Anda menyetel targetSdkVersion ke 31 dan menjalankan 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 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.