تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
توفّر Firebase Test Lab بنية تحتية مستندة إلى السحابة الإلكترونية لاختبار تطبيقات Android. يوضّح هذا المستند كيفية بدء استخدام Test Lab من خلال وحدة تحكّم Firebase.
تتيح لك أداة Test Lab إجراء الأنواع التالية من الاختبارات:
إذا لم يسبق لك ذلك، انتقِل إلى Firebase وحدة التحكّم
وأنشئ مشروعًا جديدًا على Firebase.
الخطوة 2: إجراء اختبار
اختبار قياس حالة التطبيق
في شريط التنقّل الخاص بوحدة تحكّم Firebase، انقر على Test Lab، ثم انقر على البدء -> تشغيل اختبار Instrumentation.
انقر على تصفّح، ثم ابحث عن حِزمة APK أو AAB الخاصة بتطبيقك وحِزمة APK أو AAB الخاصة بالاختبار قبل النقر على متابعة.
حدِّد مصفوفة الاختبار من خلال اختيار الأجهزة ومستويات واجهة برمجة التطبيقات على Android واتجاهات الشاشة واللغات التي تريد اختبار تطبيقك عليها. يمكنك اختيار مجموعات الأجهزة ومستويات واجهة برمجة التطبيقات Android التي تريد استهدافها للاختبار فقط.
(اختياري) انقر على عرض الخيارات المتقدّمة لتغيير مهلة الاختبار التي تحدّد المدة القصوى لكل عملية تنفيذ اختبار.
(اختياري) لمساعدتك في تحديد مواقع مصفوفات الاختبار والعثور عليها في
وحدة تحكّم Firebase، يمكنك إضافة تصنيف إلى مصفوفة الاختبار من خلال إدخال اسم تصنيف في حقل تصنيف مصفوفة الاختبار (اختياري).
انقر على بدء N اختبارات، حيث يمثّل "N" عدد إعدادات الاختبار الصالحة من مصفوفة الاختبار التي تحدّدها في هذه الشاشة. يظهر رمز ساعة زرقاء بجانب كل اختبار في انتظار المراجعة أثناء انتظار تنفيذه، ويتغيّر هذا الرمز إلى رمز علامة اختيار خضراء عند اكتمال الاختبار.
بعد إجراء كل اختبار، انقر على الجهاز المُدرَج في عمود "تنفيذ الاختبار" للاطّلاع على نتائج الاختبار، بما في ذلك حالات الاختبار والسجلات ولقطات الشاشة والفيديوهات.
اختبار Robo
في شريط التنقّل في وحدة تحكّم Firebase، انقر على Test Lab، ثم انقر على البدء -> تشغيل اختبار Robo.
انقر على تصفّح، ثم تصفَّح ملف APK الخاص بتطبيقك، ثم انقر على متابعة.
حدِّد مصفوفة الاختبار من خلال اختيار الأجهزة ومستويات واجهة برمجة التطبيقات على Android واتجاهات الشاشة واللغات التي تريد اختبار تطبيقك عليها.
(اختياري) انقر على عرض الخيارات المتقدّمة لتغيير الخيارات التالية:
يحدّد مهلة الاختبار الحد الأقصى لمدة تنفيذ كل اختبار.
تُستخدَم بيانات اعتماد الحساب التجريبي لتوفير بيانات اعتماد لحساب تجريبي.
تُستخدَم الحقول الإضافية لتوفير إدخال نصي لحقول نصية أخرى في تطبيقك.
(اختياري) لمساعدتك في تحديد مواقع مصفوفات الاختبار والعثور عليها في
Firebase وحدة التحكّم، يمكنك إضافة تصنيف إلى مصفوفة الاختبار من خلال إدخال
اسم التصنيف في حقل تصنيف مصفوفة الاختبار (اختياري).
انقر على بدء N اختبارات، حيث يمثّل "N" عدد إعدادات الاختبار الصالحة من مصفوفة الاختبار التي تحدّدها في هذه الشاشة. يظهر رمز ساعة زرقاء بجانب كل اختبار معلّق أثناء انتظار تنفيذه، ويتغيّر هذا الرمز إلى علامة اختيار خضراء عند اكتمال الاختبار.
بعد انتهاء كل اختبار، انقر على الجهاز المُدرَج في عمود "تنفيذ الاختبار" للاطّلاع على نتائج الاختبار، بما في ذلك حالات الاختبار والسجلات ولقطات الشاشة والفيديوهات.
في صفحة Test Lab ضمن وحدة تحكّم Firebase، انقر على إجراء اختبارك الأول > تنفيذ حلقة لعبة Android.
في قسم تحميل التطبيق، انقر على استعراض، ثم اختَر ملف APK الخاص بتطبيقك (إذا لم يسبق لك ذلك، أنشئ ملف APK لتطبيقك).
(اختياري) لمساعدتك في تحديد مواقع مصفوفات الاختبار والعثور عليها في
Firebase وحدة التحكّم، يمكنك إضافة تصنيف إلى مصفوفة الاختبار من خلال إدخال
اسم التصنيف في حقل تصنيف مصفوفة الاختبار (اختياري).
(اختياري) إذا أردت تشغيل عدة عمليات تكرار أو سيناريوهات في الوقت نفسه، أو اختيار عمليات تكرار معيّنة لتشغيلها، أدخِل أرقام عمليات التكرار في حقل السيناريوهات.
على سبيل المثال، عند إدخال "1-3, 5"، سيتم تشغيل الحلقات 1 و2 و3 و5.Test Lab
تلقائيًا (إذا لم تُدخل أي شيء في الحقل السيناريوهات)،
لا يتم تنفيذ سوى الحلقة 1 في Test Lab.
في قسم الأجهزة، اختَر جهازًا واحدًا أو أكثر من الأجهزة الفعلية التي تريد اختبار تطبيقك عليها، ثم انقر على بدء الاختبارات.
الخطوة 3: التحقيق في نتائج الاختبار
عند بدء الاختبار، ستتم إعادة توجيهك تلقائيًا إلى صفحة نتائج الاختبار.
قد تستغرق الاختبارات عدة دقائق لتنفيذها، وذلك حسب عدد الإعدادات المختلفة التي اخترتها ومدة المهلة المحدّدة لاختباراتك. بعد إجراء الاختبارات، يمكنك مراجعة نتائجها. اطّلِع على مقالة
تحليل نتائج Firebase Test Lab لمعرفة المزيد
عن كيفية تفسير نتائج الاختبار.
تاريخ التعديل الأخير: 2025-08-29 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-29 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["\u003cbr /\u003e\n\nFirebase Test Lab provides cloud-based infrastructure for testing\nAndroid apps. This document describes how to get started with Test Lab using the\nFirebase console.\n\nTest Lab lets you run the following types of tests:\n\n- [Instrumentation test](/docs/test-lab/android/instrumentation-test):\n A test you write that allows you to drive the UI of your app with the actions\n you specify. An instrumentation test can also make explicit assertions about\n the state of your app to verify correct functionality using\n [AndroidJUnitRunnerAPIs](https://developer.android.com/reference/android/support/test/runner/AndroidJUnitRunner). Test Lab supports\n [Espresso](https://developer.android.com/training/testing/espresso)\n and\n [UI Automator](https://developer.android.com/training/testing/other-components/ui-automator) instrumentation test frameworks.\n\n- [Robo test](/docs/test-lab/android/robo-ux-test):\n A test that analyzes your app's interface and then explores it automatically\n by simulating user activities.\n\n- [Game loop test](/docs/test-lab/android/game-loop): A test\n that uses a \"demo mode\" to simulate player actions in game apps.\n\nBefore you begin\n\nYour Firebase project must be on the [pay-as-you-go Blaze pricing plan](/pricing), which means that\nyour project is linked to a Cloud Billing account. You can\n[upgrade to the Blaze pricing plan](//console.firebase.google.com/project/_/overview?purchaseBillingPlan=metered)\nin the Firebase console. You need to be an Owner or Editor for your project\nto link a Cloud Billing account.\n\nStep 1. Create a Firebase project\n\nIf you haven't yet, go to the [Firebase console](https://console.firebase.google.com/)\nand create a new Firebase project.\n| **Note:** If you're working on a shared Firebase project, you'll need to have ownership or edit permissions for the project.\n\nStep 2. Run a test \n\nInstrumentation test**Note:** If you want to run an instrumentation test with [Android Test Orchestrator](https://developer.android.com/training/testing/junit-runner.html#using-android-test-orchestrator), see [Enable Orchestrator](/docs/test-lab/android/instrumentation-test#orchestrator).\n\n1. On the [Firebase console](https://g.co/firebase) navigation bar,\n click **Test Lab** , and then click **Get Started -\\\u003e Run an Instrumentation\n test**.\n\n2. Click **Browse** , and then browse to your app APK or AAB and test APK or\n AAB before clicking **Continue**.\n\n3. Define your test matrix by selecting which devices, Android API levels,\n screen orientations and locales you want to test your app against. You can\n select only those device and Android API level combinations that you want\n to target for testing.\n\n4. (Optional) Click **Show advanced options** to change the Test timeout\n that determines the maximum duration of each test execution.\n\n5. (Optional) To help you identify and locate your test matrices in the\n Firebase console, you can add a label to your test matrix by entering a\n label name in the **Test matrix label (optional)** field.\n\n6. Click **Start *N* Tests**, where \"N\" is the number of valid test\n configurations from the test matrix that you define on this screen. Each\n pending test is shown with a blue clock icon while it is waiting to run,\n and that icon changes to a green check icon when the test has completed.\n\n7. After each test has run, click the device listed in the Test Execution\n column to see test results, including test cases, logs, screenshots and\n videos.\n\nRobo test\n\n1. On the [Firebase console](https://g.co/firebase) navigation bar,\n click **Test Lab** , and then click **Get Started -\\\u003e Run a Robo test**.\n\n2. Click **Browse** , browse to your app APK, and then click **Continue**.\n\n3. Define your test matrix by selecting which devices, Android API levels,\n screen orientations and locales you want to test your app against.\n\n4. (Optional) Click **Show advanced options** to change the following options:\n\n - Test timeout determines the maximum duration of each test execution.\n - Test account credentials are usedis used to provide credentials for a test account.\n\n | **Caution:** Never use this option with real user accounts.\n - Additional fields are used to provide text input for other text fields in your app.\n\n | **Note:** To learn more about Test account credentials and additional fields, see [Test account sign-in and predefined text](/docs/test-lab/robo-ux-test#test_account_sign-in_and_predefined_text_input).\n5. (Optional) To help you identify and locate your test matrices in the\n Firebase console, you can add a label to your test matrix by entering\n a label name in the **Test matrix label (optional)** field.\n\n6. Click **Start *N* Tests**, where \"N\" is the number of valid test\n configurations from the test matrix that you define on this screen. Each\n pending test is shown with a blue clock icon while it is waiting to run,\n and that icon changes to a green check when the test has completed.\n\n7. After each test finishes running, click the device listed in the Test\n Execution column to see test results, including test cases, logs,\n screenshots and videos.\n\nIf you want to create a script to guide the Robo test, see\n[Record a Robo script using Test Lab in Android Studio](/docs/test-lab/android/run-robo-scripts#record-android-studio).\n\nGame Loop test\n\n1. On the Test Lab page of the [Firebase console](https://console.firebase.google.com/project/_/%0Atestlab), click **Run Your First Test \\\u003e Run an Android Game Loop**.\n\n2. In the **Upload App** section, click **Browse** , then select your app's\n APK file (if you haven't already, [generate an APK file](https://firebase.google.com/docs/test-lab/android/game-loop#run-testlab) for your app).\n\n3. (Optional) To help you identify and locate your test matrices in the\n Firebase console, you can add a label to your test matrix by entering\n a label name in the **Test matrix label (optional)** field.\n\n4. (Optional) If you want to run multiple loops or scenarios at a time, or\n select specific loops to run, enter the loop numbers in the\n **Scenarios** field.\n\n For example, when you enter \"1-3, 5\", Test Lab runs loops 1, 2, 3, and 5.\n By default (if you don't enter anything in the **Scenarios** field),\n Test Lab only runs loop 1.\n5. In the **Devices** section, select one or more physical devices you\n want to test your app on, then click **Start Tests**.\n\nStep 3. Investigate your test results\n\nWhen the test starts, you're automatically redirected to the test results page.\nTests can take a number of minutes to run, depending on the number of different\nconfigurations you have selected and the test timeout duration set for your\ntests. After your tests have run, you can review test results. See\n[Analyzing Firebase Test Lab Results](/docs/test-lab/android/analyzing-results) to learn more\nabout how to interpret the test results.\n| **Note:** For all test types, any uncaught exception will cause a test failure."]]
