راهنمای ارتقا «ایستگاه آزمایش Android OmniLab 2.0»

OmniLab Android Test Station (ATS) ابزار اصلی‌ای است که توسعه‌دهندگان و مهندسان آزمایش برای خودکارسازی آزمایش دستگاه‌های Android استفاده می‌کنند. ‫OmniLab ATS میانایی برای مدیریت دستگاه‌ها، مشاهده نتایج، و اجرای مجموعه‌های آزمایشی مثل مجموعه آزمایشی سازگاری (CTS) ارائه می‌دهد.

‫OmniLab ATS 2.0 یک مدرن‌سازی بزرگ در موتور ایستگاه است. زیرساخت زیربنایی را به OmniLab، پلاتفرم مدرن و با عملکرد بالای Google، منتقل کردیم. این تغییر به توسعه‌دهندگان Android و مهندسان آزمایش اجازه می‌دهد از همان ابزارهای قدرتمندی که Google استفاده می‌کند استفاده کنند.

توصیه می‌کنیم که استفاده از OmniLab ATS 2.0 را شروع کنید. این ویژگی ازطریق پرچم پیکربندی دردسترس است و به شما امکان می‌دهد بلافاصله از عملکرد و پایداری بهبودیافته بهره‌مند شوید.

مزایای کلیدی OmniLab ATS 2.0

• زیرساخت مدرن: از پلاتفرم OmniLab برای بهبود پایداری و عملکرد استفاده می‌کند.
• انتقال یکپارچه: هیچ تغییری در واسط کاربر وب یا گردش‌های کار اجرای تست اصلی ایجاد نمی‌شود.
• آماده برای آینده: با زیرساخت آزمایش یکپارچه Google هماهنگ است و امکان پذیرش سریع‌تر ویژگی‌های جدید را فراهم می‌کند.

ویژگی‌های جدید

این ویژگی‌ها عملیات آزمایشی شما را ساده می‌کنند:

• به‌روزرسانی انبوه طرح‌های آزمایشی: می‌توانید چندین طرح آزمایشی را به‌طور هم‌زمان با فیلتر کردن آن‌ها با برچسب‌ها پیکربندی کنید. این کار به شما امکان می‌دهد زمان‌بندی‌های سفارشی، کنش‌های اجرای آزمایشی، و منابع را در ده‌ها طرح در یک مرحله به‌روز کنید، و زمان پیکربندی دستی را کاهش دهید.

• پشتیبانی بهبودیافته از استقرار چندمیزبانی و ابری: ATS 2.0 زمان‌بندی آزمایش، انتقال فایل، و ذخیره فایل در حافظه نهان را بهینه‌سازی می‌کند تا سیستم در حالت‌های استقرار متعدد، قوی، کارآمد، و انعطاف‌پذیر باشد.

• Cloud Orchestration: ATS 2.0 supports Cloud Orchestration to dynamically provision, scale, and manage Cuttlefish virtual devices during test runs.

مقایسه ویژگی‌ها: ATS 1.0 دربرابر ATS 2.0

قابلیت	ATS 1.0	ATS 2.0
موتور زیربنایی	Tradefed و خوشه Tradefed	پلاتفرم OmniLab، پلاتفرم دستگاه استاندارد Google
رابط کاربری	میانای کاربر MTT	میانای کاربر MTT
مقیاس	محلی و چندمیزبانی	محلی و چند میزبان؛ بهینه‌شده برای استقرار چند میزبان
تلاش‌های مجدد	قوانین تکرار مجدد پایه	تلاش‌های مجدد قابل‌سفارشی‌سازی، زمان‌بندی پیشرفته تلاش مجدد
پشتیبانی از دستگاه مجازی	پشتیبانی از مزرعه‌های دستگاه محلی و ابری	پشتیبانی از مزارع دستگاه محلی و ابری
پردازش نتایج	مبتنی بر Tradefed	برپایه OmniLab ATS (با کنسول CTS هم‌رسانی می‌شود)
API	پشتیبانی می‌شود	پشتیبانی می‌شود

تغییرات تجربه کاربری

اگرچه بیشتر تغییرات داخلی است، به‌روزرسانی‌های رفتاری زیر را درنظر داشته باشید:

• مجموعه‌های آزمایشی محافظت‌شده با گذرواژه (مثل «مجموعه آزمایشی امنیتی» (STS)): در ATS 1.0، مجموعه‌های محافظت‌شده با گذرواژه بااستفاده از Trade Federation استخراج می‌شدند setup_scripts (مثل اجرای unzip -P ...).

  در OmniLab ATS 2.0، سرور به‌طور بومی فشرده‌سازی بسته آزمایش را قبل‌از شروع Tradefed انجام می‌دهد. برای مجموعه‌های محافظت‌شده با گذرواژه:

  • فرمان دستی unzip -P ... را از نوشته‌های راه‌اندازی بردارید. نگه داشتن دستورگان باز کردن فایل فشرده منجر به خطای فراخوانی می‌شود.
  • گذرواژه رمزگشایی بسته آزمایشی را مستقیماً در فیلد گذرواژه در بخش تعاریف منبع آزمایشی وارد کنید.

  

  شکل ۱. درحال تطبیق پیکربندی آزمایش STS در ATS 2.0.

• دایرکتوری نتایج: ساختار دایرکتوری برونداد در دیسک شما برای نتایج آزمایش به‌دلیل تغییر زیرساخت به‌روز شده است. بااین‌حال، همچنان می‌توانید ازطریق داشبورد اجرای آزمایشی به این فایل‌ها دسترسی داشته باشید.

  

  شکل ۲. فهرست فایل‌های برونداد را مشاهده کنید.

• گزارش‌های آزمایش: ساختار گزارش آزمایش تغییر کرده است. می‌توانید سه منبع گزارش را از یک فراخوانی ببینید: گزارش‌های تولیدشده توسط آزمون Tradefed xTS (همچنین در ATS 1.0)، گزارش‌های سرور OmniLab برای وضعیت دستگاه و آزمون، و گزارش‌های آزمون Mobly برای واحدهای Mobly نسخه ۲.

  

  شکل ۳. منابع گزارش ATS 2.0: ‏ Tradefed xTS، سرور OmniLab، و گزارش‌های آزمایش Mobly.

  اگر CTS را با گزینه بارگیری پویا روشن اجرا کنید، OmniLab ATS علاوه‌بر آزمایش‌های CTS، آزمایش‌های MCTS را نیز به‌طور خودکار راه‌اندازی می‌کند و گزارش‌های MCTS در بخش گزارش Tradefed نیز دردسترس است.

  

  شکل ۴. آزمایش MCTS با بارگیری پویای XTS راه‌اندازی شد.

  

  شکل ۵. گزارش‌های MCTS در بخش گزارش Tradefed، علاوه‌بر گزارش‌های CTS.

فرایند ارتقا

ارتقا یک کلید نرم‌افزاری مبتنی بر پرچم است، بنابراین نیازی به نصب مجدد یا تغییرات سخت‌افزاری نیست.

برای فعال کردن OmniLab ATS 2.0 جدید:

1. نمونه فعلی‌تان را متوقف کنید:

   mtt stop

2. ‫OmniLab ATS را با پرچم force_ats_version 2 شروع کنید:

   mtt start --force_ats_version 2

   اگر از جدیدترین نسخه ساخت استفاده نمی‌کنید، --force_update را برای واکشی کردن آن اضافه کنید:

   mtt start --force_ats_version 2 --force_update

3. اختیاری: اگر با ATS 2.0 به مشکل برخوردید، می‌توانید با برداشتن --force_ats_version 2 یا استفاده صریح از --force_ats_version 1، موقتاً به ATS 1.0 برگردید:

   mtt start --force_ats_version 1

خط زمان گذار

در سال ۲۰۲۶، OmniLab ATS 1.0 را به‌تدریج منسوخ خواهیم کرد. انتقال را براساس آن برنامه‌ریزی کنید:

• سه‌ماهه اول ۲۰۲۶: ATS 2.0 به‌عنوان یک گزینه برای همه توسعه‌دهندگان و شرکا دردسترس است.
• سه‌ماهه دوم ۲۰۲۶: ATS 2.0 برای تعداد فزاینده‌ای از توسعه‌دهندگان و شرکا به پیش‌فرض تبدیل می‌شود.
• سه‌ماهه سوم ۲۰۲۶: ATS 2.0 به نسخه استاندارد برای همه توسعه‌دهندگان و شرکا تبدیل می‌شود.
• سه‌ماهه چهارم ۲۰۲۶: نسخه قدیمی ATS 1.0 منسوخ و از ساخت‌های تولید برداشته می‌شود.

پشتیبانی

اگر درطول ارتقا با مشکلی مواجه شدید، از این منابع استفاده کنید:

• پشتیبانی استفاده: برای راهنمای راه‌اندازی و عیب‌یابی، به ایستگاه آزمایش Android در OmniLab مراجعه کنید.
• گزارش مشکلات: گزارش‌های اشکال را ببینید.