تست را با سیستم های CI شروع کنید

هنگام توسعه برنامه خود با استفاده از هر سیستم یکپارچه سازی مداوم (CI) می توانید از Firebase Test Lab استفاده کنید. سیستم های یکپارچه سازی مداوم به شما امکان می دهد هر بار که به روز رسانی کد منبع برنامه خود را بررسی می کنید ، برنامه خود را به طور خودکار بسازید و آزمایش کنید.

استفاده از آزمایشگاه آزمایشی Firebase با Jenkins CI

این بخش نحوه استفاده از تست آزمایشگاه با جنکینز CI .

الزامات

قبل از استفاده از Firebase Test Lab با جنکینز ، باید مراحل زیر را انجام دهید:

  1. gcloud را راه اندازی کنید دستورالعمل از دنبال استفاده از فایربیس تست آزمایشگاه از gcloud خط فرمان برای ایجاد یک پروژه فایربیس و پیکربندی محیط گوگل ابر SDK محلی خود را.

  2. ایجاد و تأیید حساب خدمات حسابهای خدمات مشمول بررسی هرزنامه یا درخواست های captcha نمی شوند ، که در غیر این صورت می تواند ساختارهای CI شما را مسدود کند. ایجاد یک حساب کاربری خدمات با نقش ویرایشگر در ابر کنسول گوگل و سپس آن را فعال کنید (ببینید gcloud تایید اسناد و مدارک فعال سرویس حساب به یاد بگیرند که چگونه).

  3. API های مورد نیاز را فعال کنید. پس از ورود با استفاده از حساب خدمات: در صفحه گوگل کنسول API کتابخانه ، فعال کردن API تست Google Cloud و ابر ابزار نمایش نتایج: از API. برای فعال کردن این API ها، این نام API در بالای کنسول تایپ کنید را در جعبه جستجو، و سپس کلیک کنید فعال کردن API در صفحه مرور کلی که API.

Jenkins را نصب و راه اندازی کنید

می توانید Jenkins CI را روی لینوکس یا ویندوز نصب و راه اندازی کنید. جزئیات خاصی از این راهنمای خاص به نصب و اجرای جنکینز CI بر روی لینوکس، از جمله استفاده از اسلش (هستند / ) در مسیر فایل.

برای دانلود و نصب جنکینز بر روی یک کامپیوتر در حال اجرا لینوکس یا ویندوز، دستورالعمل های روی را دنبال نصب جنکینز . پس از نصب جنکینز، دستورالعملهای موجود در شروع و دسترسی به جنکینز به راه اندازی کامل و دسترسی به داشبورد جنکینز.

تنظیمات امنیت جهانی را پیکربندی کنید

Jenkins احراز هویت کاربر و کنترل دسترسی را که برای اولین بار پیکربندی شده است ، ندارد. قبل از استفاده از Jenkins با Firebase Test Lab ، تنظیمات امنیتی جهانی را برای کنترل دسترسی و احراز هویت کاربران پیکربندی کنید.

برای پیکربندی تنظیمات امنیت جهانی

  1. به داشبورد جنکینز در سرور خود بروید. برای این کار، مرورگر خود، http انجام دهید: // <به ServerName>: 8080، که در آن <به ServerName> نام کامپیوتر که در آن شما جنکینز نصب شده است.
  2. بر روی داشبورد جنکینز، کلیک مدیریت جنکینز، و سپس کلیک کنید پیکربندی امنیت جهانی.
  3. در صفحه پیکربندی امنیت جهانی، کلیک فعال کردن امنیت، و سپس کلیک کنید ذخیره.

برای کسب اطلاعات بیشتر در مورد پیکربندی تنظیمات امنیتی برای جنکینز، و سریع و ساده امنیت ، راه اندازی استاندارد امنیت و ایمن جنکینز .

ایجاد پروژه جنکینز

در مرحله بعد ، یک پروژه برای اجرای یکپارچه سازی مداوم برنامه خود با Firebase Test Lab ایجاد کنید.

برای ایجاد پروژه جنکینز

  1. به داشبورد جنکینز در سرور خود بروید. برای این کار، مرورگر خود، http انجام دهید: // <به ServerName>: 8080، که در آن <به ServerName> نام کامپیوتر که در آن شما جنکینز نصب شده است.
  2. بر روی داشبورد جنکینز، کلیک کنید آیتم جدید.
  3. نوع یک نام برای پروژه خود را در قسمت نام کالا:
    • پروژه آزاد برای ایجاد یک پروژه که با استفاده از یک پیکربندی ساخت تک را انتخاب کنید.
    • ساخت پروژه چند پیکربندی را انتخاب کنید برای ایجاد یک پروژه که قابل اجرا بر روی چندین پیکر بندی های ساخت متفاوت است. اگر قصد دارید برنامه خود را با انواع پیکربندی های ساخت (چندین منطقه ، چندین سطح API Android و غیره) بسازید ، پس یک پروژه چند پیکربندی بهترین انتخاب است.
  4. ذخیره کلیک کنید.

پس از ایجاد پروژه ، مرورگر وب شما صفحه اصلی پروژه شما را نشان می دهد.

مراحل بازبینی و مراحل ساخت Gradle را اضافه کنید

این بخش نحوه ادغام جنکینز با سیستم های کنترل تجدید نظر مانند GitHub و نحوه افزودن مراحل ساخت Gradle برای ساخت بسته های APK از کد منبع را توضیح می دهد.

ادغام با GitHub و سایر سیستم های کنترل تجدید نظر

اگر از GitHub یا سیستم کنترل تجدید نظر دیگری برای مدیریت کد منبع برنامه خود استفاده می کنید ، می توانید Jenkins را طوری پیکربندی کنید که هر بار که آپدیت برنامه شما بررسی می شود ، بیلد های خودکار را اجرا کرده و تست ها را اجرا کند. همچنین می توانید Jenkins را پیکربندی کنید تا به طور دوره ای بیلدها را اجرا کند.

برای یادگیری در مورد پیکربندی های ایجاد شده در جنکینز، و پیکربندی خودکار ایجاد .

افزودن مراحل ساخت Gradle برای بازسازی بسته های APK

اگر از سیستم کنترل تجدید نظر برای مدیریت کد منبع برنامه خود استفاده می کنید ، باید هر بار که جنکینز کد منبع را از سیستم کنترل تجدید نظر شما بارگیری می کند ، یک مرحله ساخت Gradle ایجاد کنید تا فایل های باینری APK جدید ایجاد کند.

  1. اضافه کردن یک گام ساخت برای اجرای دستورات زیر را در دایرکتوری اصلی برنامه خود را:

    ./gradlew :app:assembleDebug
    ./gradlew :app:assembleDebugAndroidTest
    

  2. هنگام استفاده از Test Lab ، یک مرحله ساخت برای استفاده از بسته (های) APK ایجاد شده توسط Gradle اضافه کنید. : شما می توانید این مسیر را به عنوان <local_server_path> در مثال اسکریپت پوسته در زیر ارائه شده، که در آن <AppFolder> فولدر پروژه استودیو Android برای برنامه شما است استفاده

    <AppFolder>/app/build/outputs/apk
    

مراحل ساخت آزمایشگاه را به جنکینز اضافه کنید

حالا شما آماده هستید تا یک مرحله ساخت به جنکینز اضافه کنید تا Test Lab را با استفاده از خط فرمان gcloud اجرا کند.

برای افزودن مرحله ساخت gcloud

  1. از صفحه اصلی برای پروژه شما، پیکربندی را کلیک کنید.
  2. در صفحه پیکربندی پروژه، در پایین حرکت به بخش ساخت، و سپس انتخاب کنید اجرا پوسته از منوی Add ساخت گام.

  3. در جنکینز اجرا پنجره فرمان پوسته، موارد زیر را وارد کنید، جایگزین <local_server_path> راه به برنامه نمونه بر روی سرور، <app_apk> برای APK برنامه خود را، و <app_test_apk> برای APK آزمون برنامه شما:

    gcloud firebase test android run --app <local_server_path>/<app_apk>.apk
    --test <local_server_path>/<app_test_apk>.apk
    

تجزیه و تحلیل نتایج آزمایش

پس از تست آزمایشگاه کامل تست از برنامه خود را، شما می توانید نتایج تست را در فایربیس کنسول و یا در یک بررسی گوگل ابر ذخیره سازی سطل در پروژه شما. شما همچنین می توانید اضافه کنید gsutil فرمان به پوسته فرمان بالا نشان داده شده به کپی کردن اطلاعات نتایج آزمون به کامپیوتر های محلی خود را. برای کسب اطلاعات بیشتر، نگاه کنید به تجزیه و تحلیل فایربیس تست آزمایشگاه نتایج .

ادغام مداوم با سایر سیستم های CI

برای یادگیری نحوه استفاده از Firebase Test Lab با سایر سیستم های CI ، اسناد آنها را بررسی کنید: