Catch up on everything announced at Firebase Summit, and learn how Firebase can help you accelerate app development and run your app with confidence. Learn More

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

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

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

استخدام مختبر اختبار Firebase مع 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 Console ثم قم بتنشيطه (راجع توثيق حساب خدمة المصادقة gcloud لتعلم كيفية القيام بذلك).

  3. تفعيل واجهات برمجة التطبيقات المطلوبة. بعد تسجيل الدخول باستخدام حساب الخدمة: في صفحة مكتبة Google Developers Console API ، قم بتمكين 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: // <servername>: 8080 ، حيث <servername> هو اسم الكمبيوتر الذي قمت بتثبيت Jenkins عليه.
  2. في لوحة معلومات Jenkins ، انقر فوق Manage Jenkins ، ثم انقر فوق Configure Global Security .
  3. في صفحة تكوين الأمان العام ، انقر فوق تمكين الأمان ، ثم انقر فوق حفظ .

لمزيد من المعلومات حول تكوين إعدادات الأمان لـ Jenkins ، راجع الأمان السريع والبسيط ، وإعداد الأمان القياسي ، وتأمين 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
    

أضف معمل الاختبار إلى خطوات إنشاء Jenkins

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

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

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

  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 الأخرى ، تحقق من مستنداتها: