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

مشاكل Android

• بالنسبة إلى حزمة Language ID، قد يتعطّل التطبيق عند الترقية إلى الإصدار 7.0.0 أو إصدار أحدث من "المكوّن الإضافي لنظام Gradle المتوافق مع Android". لتجنُّب التعطُّل في الإصدار 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 غير صفرية في حدوث خطأ "تدوير غير صالح" (invalid rotation) في MlKitException لواجهة برمجة التطبيقات FaceDetection، وذلك لأنّ com.google.mlkit:face-detection:16.0.5 وcom.google.android.gms:play-services-mlkit-barcode-scanning:16.1.4. يُرجى استخدام إصدار أقدم والانتظار إلى حين طرح الإصدار التالي الذي يتضمّن حلاً لهذه المشكلة.

• لا تعمل حِزم تطوير البرامج (SDK) الخاصة بخدمة BarcodeScanning التي تسبق الإصدار com.google.mlkit:barcode-scanning:16.1.0 والإصدار com.google.android.gms:play-services-mlkit-barcode-scanning:16.1.3 على بعض الأجهزة التي تعمل بالإصدار 1.0.0-beta08 أو الإصدارات الأحدث من camera-camera2. يمكنك استخدام إصدار أقدم من 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 وCamera2 غير مماثل للأداء باستخدام Camera1، لأنّ تحويل تنسيق الصورة يستغرق وقتًا أطول عند استخدام CameraX وCamera2.

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

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

• بالنسبة إلى الإصدار com.google.mlkit:digital-ink-recognition:17.0.0 أو الإصدارات الأقدم من Digital Ink والإصدار com.google.mlkit:entity-extraction:16.0.0-beta2 أو الإصدارات الأقدم من Entity Extraction، سيظهر لك استثناء وقت التشغيل التالي إذا ضبطت 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' أو الإصدارات الأحدث من "الرد الذكي".