الاختبار باستخدام واجهة سطر الأوامر في Google Cloud

يوضّح هذا الدليل كيفية إجراء اختبار XCTest أو اختبار حلقة اللعبة باستخدام gcloud CLI.

الخطوة 1: إعداد بيئة Google Cloud SDK المحلية

1. تنزيل Google Cloud SDK

يتضمّن ذلك أداة gcloud CLI.

2. تأكَّد من أنّ عملية التثبيت حديثة وتتضمّن الأمر gcloud firebase

         gcloud components update

3. سجِّل الدخول إلى gcloud CLI باستخدام حسابك على Google:

         gcloud auth login

4. اضبط مشروعك على Firebase في gcloud، حيث PROJECT_ID هو رقم تعريف مشروعك على Firebase:

        gcloud config set project PROJECT_ID

الخطوة 2: إجراء الاختبار

إجراء اختبار XCTest

1. حمِّل ملف ‎ .zip الخاص باختبارك عن طريق تنفيذ الأمر التالي (إذا لم تكن قد جهّزت حزمة تطبيقك بعد، اطّلِع على مقالة تجهيز حزمة XCTest):

   cd FOLDER_WITH_TEST_OUTPUT/Build/Products ; \
   zip -r MyTests.zip Debug-iphoneos YOUR_SCHEME_iphoneosDEPLOYMENT_TARGET-arm64.xctestrun

2. اختَر أبعاد الاختبار.

   تتيح لك خدمة Test Lab إجراء الاختبارات على مجموعة متنوّعة من إصدارات iOS والأجهزة واتجاهات الشاشة والمناطق الجغرافية. تُعرف هذه الإعدادات باسم أبعاد الاختبار. للاطّلاع على خيارات كل بُعد (مثل إصدارات Xcode المتوافقة مع إصدار iOS الخاص بالجهاز)، استبدِل dimension بـ models أو versions أو locales في الأمر التالي:

   gcloud firebase test ios dimension list

   يكون اتجاه الشاشة أبسط إلى حد ما، لأنّ خياراته الوحيدة هي portrait و landscape.

   تصفَّح قائمة أبعاد الاختبار، واختَر بعض التركيبات التي تريد إجراء الاختبار عليها. انتقِل إلى خطط الأسعار للاطّلاع على الحد الأقصى لعدد التركيبات التي يمكنك إجراءها في اليوم الواحد.

3. بعد اختيار مجموعة من أبعاد الاختبار، يمكنك أن تطلب من Test Lab إجراء اختباراتك باستخدام الأمر firebase test ios run لكل تركيبة من أبعاد الاختبار تريد إجراء الاختبار عليها، أضِف علامة --device منفصلة:

   gcloud firebase test ios run --test PATH/TO/MyTests.zip \
    --device model=MODEL_ID_1,version=VERSION_ID_1,locale=LOCALE_1,orientation=ORIENTATION_1 \
    --device model=MODEL_ID_2,version=VERSION_ID_2,locale=LOCALE_2,orientation=ORIENTATION_2 \
    etc...

   من المحتمل أن يتعذّر إجراء الاختبار بسبب عدم التوافق بين إصدار Xcode الذي تم إنشاء الاختبار به وإصدار Xcode التلقائي الذي تستخدمه Test Lab. لتحديد إصدار Xcode متوافق مع اختبارك، استخدِم العلامة --xcode-version:

   gcloud firebase test ios run --test PATH/TO/MyTests.zip \
    --device model=MODEL_ID_1,version=VERSION_ID_1,locale=LOCALE_1,orientation=ORIENTATION_1 \
    --xcode-version=15

   لمساعدتك في تحديد مصفوفات الاختبار وتحديد موقعها في الـ Firebase Console، يمكنك اختياريًا تصنيف مصفوفة الاختبار باستخدام العلامة --client-details matrixLabel="<label>" في المثال التالي:

   gcloud beta firebase test ios run --test PATH/TO/MyTests.zip \
     --device model=MODEL_ID_1,version=VERSION_ID_1,locale=LOCALE_1,orientation=ORIENTATION_1 \
     --client-details matrixLabel="my label"

إجراء اختبار حلقة اللعبة

نفِّذ الأمر gcloud beta firebase test ios run واستخدِم العلامات التالية لضبط عملية التشغيل:

على سبيل المثال، يُجري الأمر التالي اختبار حلقة اللعبة الذي ينفّذ الحلقات 1 و4 و6 و7 و8 على iPhone 8 Plus:

gcloud beta firebase test ios run
 --type game-loop --app path/to/my/App.ipa --scenario-numbers 1,4,6-8
 --device-model=iphone8plus

لمزيد من المعلومات عن gcloud CLI، اطّلِع على المستندات المرجعية.

الخطوة 3 (اختيارية): أتمتة الاختبارات المستقبلية التي تنشئها

كتابة النصوص البرمجية لأوامر gcloud باستخدام Test Lab

يمكنك استخدام النصوص البرمجية للواجهة أو ملفات الدُفعات لأتمتة أوامر اختبار تطبيقات الأجهزة الجوّالة التي كنت ستنفّذها بخلاف ذلك باستخدام سطر أوامر gcloud. يُجري هذا النص البرمجي النموذجي للواجهة اختبار XCTest بمهلة دقيقتَين، ويُبلغ ما إذا اكتملت عملية إجراء الاختبار بنجاح:

if gcloud firebase test ios run --test MyTest.zip --timeout 2m
then
    echo "Test matrix successfully finished"
else
    echo "Test matrix exited abnormally with non-zero exit code: " $?
fi

رموز الخروج من النص البرمجي

Test Lab توفّر عدة رموز خروج يمكنك استخدامها لفهم نتائج الاختبارات التي تجريها باستخدام النصوص البرمجية أو ملفات الدُفعات بشكل أفضل.

الخطوة 4: التحقيق في نتائج الاختبار

عند بدء الاختبار، ستتلقّى رابطًا يؤدي إلى صفحة نتائج الاختبار. قد يستغرق إجراء الاختبارات عددًا من الدقائق، وذلك استنادًا إلى عدد الإعدادات المختلفة التي اخترتها ومدة المهلة التي ضبطتها للاختبارات. بعد إجراء الاختبارات، يمكنك مراجعة النتائج. اطّلِع على مقالة تحليل النتائج لمزيد من المعلومات عن كيفية تفسير نتائج الاختبار.Firebase Test Lab

الخطوة التالية

اطّلِع على مستندات Google Cloud SDK لاستكشاف خيارات الاختبار المتاحة بشكل عام أو في الإصدار التجريبي.