ابدأ الاختبار باستخدام أنظمة التكامل المستمر (CI).

يمكنك استخدام Firebase Test Lab عند تطوير تطبيقك باستخدام أي نظام تكامل مستمر (CI). تتيح لك أنظمة التكامل المستمر إنشاء تطبيقك واختباره تلقائيًا في كل مرة تقوم فيها بالتحقق من تحديثات التعليمات البرمجية المصدر لتطبيقك.

استخدام Firebase Test Lab مع Jenkins CI

يصف هذا القسم كيفية استخدام Test Lab مع Jenkins CI .

متطلبات

قبل أن تتمكن من استخدام Firebase Test Lab مع Jenkins، يتعين عليك إكمال الخطوات التالية:

  1. قم بإعداد gcloud. اتبع الإرشادات الواردة من استخدام Firebase Test Lab من سطر أوامر gcloud لإنشاء مشروع Firebase وتهيئة بيئة Google Cloud SDK المحلية لديك.

  2. إنشاء وتخويل حساب الخدمة. لا تخضع حسابات الخدمة لعمليات التحقق من البريد العشوائي أو مطالبات captcha، والتي قد تؤدي إلى حظر إنشاءات CI الخاصة بك. أنشئ حساب خدمة بدور محرر في وحدة تحكم Google Cloud ثم قم بتنشيطه (راجع وثائق حساب gcloud authactivate-service-account للتعرف على كيفية القيام بذلك).

  3. تمكين واجهات برمجة التطبيقات المطلوبة. بعد تسجيل الدخول باستخدام حساب الخدمة: في صفحة مكتبة Google Developers Console API ، قم بتمكين Google Cloud Testing API و Cloud Tool Results API . لتمكين واجهات برمجة التطبيقات هذه، اكتب أسماء واجهات برمجة التطبيقات هذه في مربع البحث الموجود أعلى وحدة التحكم، ثم انقر فوق تمكين واجهة برمجة التطبيقات في صفحة النظرة العامة لواجهة برمجة التطبيقات هذه.

تثبيت وإعداد جنكينز

يمكنك تثبيت Jenkins CI وإعداده على Linux أو Windows. بعض تفاصيل هذا الدليل خاصة بتثبيت Jenkins CI وتشغيله على Linux، بما في ذلك استخدام الخطوط المائلة ( / ) في مسارات الملفات.

لتنزيل Jenkins وتثبيته على جهاز كمبيوتر يعمل بنظام التشغيل Linux أو Windows، اتبع الإرشادات الموجودة على تثبيت Jenkins . بعد تثبيت Jenkins، اتبع الإرشادات الموجودة على بدء Jenkins والوصول إليه لإكمال الإعداد والوصول إلى لوحة معلومات Jenkins.

تكوين إعدادات الأمان العالمية

لم يتم تكوين مصادقة المستخدم والتحكم في الوصول عند تثبيت Jenkins لأول مرة. قبل استخدام Jenkins مع Firebase Test Lab، قم بتكوين إعدادات الأمان العامة لفرض التحكم في الوصول ومصادقة المستخدمين.

لتكوين إعدادات الأمان العالمية

  1. انتقل إلى لوحة معلومات Jenkins على الخادم الخاص بك. للقيام بذلك، استعرض http://<servername>:8080 ، حيث <servername> هو اسم الكمبيوتر الذي قمت بتثبيت Jenkins عليه.
  2. في لوحة معلومات Jenkins، انقر فوق Manage Jenkins ، ثم انقر فوق Configure Global Security .
  3. في صفحة تكوين الأمان الشامل ، انقر فوق تمكين الأمان ، ثم انقر فوق حفظ .

لمزيد من المعلومات حول تكوين إعدادات الأمان لـ Jenkins، راجع الأمان السريع والبسيط وإعداد الأمان القياسي وتأمين Jenkins .

إنشاء مشروع جنكينز

بعد ذلك، أنشئ مشروعًا لتشغيل اختبار التكامل المستمر لتطبيقك باستخدام Firebase Test Lab.

لإنشاء مشروع جنكينز

  1. انتقل إلى لوحة معلومات Jenkins على الخادم الخاص بك. للقيام بذلك، استعرض http://<servername>:8080 ، حيث <servername> هو اسم الكمبيوتر الذي قمت بتثبيت Jenkins عليه.
  2. في لوحة معلومات Jenkins، انقر فوق عنصر جديد .
  3. اكتب اسمًا لمشروعك في حقل اسم العنصر :
    • اختر مشروع Freestyle لإنشاء مشروع يستخدم تكوين بناء واحد.
    • اختر إنشاء مشروع متعدد التكوين لإنشاء مشروع يتم تشغيله على عدة تكوينات بناء مختلفة. إذا كنت تخطط لإنشاء تطبيقك باستخدام مجموعة متنوعة من تكوينات البناء (لغات متعددة، ومستويات متعددة لواجهة برمجة تطبيقات Android، وما إلى ذلك)، فإن المشروع متعدد التكوين هو الخيار الأفضل.
  4. انقر فوق حفظ .

بعد إنشاء مشروعك، يعرض متصفح الويب الخاص بك الصفحة الرئيسية لمشروعك.

أضف التحكم في المراجعة وخطوات إنشاء Gradle

يصف هذا القسم كيفية دمج Jenkins مع أنظمة التحكم في المراجعة مثل GitHub، وكيفية إضافة خطوات إنشاء Gradle لإنشاء حزم APK من التعليمات البرمجية المصدر.

التكامل مع GitHub وأنظمة التحكم في المراجعة الأخرى

إذا كنت تستخدم GitHub أو أي نظام آخر للتحكم في المراجعة لإدارة التعليمات البرمجية المصدر لتطبيقك، فيمكنك تكوين Jenkins لتشغيل الإصدارات التلقائية وإجراء الاختبارات في كل مرة يتم فيها التحقق من تحديثات تطبيقك. يمكنك أيضًا تكوين Jenkins لتشغيل الإصدارات بشكل دوري.

للتعرف على تكوين الإصدارات في Jenkins، راجع تكوين الإصدارات التلقائية .

إضافة خطوات بناء Gradle لإعادة بناء حزم APK

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

  1. أضف خطوة إنشاء لتشغيل الأوامر التالية في الدليل الرئيسي لتطبيقك:

    ./gradlew :app:assembleDebug
    ./gradlew :app:assembleDebugAndroidTest
    

  2. أضف خطوة إنشاء لاستخدام حزمة (حزم) APK التي أنشأها Gradle عند الاختبار باستخدام Test Lab. يمكنك استخدام هذا المسار باعتباره <local_server_path> في مثال البرنامج النصي Shell الموضح أدناه، حيث يكون <AppFolder> هو مجلد مشروع Android Studio لتطبيقك:

    <AppFolder>/app/build/outputs/apk
    

أضف خطوات بناء Test Lab إلى Jenkins

أنت الآن جاهز لإضافة خطوة إنشاء إلى Jenkins لتشغيل Test Lab باستخدام سطر أوامر gcloud.

لإضافة خطوة بناء gcloud

  1. من الصفحة الرئيسية لمشروعك، انقر فوق تكوين .
  2. في صفحة تكوين المشروع ، قم بالتمرير لأسفل إلى قسم البناء ، ثم اختر تنفيذ الصدفة من قائمة إضافة خطوة بناء .

  3. في نافذة أمر Jenkins Execute Shell ، أدخل ما يلي، مع استبدال <local_server_path> بالمسار إلى نموذج التطبيق على الخادم، و<app_apk> لملف APK الخاص بتطبيقك، و <app_test_apk> لملف APK الاختباري لتطبيقك:

    gcloud firebase test android run --app <local_server_path>/<app_apk>.apk
    --test <local_server_path>/<app_test_apk>.apk
    

تحليل نتائج الاختبار

بعد انتهاء Test Lab من اختبار تطبيقك، يمكنك مراجعة نتائج الاختبار في وحدة تحكم Firebase أو في مجموعة Google Cloud Storage في مشروعك. يمكنك أيضًا إضافة أمر gsutil إلى أمر shell الموضح أعلاه لنسخ بيانات نتائج الاختبار إلى جهاز الكمبيوتر المحلي الخاص بك. لمعرفة المزيد، راجع تحليل نتائج معمل اختبار Firebase .

التكامل المستمر مع أنظمة CI الأخرى

لمعرفة كيفية استخدام Firebase Test Lab مع أنظمة CI الأخرى، راجع المستندات الخاصة بها: