Google is committed to advancing racial equity for Black communities. See how.
ترجمت واجهة Cloud Translation API‏ هذه الصفحة.
Switch to English

ابدأ باستخدام Firebase Test Lab من سطر أوامر gcloud

يتيح لك Firebase Test Lab اختبار تطبيق iOS الخاص بك على أجهزة متعددة من خلال واجهة سطر أوامر gcloud . استمر في القراءة لمعرفة كيفية البدء.

أنشئ مشروع Firebase

إذا لم يكن لديك مشروع Firebase لتطبيقك ، فانتقل إلى وحدة تحكم Firebase وانقر على إنشاء مشروع جديد لإنشاء مشروع الآن. ستحتاج إلى ملكية أو تعديل الأذونات في مشروعك.

يمكنك استخدام Test Lab لعدد محدود من عمليات تنفيذ الاختبار اليومية على خطة Spark. لاستخدام Test Lab بدون حدود الحصة اليومية ، يجب عليك الترقية إلى خطة Firebase Blaze.

تكوين بيئة Google Cloud SDK المحلية الخاصة بك

  1. قم بتنزيل Google Cloud SDK.
  2. يتضمن ذلك أداة gcloud CLI.

  3. تأكد من التثبيت هو ما يصل إلى تاريخ ويتضمن gcloud firebase الأوامر:
          gcloud components update
  4. قم بتسجيل الدخول إلى gcloud CLI باستخدام حساب Google الخاص بك:
          gcloud auth login
  5. عيِّن مشروع Firebase في gcloud ، حيث يمثل PROJECT_ID معرّف مشروع Firebase:
         gcloud config set project PROJECT_ID

بناء XCTests لتطبيقك

لإنشاء الاختبار الخاص بك ، استخدم الأمر التالي في الجهاز:

مشروع

xcodebuild -project PATH/TO/YOUR_WORKSPACE.xcodeproj \
  -scheme YOUR_SCHEME \
  -derivedDataPath FOLDER_WITH_TEST_OUTPUT \
  -sdk iphoneos build-for-testing

مساحة العمل

xcodebuild -workspace PATH/TO/YOUR_WORKSPACE.xcworkspace \
  -scheme YOUR_SCHEME \
  -derivedDataPath FOLDER_WITH_TEST_OUTPUT \
  -sdk iphoneos build-for-testing

بعد بناء الاختبار بنجاح ، قم بضغطه للتحميل إلى Test Lab:

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

قم بإجراء الاختبارات الخاصة بك

اختر أبعاد الاختبار الخاصة بك

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

gcloud firebase test ios dimension list

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

ابحث في قائمة أبعاد الاختبار ، وحدد بعض المجموعات التي ترغب في تشغيل اختبارك عليها. إذا كنت تستخدم خطة Spark ، فيمكنك تشغيل ما يصل إلى 5 مجموعات يوميًا. إذا كنت تستخدم خطة Blaze ، فيمكنك إجراء اختبارات على مجموعات عدد غير محدودة يوميًا ، ولكن يمكنك فقط تضمين ما يصل إلى 200 مجموعة في كل تشغيل. لمزيد من المعلومات حول حدود الاختبار والأسعار ، راجع خطط التسعير .

قم بإجراء الاختبارات

بمجرد اختيار مجموعة من أبعاد الاختبار ، يمكنك جعل مختبر الاختبار يجري اختباراتك باستخدام أمر 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=11.3

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

عند الانتهاء من الاختبار ، تطبع أداة gcloud ملخصًا أساسيًا لنتائج الاختبار. كجزء من الملخص ، تتضمن الأداة رابطًا لعرض نتائج أكثر تفصيلاً في وحدة تحكم Firebase. لمعرفة المزيد حول كيفية تفسير هذه النتائج ، راجع تحليل نتائج اختبار Firebase .

أتمتة الاختبارات المستقبلية

برمجة أوامر gcloud باستخدام Test Lab

يمكنك استخدام البرامج النصية لـ shell أو ملفات الدُفعات لأتمتة أوامر اختبار تطبيقات الأجهزة المحمولة التي يمكنك تشغيلها باستخدام سطر أوامر gcloud. يشغّل نموذج bash النصي هذا اختبار 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 العديد من رموز الخروج التي يمكنك استخدامها لفهم نتائج الاختبارات التي تجريها باستخدام البرامج النصية أو الملفات الدفعية بشكل أفضل.

برمجة رموز الخروج الخاصة بـ Test Lab

كود الخروج ملاحظات
0 اجتازت جميع عمليات تنفيذ الاختبار.
1 حدث فشل عام. تشمل الأسباب المحتملة: اسم ملف غير موجود أو خطأ HTTP / شبكة.
2 تم الخروج من الاختبار لأنه تم توفير أوامر أو وسيطات غير معروفة.
10 لم تنجح حالة اختبار واحدة أو أكثر (الفئات المختبرة أو طرق الفصل) في تنفيذ الاختبار.
15 لم يتمكن Firebase Test Lab من تحديد ما إذا كانت مصفوفة الاختبار قد نجحت أو فشلت ، بسبب خطأ غير متوقع.
19 تم إلغاء مصفوفة الاختبار من قبل المستخدم.
20 حدث خطأ في اختبار البنية التحتية.

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

اقرأ وثائق Google Cloud SDK لاستكشاف خيارات الاختبار المتاحة عمومًا أو التجريبية .