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