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

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

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

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

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

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

الخطوات الأولى

قبل البدء، تأكّد من أنّك تستخدم إصدارًا حديثًا من حزمة تطوير البرامج (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"

مصادر إضافية

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