بدء الاختبار باستخدام أنظمة التكامل المستمر (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. إنشاء حساب خدمة ومنحه إذن الوصول لا تخضع حسابات الخدمة لعمليات التحقّق من المحتوى غير المرغوب فيه أو لطلبات إدخال رمز التحقّق، ما قد يؤدي إلى حظر عمليات إنشاء التكامل المتواصل. أنشئ حساب خدمة لديه دور محرِّر في Google Cloud وحدة التحكّم ثم فعِّله (راجِع مستندات gcloud auth activate-service-account لمعرفة كيفية إجراء ذلك).

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

تثبيت Jenkins وإعداده

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

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

ضبط إعدادات الأمان العامة

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

لضبط إعدادات الأمان العامة، اتّبِع الخطوات التالية:

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

لمزيد من المعلومات حول ضبط إعدادات الأمان في Jenkins، يُرجى الاطّلاع على Quick and Simple Security وStandard Security Setup وSecuring Jenkins.

إنشاء مشروع Jenkins

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

لإنشاء مشروع Jenkins، اتّبِع الخطوات التالية:

  1. انتقِل إلى لوحة بيانات Jenkins على الخادم. لإجراء ذلك، انتقِل إلى http://<اسم الخادم>:8080، حيث يمثّل <اسم الخادم> اسم جهاز الكمبيوتر الذي ثبّت عليه Jenkins.
  2. في لوحة بيانات Jenkins، انقر على New Item.
  3. اكتب اسمًا لمشروعك في حقل اسم العنصر:
    • اختَر مشروع بدون قيود لإنشاء مشروع يستخدم إعدادًا واحدًا للإنشاء.
    • اختَر إنشاء مشروع بإعدادات متعددة لإنشاء مشروع يعمل على إعدادات مختلفة متعددة. إذا كنت تخطّط لإنشاء تطبيقك باستخدام مجموعة متنوعة من إعدادات الإنشاء (لغات متعددة، ومستويات متعددة لواجهة برمجة التطبيقات 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> هو مجلد مشروع &quot;استوديو Android&quot; لتطبيقك: 

    <AppFolder>/app/build/outputs/apk

إضافة Test Lab خطوات إنشاء إلى Jenkins

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

لإضافة خطوة إنشاء gcloud، اتّبِع الخطوات التالية:

  1. من الصفحة الرئيسية لمشروعك، انقر على ضبط.

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

  3. في نافذة Jenkins Execute shell command، أدخِل ما يلي، مع استبدال <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 Test Lab.

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

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