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

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

استخدام مختبر اختبار Firebase مع Jenkins CI

يصف هذا القسم كيفية استخدام اختبار مختبر مع جنكينز CI .

متطلبات

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

  1. قم بإعداد gcloud. اتبع الإرشادات من طريق Firebase مختبر فحص من gcloud سطر الأوامر لإنشاء مشروع Firebase وتكوين بيئة جوجل الغيمة SDK المحلية.

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

  3. تفعيل واجهات برمجة التطبيقات المطلوبة. بعد تسجيل الدخول باستخدام حساب خدمة: في الصفحة المطورون وحدة التحكم مكتبة جوجل API ، تمكين API جوجل الغيمة اختبار وأداة السحب النتائج API. لتمكين هذه واجهات برمجة التطبيقات، اكتب أسماء API هذه في مربع البحث في الجزء العلوي من وحدة التحكم، ثم انقر فوق تمكين API على صفحة نظرة عامة لهذا API.

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

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

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

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

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

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

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

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

قم بإنشاء مشروع Jenkins

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

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

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

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

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

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

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

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

لمعرفة المزيد عن تكوين يبني في جنكينز، انظر يبني تكوين تلقائي .

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

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

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

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

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

    <AppFolder>/app/build/outputs/apk
    

إضافة مختبر اختبار بناء خطوات لجنكينز

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

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

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

  3. في جنكينز تنفيذ إطار الأوامر قذيفة، أدخل ما يلي، استبدال <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
    

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

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

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

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