يمكنك استخدام Firebase Test Lab عند تطوير تطبيقك باستخدام أي نظام تكامل مستمر (CI). تتيح لك أنظمة التكامل المستمر إنشاء واختبار تطبيقك تلقائيًا في كل مرة تقوم فيها بتسجيل تحديثات لشفرة مصدر التطبيق.
استخدام مختبر اختبار Firebase مع Jenkins CI
يصف هذا القسم كيفية استخدام Test Lab مع Jenkins CI .
متطلبات
قبل أن تتمكن من استخدام Firebase Test Lab مع Jenkins ، عليك إكمال الخطوات التالية:
قم بإعداد gcloud. اتبع التعليمات من استخدام Firebase Test Lab من سطر أوامر gcloud لإنشاء مشروع Firebase وتهيئة بيئة Google Cloud SDK المحلية.
إنشاء حساب الخدمة وتفويضه. لا تخضع حسابات الخدمة لفحوصات البريد العشوائي أو مطالبات captcha ، والتي قد تمنع إنشاءات CI الخاصة بك. قم بإنشاء حساب خدمة مع دور محرر في Google Cloud Console ثم قم بتنشيطه (راجع توثيق حساب خدمة المصادقة gcloud لتعلم كيفية القيام بذلك).
تفعيل واجهات برمجة التطبيقات المطلوبة. بعد تسجيل الدخول باستخدام حساب الخدمة: في صفحة مكتبة 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 ، قم بتكوين إعدادات الأمان العامة لفرض التحكم في الوصول والمصادقة على المستخدمين.
لتكوين إعدادات الأمان العالمية
- انتقل إلى لوحة معلومات Jenkins على الخادم الخاص بك. للقيام بذلك ، انتقل إلى http: // <servername>: 8080 ، حيث <servername> هو اسم الكمبيوتر الذي قمت بتثبيت Jenkins عليه.
- في لوحة معلومات Jenkins ، انقر فوق Manage Jenkins ، ثم انقر فوق Configure Global Security .
- في صفحة تكوين الأمان العام ، انقر فوق تمكين الأمان ، ثم انقر فوق حفظ .
لمزيد من المعلومات حول تكوين إعدادات الأمان لـ Jenkins ، راجع الأمان السريع والبسيط ، وإعداد الأمان القياسي ، وتأمين Jenkins .
قم بإنشاء مشروع Jenkins
بعد ذلك ، أنشئ مشروعًا لإجراء اختبار تكامل مستمر لتطبيقك باستخدام Firebase Test Lab.
لإنشاء مشروع جنكينز
- انتقل إلى لوحة معلومات Jenkins على الخادم الخاص بك. للقيام بذلك ، انتقل إلى http: // <servername>: 8080 ، حيث <servername> هو اسم الكمبيوتر الذي قمت بتثبيت Jenkins عليه.
- في لوحة معلومات Jenkins ، انقر فوق عنصر جديد .
- اكتب اسمًا لمشروعك في حقل اسم العنصر :
- اختر مشروع Freestyle لإنشاء مشروع يستخدم تكوين بناء واحد.
- اختر إنشاء مشروع متعدد التكوين لإنشاء مشروع يعمل على عدة تكوينات بناء مختلفة. إذا كنت تخطط لإنشاء تطبيقك باستخدام مجموعة متنوعة من تكوينات الإنشاء (لغات متعددة ، ومستويات متعددة لواجهة برمجة تطبيقات Android ، وما إلى ذلك) ، فإن المشروع متعدد التكوينات هو الخيار الأفضل.
- انقر فوق حفظ .
بعد إنشاء مشروعك ، يعرض مستعرض الويب الخاص بك الصفحة الرئيسية لمشروعك.
إضافة التحكم في المراجعة وخطوات بناء Gradle
يصف هذا القسم كيفية دمج Jenkins مع أنظمة التحكم في المراجعة مثل GitHub ، وكيفية إضافة خطوات إنشاء Gradle لإنشاء حزم APK من التعليمات البرمجية المصدر.
التكامل مع GitHub وأنظمة التحكم في المراجعة الأخرى
إذا كنت تستخدم GitHub أو أي نظام آخر للتحكم في المراجعة لإدارة الكود المصدري لتطبيقك ، فيمكنك تكوين Jenkins لتشغيل الإنشاءات الآلية وتشغيل الاختبارات في كل مرة يتم فيها تسجيل تحديثات لتطبيقك. يمكنك أيضًا تكوين Jenkins لتشغيل الإصدارات بشكل دوري.
للتعرف على تكوين البنيات في Jenkins ، راجع تكوين البنيات التلقائية .
إضافة خطوات بناء Gradle لإعادة إنشاء حزم APK
إذا كنت تستخدم نظام تحكم في المراجعة لإدارة التعليمات البرمجية المصدر لتطبيقك ، فستحتاج إلى تضمين خطوة بناء Gradle لإنشاء ثنائيات APK جديدة في كل مرة يقوم فيها Jenkins بتنزيل كود المصدر من نظام التحكم في المراجعة الخاص بك.
أضف خطوة إنشاء لتشغيل الأوامر التالية في الدليل الرئيسي للتطبيق الخاص بك:
./gradlew :app:assembleDebug ./gradlew :app:assembleDebugAndroidTest
أضف خطوة إنشاء لاستخدام حزمة (حزم) APK التي أنشأها Gradle عند الاختبار باستخدام Test Lab. يمكنك استخدام هذا المسار باعتباره <local_server_path> في مثال البرنامج النصي shell الموضح أدناه ، حيث يمثل <AppFolder> مجلد مشروع Android Studio لتطبيقك:
<AppFolder>/app/build/outputs/apk
أضف معمل الاختبار إلى خطوات إنشاء Jenkins
أنت الآن جاهز لإضافة خطوة إنشاء إلى Jenkins لتشغيل Test Lab باستخدام سطر أوامر gcloud.
لإضافة خطوة بناء gcloud
- من الصفحة الرئيسية لمشروعك ، انقر فوق تكوين .
في صفحة تكوين المشروع ، قم بالتمرير لأسفل إلى قسم الإنشاء ، ثم اختر تنفيذ shell من قائمة إضافة خطوة بناء .
في نافذة أوامر 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 الأخرى ، تحقق من مستنداتها: