Masalah umum
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Masalah Android
- Untuk ID Bahasa yang dipaketkan, 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 yang bukan nol menyebabkan "invalid rotation"
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 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 camera-camera2 versi sebelumnya 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, dan Deteksi dan Pelacakan Objek, performa dengan CameraX dan Camera2 masih belum setara dengan Camera1, karena perlu waktu lebih lama untuk melakukan konversi format gambar dari CameraX dan Camera2.
Callback Tugas
mungkin dieksekusi setelah Aktivitas atau Fragmen tempat callback tersebut
didaftarkan telah dihancurkan. Hal ini dapat menyebabkan pengecualian jika callback
mencoba mengakses detektor yang telah ditutup sementara. Jika menggunakan ML Kit dalam Aktivitas, Anda dapat mendaftarkan pemroses cakupan Aktivitas, yang akan otomatis dihapus saat Aktivitas dihentikan. Jika menggunakan
ML Kit di Fragment atau lingkungan lain, Anda dapat menyediakan eksekutor
kustom yang menonaktifkan eksekusi saat Fragment dihancurkan. Lihat
ScopedExecutor.Java di Panduan Memulai Vision untuk
mengetahui contohnya.
Untuk Pemberian Label Gambar dengan format gambar selain Bitmap, varian yang dipaketkan
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 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 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 Terjemahan
'GoogleMLKit/Translate', '4.0.0' atau yang lebih baru dan Smart Reply 'GoogleMLKit/SmartReply', '4.0.0' atau yang lebih baru.
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-08-29 UTC.
[null,null,["Terakhir diperbarui pada 2025-08-29 UTC."],[[["\u003cp\u003eUpgrading to AGP 7.0.0+ with bundled Language ID may cause crashes, requiring specific keep rules to be added for different versions.\u003c/p\u003e\n"],["\u003cp\u003eInputImage created with Bitmap and rotationDegrees may cause errors with FaceDetection API in specific versions; use earlier versions or await a fix.\u003c/p\u003e\n"],["\u003cp\u003eBarcodeScanning SDKs before 16.1.0/16.1.3 have compatibility issues with camera-camera2:1.0.0-beta08+, consider using earlier camera-camera2 versions.\u003c/p\u003e\n"],["\u003cp\u003eTask callbacks may execute after Activity/Fragment destruction, potentially causing exceptions; use Activity-scoped listeners or custom executors for mitigation.\u003c/p\u003e\n"],["\u003cp\u003eOn Android S with targetSdkVersion 31, Digital Ink and Entity Extraction SDKs before specific versions may cause runtime exceptions regarding PendingIntent flags; upgrade to newer SDKs or apply a workaround.\u003c/p\u003e\n"]]],["Key actions and information regarding Android issues include: adding specific `-keep` rules to avoid crashes when using Language ID with AGP 7.0.0 or later; using earlier versions of Face Detection and Barcode Scanning due to \"invalid rotation\" and camera compatibility issues; adding a rule to fix `UnsatisfiedLinkError` with Language ID. Performance with CameraX/Camera2 is not optimized for Text Recognition, Image Labeling, and Object Detection. Activity-scoped listeners can be registered to prevent exceptions with Task callbacks. Setting `targetSdkVersion` or adding constraints to address Digital Ink and Entity Extraction issues.\n"],null,["Android issues\n\n- For bundled Language ID, the app may crash when upgrading to AGP 7.0.0 or later. To avoid the crash in `com.google.mlkit:language-id:16.1.1` or earlier, include the rule below: \n\n ```scdoc\n -keep class com.google.mlkit.nl.languageid.internal.LanguageIdentificationJni { *; }\n ```\n To avoid the crash in `com.google.mlkit:language-id:17.0.0` or `com.google.mlkit:language-id:17.0.1`, include the rule below: \n\n ```scdoc\n -keep class com.google.mlkit.nl.languageid.internal.ThickLanguageIdentifier { *; }\n ```\n- InputImage constructed by Bitmap with a non zero rotationDegrees causes an \"invalid rotation\" MlKitException for FaceDetection API since `com.google.mlkit:face-detection:16.0.5` and `com.google.android.gms:play-services-mlkit-barcode-scanning:16.1.4`. Please use an earlier version and wait for our next release which includes the fix for this issue.\n- BarcodeScanning SDKs pior to `com.google.mlkit:barcode-scanning:16.1.0`\n and `com.google.android.gms:play-services-mlkit-barcode-scanning:16.1.3`\n do not work on some devices running with camera-camera2:1.0.0-beta08 version or later.\n You can use an earlier version of camera-camera2 to bypass this issue. For example:\n\n ```carbon\n implementation \"androidx.camera:camera-core:1.0.0-beta07\"\n implementation \"androidx.camera:camera-camera2:1.0.0-beta07\"\n implementation \"androidx.camera:camera-view:1.0.0-alpha14\"\n implementation \"androidx.camera:camera-extensions:1.0.0-alpha14\"\n implementation \"androidx.camera:camera-lifecycle:1.0.0-beta07\"\n ```\n\n \u003cbr /\u003e\n\n- Native methods might be obfuscated by custom rules in `com.google.mlkit:language-id:16.1.1` or earlier.\n Include the following rule to keep them if you encounter errors like `java.lang.UnsatisfiedLinkError`:\n\n ```text\n -keepclasseswithmembernames class com.google.mlkit.nl.languageid.internal.LanguageIdentificationJni {\n native \u003cmethods\u003e;\n }\n ```\n\n \u003cbr /\u003e\n\n- For the Text Recognition, Image Labeling, and Object Detection and\n Tracking APIs, the performance with CameraX and Camera2 is still not on par\n with Camera1, because it takes more time to do format conversion for image\n from CameraX and Camera2.\n\n- [Task](https://developers.google.com/android/guides/tasks)\n callbacks might execute after the Activity or Fragment in which they have been\n registered has been destroyed. This might lead to an exception if the callback\n tries to access a detector that has been closed in the meantime. If you are\n using ML Kit in an Activity, you can register an\n [Activity-scoped listener](https://developers.google.com/android/guides/tasks#activity-scoped_listeners),\n which is automatically removed when the Activity is stopped. If you are\n using ML Kit in a Fragment or other environment, you can provide a custom\n executor that shuts down execution when the Fragment is destroyed. See\n `ScopedExecutor.Java` in the [Vision Quickstart](https://github.com/googlesamples/mlkit/tree/master/android/vision-quickstart) for an\n example.\n\n- For Image Labeling with image formats other than Bitmap, bundled variant\n has better performance than \"thin\" variant that depends on Google Play Services.\n\n- For Digital Ink `com.google.mlkit:digital-ink-recognition:17.0.0` or earlier\n and Entity Extraction `com.google.mlkit:entity-extraction:16.0.0-beta2` or earlier,\n you will get the following runtime exception if you set `targetSdkVersion` to 31\n and run on Android S.\n\n Targeting S+ (version 31 and above) requires that one of FLAG_IMMUTABLE or FLAG_MUTABLE be specified when creating a PendingIntent.\n 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.\n\n This issue is fixed in our more recent releases.\n\n \u003cbr /\u003e\n\n If you prefer using older versions, you can either set `targetSdkVersion` to\n less than 31 or add the following to your `build.gradle` as a workaround. \n\n ```carbon\n // For apps targeting Android S+, add the following\n constraints {\n implementation 'androidx.work:work-runtime:2.7.0-alpha04'\n }\n ```\n\n \u003cbr /\u003e\n\niOS issues\n\n- Simulators on M1-based Mac are not supported.\n- X86_64 simulator is not supported for Translation `'GoogleMLKit/Translate', '4.0.0'` or later and Smart Reply `'GoogleMLKit/SmartReply', '4.0.0'` or later."]]
