مسائل شناخته شده
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
مشکلات اندروید
- برای شناسه زبان همراه، برنامه ممکن است هنگام ارتقاء به 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 { *; } - InputImage ساخته شده توسط Bitmap با درجه چرخش غیر صفر باعث ایجاد یک "چرخش نامعتبر" MlKitException برای FaceDetection API از
com.google.mlkit:face-detection:16.0.5 و com.google.android.gms:play-services-mlkit-barcode-scanning:16.1.4 . لطفاً از نسخه قبلی استفاده کنید و منتظر نسخه بعدی ما باشید که شامل رفع این مشکل است. BarcodeScanning SDK های مربوط به com.google.mlkit:barcode-scanning:16.1.0 و 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 به زمان بیشتری نیاز دارد.
فراخوانی های Task ممکن است پس از نابودی Activity یا Fragment که در آن ثبت شده اند اجرا شوند. این ممکن است منجر به یک استثنا شود اگر پاسخ تماس سعی کند به یک آشکارساز که در این مدت بسته شده است دسترسی پیدا کند. اگر از ML Kit در یک فعالیت استفاده می‌کنید، می‌توانید یک شنونده با محدوده فعالیت ثبت کنید، که با توقف فعالیت به طور خودکار حذف می‌شود. اگر از کیت ML در یک Fragment یا محیط دیگر استفاده می کنید، می توانید یک اجرا کننده سفارشی ارائه دهید که هنگام از بین رفتن Fragment، اجرا را خاموش می کند. برای مثال به ScopedExecutor.Java در Vision Quickstart مراجعه کنید.
برای برچسب‌گذاری تصویر با فرمت‌های تصویری غیر از Bitmap، نوع همراه عملکرد بهتری نسبت به نوع نازک دارد که به خدمات Google Play بستگی دارد.
برای Digital Ink com.google.mlkit:digital-ink-recognition:17.0.0 یا قدیمی تر و Entity Extraction 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 پشتیبانی نمی شوند.
- شبیه‌ساز X86_64 برای ترجمه
'GoogleMLKit/Translate', '4.0.0' یا جدیدتر و Smart Reply 'GoogleMLKit/SmartReply', '4.0.0' یا جدیدتر پشتیبانی نمی‌شود.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی."],[[["\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."]]
