زاحف التطبيقات

استخدم أداة زاحف التطبيقات، وهي جزء من Jetpack، لاختبار تطبيقك تلقائيًا بدون الحاجة إلى كتابة أي رموز أو الاحتفاظ بها.

يعمل الزاحف بجانب تطبيقك، ويصدر الإجراءات تلقائيًا (النقر والتمرير السريع وما إلى ذلك) لاستكشاف مساحة الحالة لتطبيقك. ينتهي الزحف تلقائيًا عندما لا يكون هناك المزيد من الإجراءات الفريدة لتنفيذ أو يتعطل التطبيق أو عند انقضاء المهلة التي تحدّدها.

ويسهل إجراء الاختبار باستخدام الزاحف، لعدم وجود رمز يمكن كتابته أو صيانته. علاوةً على ذلك، يمكنك تشغيله على مجموعة متنوعة من الأجهزة للبحث عن الأعطال أو المشكلات المرئية أو مشكلات الأداء. عادةً ما يكون من الأفضل استخدام خدمة مستندة إلى السحابة الإلكترونية مثل Firebase Test Lab لاختبار مجموعات متعددة من أحجام الشاشات وإعدادات الأجهزة بسهولة وسرعة أكبر.

الجمهور المستهدَف

يستهدف زاحف التطبيقات مطوّري البرامج الذين يريدون ضمان وظائف التطبيق الأساسية بأقل قدر من الضبط. بالإضافة إلى اختبار المربع المشفّر تمامًا، يمكن ضبط الزاحف أيضًا لتوفير مدخلات محددة، مثل بيانات اعتماد تسجيل الدخول أو روابط لمواضع معيّنة.

البدء

قبل البدء، تأكَّد من توفُّر إصدار حديث من حزمة تطوير البرامج (SDK) لنظام التشغيل Android. ويتوفّر هذا التطبيق في استوديو Android. عند تثبيت حزمة تطوير برامج (SDK) مستقلة لنظام التشغيل Android، احرص على أن تتضمّن أحدث أدوات الإصدار وأدوات النظام الأساسي.

بعد ذلك، يمكنك تنزيل الأرشيف الثنائي للزاحف.

بعد ذلك، يمكنك تشغيل محاكي أو توصيل جهاز مادي باستخدام كابل USB. تأكَّد من اتصال الجهاز عن طريق تنفيذ الأمر التالي:

adb devices

لاستدعاء الزاحف، استخرِج الأرشيف أولاً إلى الدليل الذي تختاره. من هذا الدليل، يمكنك استدعاء الزاحف باستخدام الأمر التالي:

java -jar crawl_launcher.jar --apk-file path/to/my/app.apk --android-sdk path/to/my/android/sdk

خيارات الزاحف

يمكنك استخدام الخيارات التالية لاستدعاء الزاحف:

Option الوصف
--android-sdk path

تحدِّد المسار إلى حزمة تطوير البرامج (SDK) لنظام التشغيل Android.

هذه العلامة مطلوبة.

--apk-file file

تُحدِّد المسار إلى حزمة APK لتطبيقك، وهي أداة تعمل "زاحف التطبيقات" على تثبيتها والزحف إليها.

هذه علامة مطلوبة إذا لم يتم تحديد --app-package-name.

--app-package-name name

تحدِّد هذه العلامة اسم الحزمة لتطبيقك. ويمكنك استخدام هذا الخيار عندما يكون تطبيقك مثبَّتًا من قبل على الجهاز ولا يلزم إعادة تثبيته.

هذه علامة مطلوبة إذا لم يتم تحديد --apk-file.

--key-store path

تحدِّد المسار إلى ملف تخزين المفاتيح الذي يوقّع حِزم APK للزاحف وتطبيقك. استخدِم هذا الخيار عندما يتطلّب تطبيقك توقيعًا محدّدًا ليعمل بشكل سليم.

--key-store-password password

تحدّد كلمة المرور لملف تخزين المفاتيح الذي قدَّمته لخيار --key-store.

هذه علامة مطلوبة إذا تم تحديد --key-store.

--timeout-sec timeout

تحدد المهلة المحددة للزحف بالثواني. وإذا لم يتم تحديد ذلك، يتوقف الزحف بعد 60 ثانية.

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

تعذّر حذف ملفات التوقيع الأصلية

قبل بدء الزحف، قد تظهر لمستخدمي JDK 9 رسالة الخطأ التالية:

androidx.test.tools.crawler.launcher.exceptions.ApkSigningException: Failed to delete original signature files

إذا واجهت هذا السلوك، ننصحك باستخدام الإصدار 8 أو 10 من نظام التشغيل JDK أو الإصدارات الأحدث. لمزيد من المعلومات حول هذه المشكلة، يُرجى الاطّلاع على هذا الخطأ JDK 9. تمكّن بعض المستخدمين من حل المشكلة من خلال إعادة إنشاء حزمة APK باستخدام إصدار محدّث من "استوديو Android".

مراجع إضافية

لمزيد من المعلومات حول استخدام زاحف التطبيقات، راجِع الموارد التالية.

  • يتضمّن اختبار Robo Test Lab في Firebase مستندات تفصيلية بالإضافة إلى تعليمات حول كيفية إجراء اختبارات الزاحف على السحابة الإلكترونية.