مسائل شناخته شده

مشکلات اندروید

  • برای شناسه زبان همراه، ممکن است برنامه هنگام ارتقا به 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 با rotationDegrees غیر صفر باعث ایجاد خطای MlKitException با عنوان "چرخش نامعتبر" برای API FaceDetection می‌شود، زیرا com.google.mlkit:face-detection:16.0.5 و com.google.android.gms:play-services-mlkit-barcode-scanning:16.1.4 . لطفاً از نسخه قبلی استفاده کنید و منتظر نسخه بعدی ما باشید که شامل رفع این مشکل است.

  • 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"

  • متدهای native ممکن است توسط قوانین سفارشی در 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 زمان بیشتری می‌برد.

  • فراخوانی‌های وظیفه ممکن است پس از تخریب Activity یا Fragment که در آن ثبت شده‌اند، اجرا شوند. اگر فراخوانی سعی کند به یک آشکارساز که در این فاصله بسته شده است دسترسی پیدا کند، ممکن است منجر به یک استثنا شود. اگر از ML Kit در یک Activity استفاده می‌کنید، می‌توانید یک شنونده Activity-scoped ثبت کنید که با توقف Activity به طور خودکار حذف می‌شود. اگر از ML Kit در یک Fragment یا محیط دیگر استفاده می‌کنید، می‌توانید یک اجراکننده سفارشی ایجاد کنید که هنگام تخریب Fragment، اجرا را متوقف کند. برای مثال به ScopedExecutor.Java در Vision Quickstart مراجعه کنید.

  • برای برچسب‌گذاری تصویر با فرمت‌های تصویری غیر از Bitmap، نوع bundled عملکرد بهتری نسبت به نوع "thin" که به سرویس‌های 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 روی ۳۱ تنظیم کنید و روی اندروید 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 را کمتر از ۳۱ تنظیم کنید یا به عنوان یک راه حل، کد زیر را به 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' یا بالاتر و پاسخ هوشمند 'GoogleMLKit/SmartReply', '4.0.0' یا بالاتر پشتیبانی نمی‌شود.