از 27 مارس 2025، توصیه می کنیم از android-latest-release
به جای aosp-main
برای ساختن و کمک به AOSP استفاده کنید. برای اطلاعات بیشتر، به تغییرات AOSP مراجعه کنید.
رابط کاربری داشبورد VTS
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
داشبورد VTS یک رابط کاربری منسجم ارائه میکند که از طراحی متریال برای نمایش مؤثر اطلاعات در مورد نتایج آزمایش، نمایهسازی و پوشش استفاده میکند. استایل داشبورد از کتابخانههای منبع باز جاوا اسکریپت از جمله Materialize CSS و jQueryUI برای پردازش دادههای ارائهشده توسط سرورهای جاوا در Google App Engine استفاده میکند.
خانه داشبورد
صفحه اصلی داشبورد فهرستی از مجموعههای آزمایشی را نشان میدهد که کاربر به موارد دلخواه اضافه کرده است.
شکل 1. داشبورد VTS، صفحه اصلی. از این لیست، کاربران می توانند:
- یک مجموعه آزمایشی را برای مشاهده نتایج آن مجموعه انتخاب کنید.
- برای مشاهده همه نامهای آزمون VTS روی SHOW ALL کلیک کنید.
- برای تغییر لیست علاقه مندی ها، نماد ویرایش را انتخاب کنید.
شکل 2. داشبورد VTS، ویرایش صفحه علاقه مندی ها.
نتایج تست
نتایج تست آخرین اطلاعات مربوط به مجموعه آزمایشی انتخابی را نشان میدهد، از جمله فهرستی از نقاط نمایه، جدولی از نتایج آزمایشی به ترتیب زمانی، و نمودار دایرهای که نتایج تجزیه نتایج آخرین اجرا را نشان میدهد (کاربران میتوانند دادههای قدیمیتر را با صفحهبندی سمت راست بارگیری کنند).
شکل 3. داشبورد VTS، نتایج آزمون. کاربران می توانند داده ها را با استفاده از پرس و جو یا با تغییر نوع آزمایش (پیش ارسال، پس از ارسال یا هر دو) فیلتر کنند. عبارت های جستجو از نشانه های عمومی و واجد شرایط فیلد خاص پشتیبانی می کنند. فیلدهای جستجوی پشتیبانی شده عبارتند از: شناسه ساخت دستگاه، شاخه، نام هدف، نام دستگاه، و شناسه ساخت آزمایشی. اینها در قالب مشخص شده اند: FIELD-ID = SEARCH QUERY ". نقل قول ها برای تلقی چندین کلمه به عنوان یک نشانه واحد برای مطابقت با داده های موجود در ستون ها استفاده می شوند.
پروفایل داده ها
کاربران می توانند یک نقطه پروفایل را برای رسیدن به یک نمای تعاملی از داده های کمی برای آن نقطه در نمودار خطی یا هیستوگرام انتخاب کنند (نمونه های زیر). به طور پیش فرض، نمایش آخرین اطلاعات را نمایش می دهد. کاربران می توانند از انتخابگر تاریخ برای بارگیری پنجره های زمانی خاص استفاده کنند.
شکل 4. داشبورد VTS، عملکرد نمودار خطی. نمودارهای خطی دادههایی را از مجموعهای از مقادیر عملکرد نامرتب نشان میدهند، که میتواند زمانی مفید باشد که آزمایش عملکرد بردار مقادیر عملکردی را تولید کند که به عنوان تابعی از متغیر دیگر (مثلاً توان عملیاتی در مقابل اندازه پیام) متفاوت است.
شکل 5. داشبورد VTS، عملکرد هیستوگرام. پوشش تست
کاربران می توانند اطلاعات پوشش را از پیوند درصد پوشش در نتایج آزمون مشاهده کنند.
شکل 6. داشبورد VTS، درصدهای پوشش. برای هر مورد آزمایشی و فایل منبع، کاربران میتوانند یک عنصر قابل گسترش حاوی کد منبع رنگی را مطابق با پوشش ارائه شده توسط آزمون انتخابی مشاهده کنند:
شکل 7. داشبورد VTS، کد منبع پوشش.- خطوط بدون پوشش قرمز برجسته شده اند.
- خطوط پوشیده شده به رنگ سبز برجسته شده اند.
- خطوط غیر قابل اجرا بدون رنگ هستند.
اطلاعات پوشش بسته به بخشهایی گروهبندی میشود که بستگی به نحوه ارائه آن در زمان اجرا دارد. آزمایش ها ممکن است پوشش را بارگذاری کنند:
- در هر تابع . سرصفحههای بخش دارای قالب "پوشش: FUNCTION-NAME " هستند.
- در توتال (ارائه شده در پایان اجرای آزمایشی). فقط یک سرصفحه وجود دارد: "پوشش: همه".
داشبورد کد منبع سمت سرویس گیرنده را از یک سرور واکشی می کند که از API منبع باز Gerrit REST استفاده می کند.
نظارت و آزمایش
داشبورد VTS مانیتورها و تست های واحد زیر را ارائه می دهد.
- هشدارهای ایمیل را آزمایش کنید . هشدارها در یک کار Cron که در فاصله زمانی ثابت دو (2) دقیقه اجرا میشود، پیکربندی میشوند. این کار جدول وضعیت VTS را می خواند تا مشخص کند آیا داده های جدیدی در هر جدول آپلود شده است یا خیر، با بررسی اینکه مهر زمانی آپلود داده های خام آزمایش جدیدتر از آخرین مهر زمانی به روز رسانی وضعیت است. اگر مُهر زمانی آپلود جدیدتر باشد، درخواستهای شغلی برای دادههای جدید از هماکنون تا آخرین بارگذاری دادههای خام است. خرابیهای مورد آزمایش جدید، ادامه شکستهای مورد آزمایش، شکستهای گذرا در مورد آزمایش، رفعهای مورد آزمایش، تستهای غیرفعال مشخص میشوند. سپس این اطلاعات در قالب ایمیل برای مشترکین هر آزمون ارسال می شود.
- سلامت وب سرویس . Google Stackdriver با Google App Engine ادغام می شود تا نظارت آسانی بر داشبورد VTS ارائه دهد. بررسیهای ساده آپتایم تأیید میکند که میتوان به صفحات دسترسی داشت، در حالی که آزمایشهای دیگر را میتوان برای تأیید تأخیر در هر صفحه، سرورلت یا پایگاه داده ایجاد کرد. این بررسیها اطمینان میدهند که داشبورد همیشه در دسترس است (در غیر این صورت به مدیر اطلاع داده میشود).
- تجزیه و تحلیل . می توانید با تعیین شناسه Analytics معتبر در پیکربندی صفحه (فایل pom.xml) یک صفحه داشبورد VTS را با Google Cloud Analytics ادغام کنید. یکپارچه سازی تجزیه و تحلیل قوی تری از استفاده از صفحه، تعامل کاربر، موقعیت مکانی، آمار جلسه و غیره ارائه می دهد.
محتوا و نمونه کدها در این صفحه مشمول پروانههای توصیفشده در پروانه محتوا هستند. جاوا و OpenJDK علامتهای تجاری یا علامتهای تجاری ثبتشده Oracle و/یا وابستههای آن هستند.
تاریخ آخرین بهروزرسانی 2025-07-29 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","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-07-29 بهوقت ساعت هماهنگ جهانی."],[],[],null,["# VTS Dashboard UI\n\nThe VTS Dashboard provides a cohesive user interface that uses material design\nto effectively display information about test results, profiling, and coverage.\nDashboard styling uses open-source Javascript libraries including Materialize\nCSS and jQueryUI to process data delivered by Java servlets in Google App\nEngine.\n\nDashboard home\n--------------\n\n\nThe Dashboard home page displays a list of test suites a user has added to\nfavorites.\n**Figure 1.** VTS Dashboard, home page.\n\n\nFrom this list, users can:\n\n- Select a test suite to view results for that suite.\n- Click **SHOW ALL** to view all VTS test names.\n- Select the **Edit** icon to modify the Favorites list. \n **Figure 2.** VTS Dashboard, editing Favorites page.\n\nTest results\n------------\n\n\nTest Results displays the latest information about the selected test suite,\nincluding a list of profiling points, a table of test case results in\nchronological order, and a pie chart displaying the result breakdown of the\nlatest run (users can load older data by paging right).\n**Figure 3.** VTS Dashboard, test results.\n\n\nUsers can filter data using queries or by modifying the test type (pre-submit,\npost-submit, or both). Search queries support general tokens and field-specific\nqualifiers; supported search fields are: device build ID, branch, target name,\ndevice name, and test build ID. These are specified in the format:\n\u003cvar translate=\"no\"\u003eFIELD-ID\u003c/var\u003e=\"\u003cvar translate=\"no\"\u003eSEARCH QUERY\u003c/var\u003e\". Quotes are used to treat multiple\nwords as a single token to match with the data in the columns.\n\nData profiling\n--------------\n\n\nUsers can select a profiling point to reach an interactive view of the\nquantitative data for that point in a **line graph** or\n**histogram** (examples below). By default, the view displays the\nlatest information; users can use the date picker to load specific time windows.\n**Figure 4.** VTS Dashboard, line graph performance.\n\n\nLine graphs display data from a collection of unordered performance values,\nwhich can be useful when a test of performance produces a vector of performance\nvalues that vary as a function of another variable (e.g., throughput versus\nmessage size).\n**Figure 5.** VTS Dashboard, histogram performance.\n\nTest coverage\n-------------\n\n\nUsers can view coverage information from the coverage percent link in test\nresults.\n**Figure 6.** VTS Dashboard, coverage percentages.\n\n\nFor each test case and source file, users can view an expandable element\ncontaining color-coded source code according to the coverage provided by the\nselected test:\n**Figure 7.** VTS Dashboard, coverage source code.\n\n- Uncovered lines are highlighted red.\n- Covered lines are highlighted green.\n- Non-executable lines are **uncolored**.\n\n\nCoverage information is grouped depending into sections depending on how it was\nprovided at run-time. Tests may upload coverage:\n\n- **Per function** . Section headers have the format \"Coverage: \u003cvar translate=\"no\"\u003eFUNCTION-NAME\u003c/var\u003e\".\n- **In Total** (provided at the end of the test run). Only one header is present: \"Coverage: All\".\n\n\nThe Dashboard fetches source code client-side from a server, which uses the\nopen-source\n[Gerrit REST API](https://gerrit-review.googlesource.com/Documentation/rest-api.html).\n\nMonitoring and testing\n----------------------\n\n\nThe VTS Dashboard provides the following monitors and unit tests.\n\n- **Test email alerts**. Alerts are configured in a Cron job that executes at a fixed interval of two (2) minutes. The job reads the VTS status table to determine if new data has been uploaded to each table, done by checking the test's raw data upload timestamp is newer than the last status update timestamp. If the upload timestamp is newer, the job queries for new data between now and the last raw data upload. New test case failures, continued test case failures, transient test case failures, test case fixes, an inactive tests are determined; this information is then sent in email format to the subscribers of each test.\n- **Web service health**. Google Stackdriver integrates with Google App Engine to provide easy monitoring of the VTS Dashboard. Simple uptime checks verify pages can be accessed while other tests can be created to verify latency on each page, servlet, or database. These checks ensure the Dashboard is always accessible (else an administrator will be notified).\n- **Analytics**. You can integrate a VTS Dashboard page with Google Cloud Analytics by specifying a valid Analytics ID in the page configuration (the pom.xml file). Integration provides a more robust analysis of page usage, user interaction, locality, session statistics, etc."]]