Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Firebase Test Lab menyediakan infrastruktur berbasis cloud untuk menguji
aplikasi Android. Dokumen ini menjelaskan cara memulai Test Lab menggunakan Firebase console.
Test Lab memungkinkan Anda menjalankan jenis pengujian berikut:
Uji instrumentasi:
Pengujian yang Anda tulis dan dapat digunakan untuk mendorong UI aplikasi dengan tindakan
yang Anda tentukan. Uji instrumentasi juga dapat membuat pernyataan eksplisit tentang
status aplikasi Anda untuk memverifikasi fungsionalitas yang benar menggunakan
AndroidJUnitRunnerAPIs. Test Lab mendukung
framework uji instrumentasi
Espresso
dan UI Automator.
Uji Robo:
Pengujian yang menganalisis antarmuka aplikasi, lalu otomatis menjelajahinya dengan
menyimulasikan aktivitas pengguna.
Uji game loop: Pengujian yang menggunakan "mode demo" untuk menyimulasikan tindakan pemain dalam aplikasi game.
Sebelum memulai
Project Firebase Anda harus menggunakan paket harga Blaze bayar sesuai penggunaan, yang berarti bahwa project Anda ditautkan ke akun Cloud Billing. Anda dapat
mengupgrade ke paket harga Blaze
di Firebase console. Anda harus menjadi Pemilik atau Editor untuk project Anda
agar dapat menautkan akun Cloud Billing.
Langkah 1. Membuat project Firebase
Jika Anda belum melakukannya, buka Firebase console
dan buat project Firebase baru.
Langkah 2. Jalankan pengujian
Uji instrumentasi
Di menu navigasi Firebase console,
klik Test Lab, lalu klik Get Started -> Run an Instrumentation
test.
Klik Browse, lalu cari APK atau AAB aplikasi Anda, dan uji APK atau
AAB sebelum mengklik Continue.
Tentukan matriks uji dengan memilih perangkat, tingkat API Android, orientasi layar, dan lokal yang ingin Anda uji dalam aplikasi. Anda hanya dapat memilih kombinasi perangkat dan API level Android yang ingin ditargetkan untuk pengujian.
(Opsional) Klik Tampilkan opsi lanjutan untuk mengubah Waktu tunggu uji
yang menentukan durasi maksimum setiap eksekusi uji.
(Opsional) Untuk membantu mengidentifikasi dan menemukan matriks uji di
Firebase console, Anda dapat menambahkan label ke matriks uji dengan memasukkan
nama label di kolom Test matrix label (optional).
Klik Start N Test, dengan "N" adalah jumlah konfigurasi pengujian
yang valid dari matriks uji yang Anda tentukan di layar ini. Setiap pengujian yang ditangguhkan akan ditampilkan dengan ikon jam warna biru saat menunggu untuk dijalankan, dan ikon tersebut akan berubah menjadi ikon centang warna hijau ketika pengujian telah selesai.
Setelah setiap pengujian dijalankan, klik perangkat yang tercantum di kolom Eksekusi Uji untuk melihat hasil pengujian, termasuk kasus, log, cuplikan, dan video pengujian.
Uji Robo
Di menu navigasi Firebase console,
klik Test Lab, lalu klik Get Started -> Run a Robo test.
Klik Browse, jelajahi ke APK aplikasi, lalu klik Continue.
Tentukan matriks uji dengan memilih perangkat, tingkat API Android, orientasi layar, dan lokal yang ingin Anda uji dalam aplikasi.
(Opsional) Klik Tampilkan opsi lanjutan untuk mengubah opsi berikut:
Waktu tunggu uji menentukan durasi maksimum setiap eksekusi uji.
Kredensial akun pengujian digunakan untuk memberikan kredensial bagi akun pengujian.
Kolom tambahan digunakan untuk memberikan input teks bagi kolom teks lain
di aplikasi Anda.
(Opsional) Untuk membantu mengidentifikasi dan menemukan matriks uji di
Firebase console, Anda dapat menambahkan label ke matriks uji dengan memasukkan
nama label di kolom Test matrix label (optional).
Klik Start N Test, dengan "N" adalah jumlah konfigurasi pengujian
yang valid dari matriks uji yang Anda tentukan di layar ini. Setiap pengujian yang ditangguhkan akan ditampilkan dengan ikon jam warna biru saat menunggu untuk dijalankan, dan ikon tersebut akan berubah menjadi centang warna hijau ketika pengujian telah selesai.
Setelah setiap pengujian selesai dijalankan, klik perangkat yang tercantum di kolom
Eksekusi Uji untuk melihat hasil pengujian, termasuk kasus, log,
screenshot, dan video pengujian.
Di halaman Test Lab pada Firebase console, klik Run Your First Test > Run an Android Game Loop.
Di bagian Upload App, klik Browse, lalu pilih file APK
di aplikasi (jika belum melakukannya, buat file APK untuk aplikasi).
(Opsional) Untuk membantu mengidentifikasi dan menemukan matriks uji di
Firebase console, Anda dapat menambahkan label ke matriks uji dengan memasukkan
nama label di kolom Test matrix label (optional).
(Opsional) Jika Anda ingin menjalankan beberapa loop atau skenario sekaligus, atau
memilih loop tertentu untuk dijalankan, masukkan nomor loop di
kolom Scenarios.
Misalnya, saat Anda memasukkan "1-3, 5", Test Lab akan menjalankan loop 1, 2, 3, dan 5.
Secara default (jika Anda tidak memasukkan apa pun di kolom Scenarios),
Test Lab hanya menjalankan loop 1.
Di bagian Devices, pilih satu atau beberapa perangkat fisik yang
ingin digunakan untuk menguji aplikasi, lalu klik Start Tests.
Langkah 3. Periksa hasil pengujian Anda
Saat pengujian dimulai, Anda secara otomatis dialihkan ke halaman hasil pengujian.
Pengujian dapat memakan waktu beberapa menit, tergantung pada jumlah konfigurasi yang berbeda yang telah Anda pilih dan durasi waktu tunggu pengujian yang ditetapkan. Setelah pengujian berjalan, Anda dapat meninjau hasil pengujian. Baca bagian
Menganalisis Hasil Firebase Test Lab untuk mempelajari lebih lanjut
cara menafsirkan hasil pengujian.
[null,null,["Terakhir diperbarui pada 2025-08-16 UTC."],[],[],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."]]
