المشاكل المعروفة

مشاكل Android

• بالنسبة إلى معرِّف اللغة المُجمَّع، قد يتعطّل التطبيق عند الترقية إلى الإصدار 7.0.0 من AGP أو الإصدارات الأحدث. لتجنُّب التعطُّل في 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 { *; }
  

• تؤدي الصورة الإدخال التي تم إنشاؤها بواسطة الصورة النقطية باستخدام درجات تدوير غير صفرية إلى "تدوير غير صالح" MlKitException لواجهة برمجة تطبيقات FaceDetection API منذ 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 على بعض الأجهزة التي تعمل بالإصدار 2: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>;
  }

• بالنسبة إلى واجهات برمجة التطبيقات "التعرّف على النص" و"تصنيف الصور" و"رصد الأشياء وتتبّعها"، لا يزال الأداء في تطبيقَي CameraX والكاميرا ليس متساويًا مع تطبيق "كاميرا1" لأنّ عملية تحويل تنسيق الصور من "كاميراX" و"كاميرا2" تتطلّب وقتًا أطول.

• قد يتم تنفيذ عمليات استدعاء المهمة بعد تدمير النشاط أو الجزء الذي تم تسجيلهم فيه. وقد يؤدي ذلك إلى حدوث استثناء إذا حاولت معاودة الاتصال الوصول إلى أداة رصد تم إغلاقها في هذه الأثناء. إذا كنت تستخدم حزمة تعلّم الآلة في نشاط معيّن، يمكنك تسجيل أداة معالجة على مستوى النشاط، والتي تتم إزالتها تلقائيًا عند إيقاف النشاط. إذا كنت تستخدم أدوات تعلّم الآلة في جزء من جزء أو بيئة أخرى، يمكنك توفير أداة تنفيذ مخصّصة توقِف التنفيذ عند تدمير الجزء. اطّلع على ScopedExecutor.Java في Vision Quickstart للحصول على مثال.

• بالنسبة إلى ميزة "تصنيف الصور" التي تستخدم تنسيقات صور أخرى غير الصور النقطية، تحقّق الصيغة المجمّعة أداءً أفضل من الصيغة "الرقيقة" التي تعتمد على "خدمات Google Play".

• بالنسبة إلى الإصدار com.google.mlkit:digital-ink-recognition:17.0.0 من Digital Ink أو الإصدارات الأقدم واستخراج الكيانات 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

• لا يتم دعم المحاكيات على نظام التشغيل Mac الذي يستند إلى M1.
• محاكي X86_64 غير متاح للترجمة 'GoogleMLKit/Translate', '4.0.0' أو الإصدارات الأحدث ولا تتوفّر ميزة "الرد السريع" 'GoogleMLKit/SmartReply', '4.0.0' أو الإصدارات الأحدث.