آزمایش را با سیستم های یکپارچه سازی پیوسته (CI) شروع کنید
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
هنگام توسعه برنامه خود با استفاده از هر سیستم یکپارچه سازی پیوسته (CI) می توانید از Firebase Test Lab استفاده کنید. سیستم‌های یکپارچه‌سازی پیوسته به شما امکان می‌دهند هر بار که به‌روزرسانی‌های کد منبع برنامه خود را بررسی می‌کنید، به‌طور خودکار برنامه خود را بسازید و آزمایش کنید.
استفاده از Firebase Test Lab با Jenkins CI
این بخش نحوه استفاده از Test Lab با Jenkins CI را شرح می دهد.
الزامات
قبل از اینکه بتوانید از Firebase Test Lab با جنکینز استفاده کنید، باید مراحل زیر را انجام دهید:
ایجاد و مجوز یک حساب خدمات. حساب‌های سرویس تحت بررسی هرزنامه یا درخواست‌های کپچا قرار نمی‌گیرند، که در غیر این صورت می‌تواند ساخت‌های CI شما را مسدود کند. یک حساب سرویس با نقش ویرایشگر در کنسول Google Cloud ایجاد کنید و سپس آن را فعال کنید (برای یادگیری نحوه انجام آن به مستندات gcloud auth activate-service-account مراجعه کنید).
API های مورد نیاز را فعال کنید. پس از ورود به سیستم با استفاده از حساب سرویس: در صفحه کتابخانه Google Developers Console API ، Google Cloud Testing API و Cloud Tool Results API را فعال کنید. برای فعال کردن این APIها، این نام‌های API را در کادر جستجو در بالای کنسول تایپ کنید و سپس روی Enable API در صفحه نمای کلی آن API کلیک کنید.
Jenkins را نصب و راه اندازی کنید
می توانید Jenkins CI را در لینوکس یا ویندوز نصب و راه اندازی کنید. جزئیات خاصی از این راهنما مربوط به نصب و اجرای Jenkins CI در لینوکس است، از جمله استفاده از اسلش ( / ) در مسیرهای فایل.
برای دانلود و نصب Jenkins روی رایانه‌ای که دارای لینوکس یا ویندوز است، دستورالعمل‌های Installing Jenkins را دنبال کنید. پس از نصب Jenkins، دستورالعمل‌های Starting and Accessing Jenkins را دنبال کنید تا تنظیمات را کامل کنید و به داشبورد Jenkins دسترسی پیدا کنید.
تنظیمات امنیتی جهانی را پیکربندی کنید
جنکینز در اولین نصب، احراز هویت کاربر و کنترل دسترسی را پیکربندی نکرده است. قبل از استفاده از Jenkins با Firebase Test Lab ، تنظیمات امنیتی جهانی را برای اعمال کنترل دسترسی و احراز هویت کاربران پیکربندی کنید.
برای پیکربندی تنظیمات امنیتی جهانی
به داشبورد جنکینز در سرور خود بروید. برای انجام این کار، به http://<servername>:8080 مراجعه کنید، جایی که <servername> نام رایانه ای است که جنکینز را در آن نصب کرده اید.
در داشبورد Jenkins، روی Manage Jenkins کلیک کنید و سپس روی Configure Global Security کلیک کنید.
در صفحه پیکربندی امنیت جهانی ، روی Enable Security کلیک کنید و سپس روی Save کلیک کنید.
در مرحله بعد، یک پروژه برای اجرای آزمایش یکپارچه سازی مداوم برنامه خود با Firebase Test Lab ایجاد کنید.
برای ایجاد یک پروژه جنکینز
به داشبورد جنکینز در سرور خود بروید. برای انجام این کار، به http://<servername>:8080 مراجعه کنید، جایی که <servername> نام رایانه ای است که جنکینز را در آن نصب کرده اید.
در داشبورد جنکینز، روی آیتم جدید کلیک کنید.
در قسمت Item name نامی برای پروژه خود تایپ کنید:
پروژه Freestyle را برای ایجاد پروژه ای که از یک پیکربندی ساخت استفاده می کند، انتخاب کنید.
برای ایجاد پروژه ای که روی چندین پیکربندی ساخت مختلف اجرا می شود ، پروژه ساخت چند پیکربندی را انتخاب کنید. اگر قصد دارید اپلیکیشن خود را با پیکربندی های مختلف ساخت (چندین لوکال، چندین سطح API اندروید و غیره) بسازید، پس یک پروژه چند پیکربندی بهترین انتخاب است.
روی ذخیره کلیک کنید.
پس از ایجاد پروژه، مرورگر وب شما صفحه اصلی پروژه شما را نمایش می دهد.
کنترل ویرایش و مراحل ساخت Gradle را اضافه کنید
این بخش نحوه ادغام Jenkins با سیستم‌های کنترل بازبینی مانند GitHub و نحوه اضافه کردن مراحل ساخت Gradle برای ساخت بسته‌های APK از کد منبع را توضیح می‌دهد.
ادغام با GitHub و سایر سیستم های کنترل تجدید نظر
اگر از GitHub یا سیستم کنترل ویرایش دیگری برای مدیریت کد منبع برنامه خود استفاده می‌کنید، می‌توانید Jenkins را پیکربندی کنید تا ساخت‌های خودکار را اجرا کند و هر بار که به‌روزرسانی‌های برنامه شما بررسی می‌شود، آزمایش‌هایی را اجرا کنید. همچنین می‌توانید Jenkins را برای اجرای دوره‌ای بیلدها پیکربندی کنید.
افزودن مراحل ساخت Gradle برای بازسازی بسته های APK
اگر از یک سیستم کنترل بازبینی برای مدیریت کد منبع برنامه خود استفاده می‌کنید، باید هر بار که جنکینز کد منبع را از سیستم کنترل ویرایش خود دانلود می‌کند، یک مرحله ساخت Gradle را برای ایجاد باینری‌های APK جدید اضافه کنید.
برای اجرای دستورات زیر در دایرکتوری اصلی برنامه خود، یک مرحله ساخت اضافه کنید:
برای استفاده از بسته(های) APK ایجاد شده توسط Gradle هنگام آزمایش با Test Lab یک مرحله ساخت اضافه کنید. می توانید از این مسیر به عنوان <local_server_path> در مثال پوسته اسکریپت ارائه شده در زیر استفاده کنید، جایی که <AppFolder> پوشه پروژه Android Studio برای برنامه شما است:
<AppFolder>/app/build/outputs/apk
مراحل ساخت Test Lab را به جنکینز اضافه کنید
اکنون آماده اضافه کردن یک مرحله ساخت به Jenkins برای اجرای Test Lab با استفاده از خط فرمان gcloud هستید.
برای افزودن مرحله ساخت gcloud
از صفحه اصلی پروژه خود، روی Configure کلیک کنید.
در صفحه پیکربندی پروژه ، به قسمت Build بروید و سپس از منوی افزودن مرحله ساخت،Execute shell را انتخاب کنید.
در پنجره دستوری Jenkins Execute shell ، عبارت زیر را وارد کنید و مسیر برنامه نمونه روی سرور را به جای <local_server_path> ، APK برنامه خود <app_apk> و APK آزمایشی برنامه را <app_test_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 را به دستور پوسته نشان داده شده در بالا اضافه کنید تا داده های نتایج آزمایش را در رایانه محلی خود کپی کنید. برای کسب اطلاعات بیشتر، به تجزیه و تحلیل نتایج Firebase Test Lab مراجعه کنید.
ادغام مداوم با سایر سیستم های CI
برای یادگیری نحوه استفاده از Firebase Test Lab با سایر سیستم‌های CI، اسناد آنها را بررسی کنید:
تاریخ آخرین بهروزرسانی 2025-09-04 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین بهروزرسانی 2025-09-04 بهوقت ساعت هماهنگ جهانی."],[],[],null,["\u003cbr /\u003e\n\nYou can use Firebase Test Lab when developing your app using any continuous\nintegration (CI) system. Continuous integration systems let you automatically\nbuild and test your app each time you check in updates to your app source code.\n\nUsing Firebase Test Lab with Jenkins CI\n\nThis section describes how to use Test Lab with\n[Jenkins CI](http://jenkins-ci.org/).\n\nRequirements\n\nBefore you can use Firebase Test Lab with Jenkins, you need to complete the\nfollowing steps:\n\n1. **Set up gcloud.** Follow the instructions from\n [Using Firebase Test Lab from the gcloud Command Line](/docs/test-lab/android/command-line)\n to create a Firebase project and configure your local Google Cloud SDK\n environment.\n\n2. **Create and authorize a service account.** Service accounts aren't subject\n to spam checks or captcha prompts, which could otherwise block your CI\n builds. Create a service account with an **Editor** role in the\n [Google Cloud console](https://console.cloud.google.com/iam-admin/serviceaccounts/)\n and then activate it\n (see the [gcloud auth activate-service-account documentation](https://cloud.google.com/sdk/gcloud/reference/auth/activate-service-account)\n to learn how).\n\n3. **Enable required APIs.** After logging in using the service account: In the\n [Google Developers Console API Library page](https://console.developers.google.com/apis/library),\n enable the **Google Cloud Testing API** and **Cloud Tool Results API** . To\n enable these APIs, type these API names into the search box at the top of the\n console, and then click **Enable API** on the overview page for that API.\n\nInstall and set up Jenkins\n\nYou can install and set up Jenkins CI on Linux or Windows. Certain details of\nthis guide are specific to installing and running Jenkins CI on Linux, including\nthe use of slashes (`/`) in file paths.\n\nTo download and install Jenkins on a computer running Linux or Windows, follow\nthe instructions on [Installing\nJenkins](https://wiki.jenkins-ci.org/display/JENKINS/Installing+Jenkins). After\ninstalling Jenkins, follow the instructions on\n[Starting and Accessing Jenkins](https://wiki.jenkins-ci.org/display/JENKINS/Starting+and+Accessing+Jenkins)\nto complete setup and access the Jenkins dashboard.\n\nConfigure global security settings\n\nJenkins does not have user authentication and access control configured when it\nis first installed. Before using Jenkins with Firebase Test Lab, configure\nglobal security settings to enforce access control and authenticate\nusers.\n\nTo configure global security settings\n\n1. Navigate to the Jenkins dashboard on your server. To do this, browse to **http://\\\u003cservername\\\u003e:8080** , where **\\\u003cservername\\\u003e** is the name of the computer where you have installed Jenkins.\n2. On the Jenkins dashboard, click **Manage Jenkins** , and then click **Configure Global Security**.\n3. On the **Configure Global Security** page, click **Enable security** , and then click **Save**.\n\nFor more information about configuring security settings for Jenkins, see\n[Quick and Simple Security](https://wiki.jenkins-ci.org/display/JENKINS/Quick+and+Simple+Security),\n[Standard Security Setup](https://wiki.jenkins-ci.org/display/JENKINS/Standard+Security+Setup),\nand\n[Securing Jenkins](https://wiki.jenkins-ci.org/display/JENKINS/Securing+Jenkins).\n\nCreate a Jenkins project\n\nNext, create a project for running continuous integration testing of your app\nwith Firebase Test Lab.\n\nTo create a Jenkins project\n\n1. Navigate to the Jenkins dashboard on your server. To do this, browse to **http://\\\u003cservername\\\u003e:8080** , where **\\\u003cservername\\\u003e** is the name of the computer where you have installed Jenkins.\n2. On the Jenkins dashboard, click **New Item**.\n3. Type a name for your project in the **Item name** field:\n - Choose **Freestyle project** to create a project that uses a single build configuration.\n - Choose **Build multi-configuration project** to create a project that runs on multiple different build configurations. If you plan to build your app with a variety of build configurations (multiple locales, multiple Android API levels, etc.), then a multi-configuration project is the best choice.\n4. Click **Save**.\n\nAfter your project is created, your web browser displays the main page for your\nproject.\n\nAdd revision control and Gradle build steps\n\nThis section describes how to integrate Jenkins with revision control systems\nsuch as GitHub, and how to add Gradle build steps to build APK packages\nfrom source code.\n\nIntegrating with GitHub and other revision control systems\n\nIf you use GitHub or another revision control system to manage the source code\nfor your app, you can configure Jenkins to run automated builds and run tests\neach time updates to your app are checked in. You can also configure\nJenkins to run builds periodically.\n\nTo learn about configuring builds in Jenkins, see\n[Configuring automatic builds](https://wiki.jenkins-ci.org/display/JENKINS/Building+a+software+project#Buildingasoftwareproject-Configuringautomaticbuilds).\n\nAdding Gradle build steps to rebuild APK packages\n\nIf you use a revision control system to manage source code for your app, you\nneed to include a Gradle build step to create new APK binaries each time Jenkins\ndownloads source code from your revision control system.\n\n1. Add a build step to run the following commands in the main directory for your\n application:\n\n ```\n ./gradlew :app:assembleDebug\n ./gradlew :app:assembleDebugAndroidTest\n ```\n\n \u003cbr /\u003e\n\n2. Add a build step to use the APK package(s) created by Gradle when testing\n with Test Lab. You can use this path as the\n **\\\u003clocal_server_path\\\u003e** in the shell script example provided below,\n where **\\\u003cAppFolder\\\u003e** is the Android Studio project folder for your\n app:\n\n ```\n \u003cAppFolder\u003e/app/build/outputs/apk\n ```\n\n \u003cbr /\u003e\n\nAdd Test Lab build steps to Jenkins\n\nNow you are ready to add a build step to Jenkins to run Test Lab using\nthe gcloud command line.\n\nTo add a gcloud build step\n\n1. From the main page for your project, click **Configure**.\n2. On the **project configuration** page, scroll down to the **Build** section,\n and then choose **Execute shell** from the **Add build step** menu.\n\n3. In the **Jenkins Execute shell command** window, enter the following,\n substituting **\\\u003clocal_server_path\\\u003e** for the path to the sample app on\n the server, **\\\u003capp_apk\\\u003e** for your app's APK, and\n **\\\u003capp_test_apk\\\u003e** for your app's test APK:\n\n ```\n gcloud firebase test android run --app \u003clocal_server_path\u003e/\u003capp_apk\u003e.apk\n --test \u003clocal_server_path\u003e/\u003capp_test_apk\u003e.apk\n ```\n\n \u003cbr /\u003e\n\nAnalyze test results\n\nAfter Test Lab completes testing of your app, you can review test\nresults in the Firebase console or in a\n[Google Cloud Storage](//cloud.google.com/storage/) bucket in\nyour project. You can also add a\n[`gsutil`](//cloud.google.com/storage/docs/gsutil) command to the\nshell command shown above to copy the test results data to your local computer.\nTo learn more, see\n[Analyzing Firebase Test Lab Results](/docs/test-lab/analyzing-results).\n\nContinuous integration with other CI systems\n\nTo learn how to use Firebase Test Lab with other CI systems, check out\ntheir docs:\n\n- [Bitrise](//devcenter.bitrise.io/testing/device-testing-for-android/)\n- [Circle CI](//circleci.com/docs/2.0/language-android/#testing-with-firebase-test-lab)\n\n| **Note:** If you create documentation explaining how to use Firebase Test Lab with another CI system, [contact us](mailto:cloud-test-lab-integration@google.com) so that we can review it for inclusion in this section."]]
