checkbox-cli - آنلاین در ابر

برنامه:

نام

checkbox_ng - CheckboxNG مستندات

CheckboxNG یک ابزار تست سخت افزاری است که برای تایید لپ تاپ ها، دسکتاپ ها و سرورها مفید است
با اوبونتو این یک نسخه جدید از Checkbox است که مستقیماً در بالای PlainBox ساخته شده است

CheckboxNG جایگزین کادر انتخاب، در صورت لزوم.

هشدار:
اسناد در دست توسعه است. برخی از چیزها اشتباه، نادرست یا توصیف هستند
اهداف توسعه به جای وضعیت فعلی

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

CheckboxNG را می توان از یک PPA (توصیه می شود) یا pypi در Ubuntu Precise (12.04) نصب کرد یا
جدیدتر

$ sudo add-apt-repository ppa:checkbox-dev/ppa && sudo apt-get update && sudo apt-get install checkbox-ng

دویدن پایدار رهایی بروزرسانی تست

CheckboxNG پشتیبانی ویژه ای برای اجرای آزمایش های به روز رسانی نسخه پایدار در یک خودکار دارد
شیوه. این همه کارها را از sru.whitelist و نتایج را برای
وب سایت صدور گواهینامه

برای اجرای تست های SRU باید به اصطلاح Secure ID دستگاهی را که هستید بدانید
آزمایش کردن. هنگامی که متوجه شدید که تنها کاری که باید انجام دهید این است که اجرا کنید:

چک باکس $ sru $secure_id submission.xml

آرگومان دوم، submission.xml، نام فایل بازگشتی است که فقط ایجاد می شود
زمانی که ارسال داده ها به وب سایت صدور گواهینامه به هر دلیلی کار نمی کند.

گزارش نویسی اشکالات

برای گزارش اشکالات در پروژه Checkbox به یک حساب راه اندازی نیاز دارید. میتونی پیدا کنی
دستورالعمل on چگونه به ایجاد یک <https://help.launchpad.net/YourAccount/NewAccount>
مفید هنگامی که یک حساب کاربری دارید می توانید گزارش اشکالات <https://bugs.launchpad.net/checkbox-
پروژه/+پرونده>.

در آن صفحه می‌توانید پروژه‌ای را انتخاب کنید که می‌خواهید اشکال را در آن ثبت کنید (ما از تعدادی استفاده می‌کنیم
پروژه‌ها برای هماهنگی انتشارات و ما ترجیح می‌دهیم باگ‌هایی مرتبط با مناسب داشته باشیم
بخشی از چک باکس). اگر پروژه مناسبی برای استفاده می دانید، فقط از آن استفاده کنید و اشکال را ثبت کنید. اگر
شما داخلی های Checkbox را آنقدر نمی شناسید یا شک دارید فقط آن را در پایه ثبت کنید
پروژه "Checkbox" (می توانید استفاده کنید این مستقیم پیوند
<https://bugs.launchpad.net/checkbox/+filebug>.) یکی از اعضای تیم توسعه این کار را انجام خواهد داد
اشکال خود را بررسی کرده و دوباره آن را به مکان مناسب اختصاص دهید. شماره اشکال نخواهد بود
وقتی این اتفاق می افتد تغییر کند.

L' چک باکس پشته

Checkbox Stack مجموعه‌ای از پروژه‌ها است که با هم یک آزمایش کامل را تشکیل می‌دهند
و راه حل صدور گواهینامه از بخش‌های زیر تشکیل شده است (جدول زیر را ببینید
جزئیات اضافی). همه پروژه ها از پرتاب پروژه گروه
<https://launchpad.net/checkbox-project>.

معماری نمودار
[تصویر: نمودار معماری] [تصویر]

این نمودار شامل یک تقریب سطح بالا از معماری فعلی Checkbox است.
سه "ستون" اصلی وجود دارد. در سمت چپ ما داریم پایان محصولات. اینها ابزار واقعی هستند
که گواهینامه و مهندسان از آن استفاده می کنند. در سمت راست ما داریم آزمون بازار. این هست
بازار آزاد فروشندگان و تامین کنندگان تست. این آزمایش ها در ظروف بسته بندی شده به نام
ارائه دهندگان در مرکز ما سه جزء مشترک داریم. کسانی که بخش عمده ای از
چارچوب و رابط های کاربر برای اجرای آزمایش. در نهایت در گوشه پایین سمت چپ وجود دارد
بخشی از چک باکس (یک کتابخانه) است که برای کارهای خاص با HEXR به اشتراک گذاشته می شود. HEXR یک است
برنامه وب خارج از محدوده مورد استفاده در بخشی از فرآیند صدور گواهینامه. فلش نشان می دهد
ارتباط با شکل فلش نشان می دهد که چه کسی با چه کسی تماس می گیرد.

همانطور که قبلا ذکر شد، در ستون مرکزی سه جزء اصلی کد مشترک وجود دارد
(به اشتراک گذاشته شده توسط همه با استفاده از محصولات نهایی که در زیر مورد بحث قرار گرفته است). کد مشترک است
از plainbox، checkbox-ng و checkbox-gui تشکیل شده است. مسئولیت های جزء هستند
در جدول زیر با جزئیات بیشتری مورد بحث قرار گرفته است. در اینجا می توانیم ببینیم که checkbox-gui از DBus استفاده می کند
API توسط checkbox-ng در معرض دید قرار می‌گیرد، که به نوبه خود از checkbox-support (یک کتابخانه کمکی) استفاده می‌کند
جدا شده است، بنابراین مقداری کد را با HEXR) و جعبه ساده به اشتراک بگذارید.

در ستون سمت راست، ارائه دهندگان تست مختلفی وجود دارد. پروژه چک باکس است
تولید و نگهداری تعدادی ارائه دهنده (به جدول زیر مراجعه کنید) اما انتظار می رود
که کاربران پایین دستی ما نیز ارائه دهندگان خود را تولید خواهند کرد (مخصوص یک مشتری یا
پروژه). در نهایت برخی از ارائه دهندگان ممکن است از طرف اشخاص ثالثی باشند که آن را اتخاذ می کنند
فرمت.

در نهایت در گوشه پایین سمت چپ، کتابخانه مشترک، این کتابخانه حاوی تجزیه کننده های بسیاری است
از فرمت های مختلف فایل و فرمت های خروجی. از نظر فنی این کتابخانه یک وابستگی به
HEXR، چک باکس-ng و ارائه دهندگان به عنوان یک پیچیدگی اضافی، کتابخانه باید فراخوانی شود
از کد python3 و کد python2.

توجه:
ارتباط بین checkbox-ng و plainbox دو جهته است. Plainbox ارائه می دهد
برخی از رابط های پایه و نقاط توسعه. همه آنها از طریق جعبه ساده در معرض دید قرار می گیرند
(با استفاده از API های رایج) اما برخی از آنها در واقع در checkbox-ng پیاده سازی شده اند.

هشدار:
همه APIهای داخلی نیمه ناپایدار هستند. DBus API در عمل پایدارتر است اما باید
قابل اعتماد نباشد پروژه ها تشویق می شوند در lp:checkbox که در آن API ادغام شوند
انتقال ها را می توان با ظرافت انجام داد. تنها API پایدار فرمت فایل است
مشخصات (تعریف شغل و نور سفید). مشخصات لانچر خواهد بود
در نسخه بعدی تثبیت شد.

جزء توضیحات
┌─────────────────────────┬─────────────────────── ──────────────────-
│پروژه │ مسئول │ نوع │
├─────────────────────────┼─────────────────────── ──────────────────┼───
│چک باکس نسل بعدی │ │ برنامه │
│ (GUI) │ · C++/QML │ │
│ │ رابط کاربری │ │
│ │ │ │
│ │ · گرافیکی │ │
│ │ پرتاب کننده برای │ │
│ │ ارائه دهندگان، به عنوان مثال │ │
│ │ checkbox-certification-client │ │
├─────────────────────────┼─────────────────────── ──────────────────┼───
│چک باکس نسل بعدی │ │ برنامه │
│ (CLI) │ · خط فرمان پایتون │ │
│ │ رابط │ │
│ │ │ │
│ │ · رابط کاربری متنی │ │
│ │ │ │
│ │ · فرمان تست SRU │ │
│ │ │ │
│ │ · API های گواهی اضافی │ │
│ │ │ │
│ │ · ارسال داده ها به Launchpad │ │
│ │ │ │
│ │ · ارسال داده ها به HEXR │ │
│ │ │ │
│ │ · سرویس DBus مورد نیاز │ │
│ │ رابط کاربری گرافیکی │ │
└─────────────────────────┴─────────────────────── ──────────────────┴

│گواهینامه مشتری │ │ ارائه دهنده │
│ارائه دهنده │ · گواهینامه-کارفرمای متعارف
│ │ قابل اجرا │ │
│ │ │ │
│ │ · گواهی مشتری │ │
│ │ لیست های سفید │ │
├─────────────────────────┼─────────────────────── ──────────────────┼───
│گواهی سرور │ │ ارائه دهنده │
│ ارائه دهنده │ · گواهی سرور │ │
│ │ لیست های سفید │ │
│ │ │ │
│ │ · لیست سفید سرور اضافی │ │
├─────────────────────────┼─────────────────────── ──────────────────┼───
│ سرور سیستم روی تراشه │ │ ارائه دهنده │
│ ارائه دهنده گواهی │ · صدور گواهینامه سرور SoC │ │
│ │ لیست های سفید │ │
├─────────────────────────┼─────────────────────── ──────────────────┼───
│ ارائه دهنده چک باکس │ │ ارائه دهنده │
│ │ · تقریباً همه تعاریف شغل │ │
│ │ │ │
│ │ · اکثر "اسکریپت های" سفارشی │ │
│ │ │ │
│ │ · لیست سفید پیش فرض و SRU │ │
├─────────────────────────┼─────────────────────── ──────────────────┼───
│ تامین کننده منابع │ │ ارائه دهنده │
│ │ · تقریباً تمام مشاغل منابع │ │
│ │ │ │
│ │ · تقریبا تمام منابع "اسکریپت" │ │
├─────────────────────────┼─────────────────────── ──────────────────┼───
│پشتیبانی از جعبه چک │ │ کتابخانه │
│ │ · کد پشتیبانی برای │ │ های مختلف
│ │ ارائه دهندگان │ │
│ │ │ │
│ │ · تجزیه کننده برای بسیاری از قالب های متنی │ │
├─────────────────────────┼─────────────────────── ──────────────────┼───
│PlainBox │ │ کتابخانه و توسعه │
│ │ · تقریبا تمام منطق اصلی │ جعبه ابزار │
│ │ │ │
│ │ · RFC822 (تعریف شغل) │ │
│ │ تجزیه کننده │ │
│ │ │ │
│ │ · مدیریت پیکربندی │ │
│ │ │ │
│ │ · جلسه تست │ │
│ │ (تعلیق/رزومه) │ │
│ │ │ │
│ │ · دونده شغلی │ │
│ │ │ │
│ │ · پرتاب کننده مورد اعتماد │ │
│ │ │ │
│ │ · حل کننده وابستگی │ │
│ │ │ │
│ │ · مدیریت خط فرمان │ │
│ │ │ │
│ │ · XML، HTML و XSLX │ │
│ │ صادر کنندگان │ │
│ │ │ │
│ │ · و بیشتر... │ │
│ │ │ │
│ │ · جعبه ابزار توسعه ارائه دهنده │ │
│ │ │ │
│ │ · 'ارائه دهنده شروع جعبه ساده' │ │
│ │ │ │
│ │ · اجرای 'manage.py' │ │
└─────────────────────────┴─────────────────────── ──────────────────┴

│چک باکس قدیمی (بدون │ │ برنامه یکپارچه │
│ طولانی تر نگهداری می شود) │ · برنامه های کاربردی │ کتابخانه و داده ها │
│ │ │ │
│ │ · Qt4 GUI │ │
│ │ │ │
│ │ · Gtk2 GUI │ │
│ │ │ │
│ │ · Urwid (متن) رابط کاربری گرافیکی │ │
│ │ │ │
│ │ · هسته │ │
│ │ │ │
│ │ · افزونه و رویداد / پیام │ │
│ │ موتور │ │
│ │ │ │
│ │ · تقریباً هر ویژگی │ │
│ │ یک پلاگین اصلی را پیاده سازی کرد │ │
│ │ │ │
│ │ · داده │ │
│ │ │ │
│ │ · مشاغل و لیست های سفید │ │
└─────────────────────────┴─────────────────────── ──────────────────┴

تغییر دهید

توجه:
این تغییرات فقط شامل خلاصه ای از تغییرات است. برای حسابداری دقیق تر
تاریخچه توسعه لطفاً تاریخچه منبع را مستقیماً بررسی کنید.

CheckboxNG 0.23 (منتشر نشده)
· رفع اشکال: https://launchpad.net/checkbox-ng/+milestone/0.23

CheckboxNG 0.22
· رفع اشکال: https://launchpad.net/checkbox-ng/+milestone/0.22

CheckboxNG 0.3
· رفع اشکال: https://launchpad.net/checkbox-ng/+milestone/0.3

CheckboxNG 0.2
· رفع اشکال: https://launchpad.net/checkbox-ng/+milestone/0.2

CheckboxNG 0.1
· انتشار اولیه

· پشتیبانی از نمایش پیکربندی

· پشتیبانی از اجرای تست های SRU (تست رگرسیون خودکار)

تست اسکریپت ها

تست "اسکریپت" برنامه های کوچکی هستند که برای کمک به اجرای تست ها استفاده می شوند.

روشنایی_تست
این اسکریپت تست روشنایی نور پس زمینه سیستم را می توان با استفاده از
رابط های هسته در /sys/class/backlight. ممکن است بیش از یک رابط برای انتخاب وجود داشته باشد
از، بنابراین رابط صحیح برای استفاده با استفاده از اکتشافی تجویز شده در انتخاب می شود
https://www.kernel.org/doc/Documentation/ABI/stable/sysfs-class-backlight. روشنایی
با به روز رسانی فایل روشنایی رابط و actual_brightness دستکاری می شود
فایل بررسی می شود تا ببیند آیا مقدار به روشنایی انتخاب شده تغییر یافته است یا خیر.

پرونده ها پیکربندی

نمایه‌های اجرایی یا راه‌اندازها، امکان تعیین مجموعه‌ای از پیکربندی از پیش تعریف‌شده را می‌دهند
گزینه هایی که امکان سفارشی سازی صفحه خوش آمدگویی، لیست های سفید نمایش داده شده و همچنین
ذخیره نتایج به صورت محلی یا ارسال فایل ارسالی به Launchpad یا Certification
پایگاه داده/HEXR و همچنین برخی پارامترهای دیگر.

تنظیمات نمایه بخشی از یک اسکریپت راه‌انداز است و از checkbox-gui یا استفاده می‌کند
checkbox-launcher (در حالت متنی/CLI) به عنوان یک shebang برای تفسیر کلید/مقادیر.

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

نحو
از آنجایی که checkbox-gui یک برنامه Qt است، تنظیمات باید از قوانین سبک INI پیروی کنند
تنظیمات Q <http://qt-project.org/doc/qt-5/QSettings.html> کلاس

مقادیر چند خطی پشتیبانی می‌شوند اما باید در گیومه‌های دوتایی و خطوط اضافی محصور شوند
باید با یک فاصله شروع شود، به عنوان مثال:

[دسته بندی]
کلید = "سلام
دنیا"

· از QML:

settings.value("category/key", i18n.tr("default_value"))

· از C++:

settings->value("category/key"، app.tr("default_value"))

برعکس، لانچرهای مخصوص پرتاب کننده چک باکس باید دنبال شوند پــایتــون ConfigParser
<https://docs.python.org/3/library/configparser.html#supported-ini-file-structure> نحو.

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

پشتیبانی تنظیمات
خوش آمدید/عنوان
عنوان برنامه QML و هدر صفحه خوش آمدگویی. پیش فرض به سیستم تست.

خوش آمدید / پیامک
پیام خوش آمدگویی برای نمایش در صفحه اول (checkbox-gui از متن غنی پشتیبانی می کند
اجازه نشانه گذاری به سبک HTML). پیش فرض به خوش آمدی به سیستم آزمایش کردن. [...]

مجموعه/فیلتر_لیست سفید
عبارت منظم برای مطابقت با زیر مجموعه ای از نام فایل های لیست سفید. در چک باکس-gui آن
پیش فرض به .*. برای checkbox-launcher هیچ پیش فرض و باید تعریف شود.

suite/whitelist_selection
الگویی که لیست های سفید باید مطابقت داشته باشند تا از قبل انتخاب شوند. عبارت منظم پایتون
پیش فرض ندارد و باید تعریف شود. (فقط CLI)

suite/skip_whitelist_selection
اگر روی true تنظیم شود، کاربر انتخاب لیست سفید را دریافت نخواهد کرد. فقط از پیش انتخاب شده
موارد (نگاه کنید به whitelist_selection) انتخاب خواهند شد. (فقط CLI).

suite/skip_test_selection
اگر روی true تنظیم شود، کاربر مجاز به لغو انتخاب تست‌ها قبل از اجرا: همه تست‌ها نخواهد بود
در لیست سفید انتخاب شده اجرا خواهد شد. (فقط CLI)

ارسال / پیام
متن سرصفحه پاپ آپ ارسال، پس از ارسال به کاربر نشان داده می شود
تکمیل شد. (فقط رابط کاربری گرافیکی)

ارسال/نوع_ورودی
برای وارد کردن شناسه امن یا آدرس LP (پیش‌فرض) یک فیلد ورودی متن را نشان دهید. به
فقط نتایج را روی دیسک ذخیره کنید، باید از آن استفاده کنید هیچ ارزش. برای اعتبارسنجی با استفاده از regex،
باید regex. (فقط رابط کاربری گرافیکی)

ارسال/رجکس
عبارت منظم برای اعتبارسنجی ورودی در قسمت ارسال (به عنوان مثال ایمیل، safe_id)
اگر input_type regex باشد. (فقط رابط کاربری گرافیکی). RegExpValidator، پیش فرض .*

Submission/input_placeholder
متن موقت برای قرار دادن در قسمت ورودی که برای راهنمایی کاربر استفاده می شود. پرتاب ایمیل
نشانی: (پیش فرض) یا امن ID (15 or 18 شخصیت ها). (فقط رابط کاربری گرافیکی)

ارسال/secure_id
امنیت_id از قبل برای پر کردن فیلد متنی پیکربندی شده است.

ارسال/ok_btn_text
برچسب دکمه "ارسال". ارسال نتایج (پیش فرض) یا ذخیره نتایج. (GUI
تنها)

ارسال/لغو_اخطار
به کاربر نشان دهید که آیا می‌خواهد بدون ذخیره گزارش خارج شود. شما در مورد
بدون ذخیره کردن گزارش نتایج، از این اجرای آزمایشی خارج شوید. آیا می خواهید ذخیره کنید
گزارش؟ (فقط رابط کاربری گرافیکی)

Submission/Submit_to_hexr
بولی، یک هدر اضافی اضافه کنید تا نتایج به HEXR نیز ارسال شود (با
حمل و نقل گواهی)

صادرکننده/xml_export_path
مکان ذخیره فایل ارسالی XML، اگر روی یک رشته خالی تنظیم شود، a باز می شود
گفتگوی ذخیره فایل پیش فرض: /tmp/submission.xml (فقط رابط کاربری گرافیکی)

حمل و نقل/ارسال_به
نقطه پایانی حمل و نقل پیش فرض به . از ارسال به LP (پیش‌فرض،
ارزش پرتاب), گواهی، یا محلی (ذخیره در دیسک)

حمل و نقل/submit_url
URL برای ارسال نتایج به. این اجازه می دهد تا برای مثال در وب سایت های مختلف آپلود کنید
می تواند مستقیماً در hexr یا در سایت های مرحله آپلود شود. فقط با
گواهی ارسال_به ارزش.

transport/config_filename
نام یک فایل پیکربندی سفارشی برای بارگیری. فایل های پیکربندی عمدتا برای تعریف استفاده می شوند
متغیرهای محیطی. (فقط CLI)

transport/dont_suppress_output
در صورت تنظیم، منابع، مشاغل محلی و پیوست‌ها به صفحه نمایش داده می‌شوند
متن زیادی تولید می کند و عمدتاً برای اشکال زدایی است. (فقط CLI)

چک باکس/صفحه اصلی پرتاب کننده ها آموزش

این سند توضیح می دهد که چرا پرتابگرها ضروری هستند، چه چیزی می توانید به دست آورید
با آنها، و چندین مثال را برای توصیف بهتر قابلیت های آنها مرور می کند. برای یک
مرجع دقیقی که در آن تنظیمات توسط راه‌اندازها پشتیبانی می‌شوند و نحو خاصی برای آن
فایل های لانچر، نگاه کنید /پروفایل.

میراث چک باکس رفتار کنترل
در گذشته، رفتار Checkbox توسط سه مکانیسم کنترل می شد.

ابتدا، عملکردهای چک باکس را می توان با افزودن افزونه ها افزایش داد. به عنوان مثال
قابلیت ارسال به وب سایت صدور گواهینامه توسط بسته چک باکس-گواهینامه اضافه شد
با استفاده از یک افزونه پلاگین‌هایی که توسط checkbox-certification ارائه می‌شوند و رفتار جدیدی را اضافه می‌کنند
چک باکس به پایه عبارت بودند از:

/usr/share/checkbox-certification/plugins/certify_message.py
/usr/share/checkbox-certification/plugins/submission_info.py
/usr/share/checkbox-certification/plugins/backup.py
/usr/share/checkbox-certification/plugins/certify_prompt.py
/usr/share/checkbox-certification/plugins/certify_report.py
/usr/share/checkbox-certification/plugins/certify_schemas.py

اینها راهی را اضافه کردند که کاربر را برای ارسال داده های خاص، تولید xml، درخواست می کند
گزارش و سایر عملکردها

در مرحله بعد، رفتار پلاگین ها را می توان با استفاده از پیکربندی پیکربندی یا کنترل کرد
فایل هایی که "آبشاری" هستند. یک فایل پیکربندی می‌تواند شامل سایرین باشد و آن‌ها به نوبه خود می‌توانند
دیگران را نیز شامل شود.

این نمونه ای از فایل پیکربندی اصلی project-qt.ini خاص پروژه است. این اولین است
زمانی که کلاینت خاص پروژه راه اندازی می شود، فایل خوانده می شود. برخی از تنظیمات به اختصار:

[پیش فرض]
شامل = %(checkbox_oem_share)s/configs/checkbox-project-base-qt.ini %(checkbox_project_share)s/configs/checkbox-project-base.ini

[checkbox/plugins/environment_info]
مخازن = deb http://.*\(بایگانی\|امنیت\).ubuntu.com/ubuntu دقیق-security
روتر = چندگانه
server_iperf = 10.20.30.40
sources_list = /etc/apt/sources.list بیفزاید
wpa_n_psk = رمز عبور
wpa_n_ssid = نقطه دسترسی

[checkbox/plugins/user_interface]
عنوان = پروژه من تست سیستم

به خط شامل توجه کنید، این به آن دستور می دهد تا فایل پیکربندی را برای آن بارگذاری کند
checkbox-project-base-qt و checkbox-project-base. Checkbox-project-base-qt بارگیری می شود
تنظیمات برای چک باکس گواهی و چک باکس-پروژه. تنظیمات به صورت آبشاری هستند
گزینه های پیکربندی نزدیک به بالا، گزینه های نزدیک به پایین را لغو می کنند.

در نهایت، "باینری" مورد استفاده برای فراخوانی چک باکس یک اسکریپت پوسته است که تعیین می کند کجا باید پیدا شود
چک باکس چیزهایی که باید اجرا شود: می توانید یک فهرست اشتراک گذاری، یک داده خاص را تعریف کنید
دایرکتوری، به یک فایل پیکربندی اشاره کنید و برخی از متغیرهای محیطی را تعریف کنید
ممکن است در طول آزمایش نیاز باشد. در اینجا یک مثال برای checkbox-project-qt آورده شده است:

#!/ bin / bash
صادر کردن CHECKBOX_DATA=${CHECKBOX_DATA:-~/.چک باکس}
صادر کردن CHECKBOX_SHARE=${CHECKBOX_SHARE:-/usr/share/checkbox}
صادر کردن CHECKBOX_OPTIONS=${CHECKBOX_OPTIONS:---log-level=debug --log=$CHECKBOX_DATA/checkbox-project.log}
صادر کردن CHECKBOX_CERTIFICATION_SHARE=${CHECKBOX_CERTIFICATION_SHARE:-/usr/share/checkbox-certification}
صادر کردن CHECKBOX_OEM_SHARE=${CHECKBOX_PROJECT_BASE_SHARE:-/usr/share/checkbox-project-base}
صادر کردن CHECKBOX_PROJECT_SHARE=${CHECKBOX_PROJECT_SHARE:-/usr/share/checkbox-project}

# راحتی برای تعریف دایرکتوری PYTHONPATH.
if [ "$CHECKBOX_SHARE" != "/usr/share/checkbox" ]; سپس
صادرات PYTHONPATH="$CHECKBOX_SHARE:$PYTHONPATH"
fi

python3 $CHECKBOX_SHARE/اجرای "$@" $CHECKBOX_PROJECT_SHARE/configs/$(نام پایه $0).ini

در اینجا می بینید که برخی از مکان ها را تعریف می کند و بخش مهم آن آخرین python3 است
خط، جایی که فایل پیکربندی .ini مورد نیاز را که قبلا دیدیم را پیدا کرده و از آن استفاده می کند.

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

جدید جعبه ساده رفتار کنترل
بر خلاف چک باکس، هسته plainbox یکپارچه است و هیچ مفهومی از پلاگین ندارد. این
درک و کار با آن را آسان تر می کند. هسته Plainbox دارای پیاده سازی برای همه است
توابع موجود در بسته های چک باکس قدیمی، بنابراین برای استفاده از ویژگی ها نیازی به افزودن نیست
مانند ارائه به گواهی یا تولید گزارش.

همانطور که مشاهده می شود آنچه را که ما plainbox می نامیم کتابخانه ای است که تمام عملکردها را پیاده سازی می کند
اینجا کلیک نمایید.

Plainbox ابزارهایی را برای کمک به توسعه دهندگان آزمایشی در نوشتن و بسته بندی تست ها ارائه می دهد. اینها هستند
ارائه شده در "ارائه دهندگان"، که نهادهایی هستند که برای محصور کردن توضیحات تست طراحی شده اند،
اسکریپت های سفارشی برای آزمایش، لیست های سفید و داده های مختلف. آنها طوری طراحی شده بودند که اجازه دهند
تیم ها تست های سفارشی خود را بدون نگرانی زیاد بنویسند و تحویل دهند
کد اصلی جعبه ساده

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

با این حال، زمانی که واقعاً از این آزمایش‌ها برای تأیید یک سیستم واقعی استفاده می‌کنیم، می‌خواستیم ارائه دهیم
چیزی ساده تر و نزدیک تر به تجربه کاربری چک باکس. ما دو مشتری ایجاد کردیم،
checkbox-gui و checkbox-cli که برخی رفتارهای کدگذاری شده داشتند و ما نیز شروع کردیم
ایجاد مشتریان دیگری که بر اساس اینها بودند اما هدف خاصی داشتند. برای مثال،
ما یک نسخه چک باکس برای تست SRU، نسخه دیگری برای گواهی سرور و غیره داشتیم.

اما بعد متوجه شدیم که بسیاری از کدها تکراری بوده و رفتارها مشترک هستند
به جز چند تغییر بنابراین ما به مفهوم "لانچرها" رسیدیم که عبارتند از
تا حدودی شبیه به فایل های پیکربندی چک باکس و پرتاب کننده های اسکریپت پوسته است.

ایده این است که checkbox-gui و checkbox-cli رفتارهای بسیار ابتدایی دارند، زیرا آنها رفتار می کنند
کلاینت هایی هستند که به طور پیش فرض با اوبونتو ارسال می شوند. آنها می توانند تمام موارد موجود را نشان دهند
لیست سفید، یک پیام خوش آمدگویی از پیش تعریف شده را نشان می دهد و در پایان به کاربر اجازه می دهد آن را ببیند
html را گزارش دهید و با استفاده از آدرس ایمیل آنها، مشابه نسخه، آن را به لانپ پد ارسال کنید
چک باکسی که با اوبونتو ارسال شده است.

به جای استفاده از سوئیچ های پیچیده خط فرمان، لانچرها به شما اجازه می دهند برخی از آنها را پیکربندی کنید
رفتارهای اختیاری برای سفارشی کردن تجربه آزمایشی شما. یک راه‌انداز شامل تنظیمات و
شبیه اسکریپت پوسته است، اما مفسر یا checkbox-gui یا خواهد بود
checkbox-launcher.

در اینجا چند نمونه از کارهایی که می توان با لانچرها انجام داد آورده شده است.

در کمال تعجب، checkbox-cli خود یک راه‌انداز است:

#!/usr/bin/env checkbox-launcher
[خوش آمدی]
text = به تست سیستم خوش آمدید!
چک باکس تست هایی را برای تایید درست کارکرد سیستم شما ارائه می دهد.
پس از اتمام اجرای آزمون ها، می توانید گزارش خلاصه ای را مشاهده کنید
سیستم شما
هشدار: برخی از آزمایش‌ها می‌توانند باعث یخ زدن یا تبدیل شدن سیستم شما شوند
بی پاسخ لطفاً تمام کارهای خود را ذخیره کنید و سایر موارد در حال اجرا را ببندید
برنامه های کاربردی قبل از شروع فرآیند تست.

[بعد از]
whitelist_filter = ^default$
whitelist_selection = ^default$
skip_whitelist_selection = درست است

[حمل و نقل]
submit_to = لانچ پد

در اینجا می توانید ببینید که ما چند گزینه را سفارشی می کنیم: پیام خوش آمدگویی را به صورت خودکار نشان می دهد
لیست سفید پیش‌فرض را انتخاب می‌کند و پس از اتمام به لان‌پد ارسال می‌شود.

نمونه لانچر گرافیکی canonical-certification-client است.

#!/usr/bin/checkbox-gui

[خوش آمدی]
عنوان = "گواهینامه سیستم"
متن = " به گواهینامه سیستم خوش آمدید! این نرم افزار خواهد شد
اطلاعات را از سیستم خود جمع آوری کنید سپس از شما تست های دستی خواسته می شود تا
تایید کنید که سیستم به درستی کار می کند. در نهایت از شما خواسته می شود
شناسه امن رایانه برای ارسال اطلاعات به گواهینامه
پایگاه داده برای یادگیری نحوه ایجاد یا مکان یابی Secure ID،
لطفا اینجا را ببینید: certification.canonical.com "

[بعد از]
whitelist_filter = "^client-(cert|selftest).*"

[ارسال]
input_type = "regex"
input_placeholder = "شناسه امن (15 یا 18 کاراکتر)"
ok_btn_text = "ارسال نتایج"
submit_to_hexr = "درست"

[صادر کننده]
xml_export_path = "/tmp/submission.xml"

[حمل و نقل]
submit_to = "گواهینامه"

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

یک راه‌انداز حالت متنی بسیار ساده، مجموعه canonical-hw است که فقط پایه را اجرا می‌کند
اطلاعات سخت افزاری را آزمایش می کند و آنها را در پایگاه داده سخت افزاری آپلود می کند:

[خوش آمدی]
عنوان = جمع آوری اطلاعات سخت افزاری
متن = جمع آوری اطلاعات سخت افزاری. ممکن است از شما خواسته شود رمز عبور خود را وارد کنید.
این فرآیند تقریباً 30 ثانیه طول می کشد و به شما ارائه می شود
با یک URL که از طریق آن می توانید سخت افزار خود را تأیید و ثبت کنید
ارسال.

[بعد از]
whitelist_filter = ^hwsubmit$
whitelist_selection = ^hwsubmit$
skip_whitelist_selection = درست است
skip_test_selection = درست است

[ارسال]
# شناسه امن جعلی تضمین می کند که ما آن را نخواهیم
# همیشه می توان آن را در فایل .conf لغو کرد.
safe_id = 000

[حمل و نقل]
ارسال_به = گواهینامه
submit_url = https://hardware-server.example.com/

در نهایت، مجموعه آزمایشی-درایور متعارف هم یک راه‌انداز حالت گرافیکی و هم متنی را ارائه می‌کند.
که از نظر عملکردی معادل هستند:

#!/usr/bin/checkbox-gui

[خوش آمدی]
عنوان = "مجموعه تست راننده متعارف"
متن = " به مجموعه تست راننده Canonical خوش آمدید.

این برنامه شامل تست های خودکار و دستی است که به شما در کشف کمک می کند
مشکلاتی که هنگام اجرای درایورهای دستگاه شما در اوبونتو ایجاد می شود.

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

زمان اجرا برای تست ها با توجه به تست هایی که تصمیم می گیرید تعیین می شود
اجرا کردن. کاربر این فرصت را خواهد داشت که اجرای آزمایشی را سفارشی کند
راننده و مقدار زمان در دسترس برای آزمایش را در نظر بگیرید.

برای شروع، به سادگی روی دکمه Continue در زیر کلیک کنید و روی صفحه را دنبال کنید
دستورالعمل ها. "

[بعد از]
whitelist_filter = "^ihv-.*"

[ارسال]
ok_btn_text = "ذخیره نتایج"
input_type = "هیچ"

[صادر کننده]
xml_export_path = ""

[حمل و نقل]
submit_to = "محلی"

حالت متن:

#!/usr/bin/env checkbox-launcher
[خوش آمدی]
text = به مجموعه تست راننده Canonical خوش آمدید
این برنامه شامل تست های خودکار و دستی است که به شما در کشف کمک می کند
مشکلاتی که هنگام اجرای درایورهای دستگاه شما در اوبونتو ایجاد می شود.
این نرم افزار کاربر را از طریق این تست ها در یک قدم می گذارد
سفارش از پیش تعیین شده و به طور خودکار هر دو اطلاعات سیستم را جمع آوری می کند
و همچنین نتایج آزمایش همچنین در صورت دستی از کاربر درخواست می‌کند که ورودی را وارد کند
تست مورد نیاز است.
زمان اجرا برای تست ها با توجه به تست هایی که تصمیم می گیرید تعیین می شود
اجرا کردن. کاربر این فرصت را خواهد داشت که اجرای آزمایشی را سفارشی کند
راننده و مقدار زمان در دسترس برای آزمایش را در نظر بگیرید.
برای شروع، به سادگی روی دکمه Continue در زیر کلیک کنید و روی صفحه را دنبال کنید
دستورالعمل.

[بعد از]
# لیست(های) سفید در صفحه انتخاب مجموعه نمایش داده می شود
whitelist_filter = ^ihv-.*
# انتخاب_لیست_سفید اجباری است، بنابراین آن را روی یک مقدار جعلی تنظیم می کنیم
# هیچ لیست سفیدی از پیش انتخاب نشده است.
whitelist_selection = جعلی

چک باکس رهایی روند

این صفحه مراحل لازم برای انتشار نسخه‌های Checkbox و Checkbox را توضیح می‌دهد
صدور گواهینامه به PPA پایدار متعلق به تیم صدور گواهینامه سخت افزار، به طور منظم
اساس در سرتاسر این سند، عبارت "Checkbox" به عنوان یک اصطلاح جامع برای پوشش استفاده می شود
همه نسخه‌های Checkbox متعلق به تیم صدور گواهینامه سخت‌افزار، در حال حاضر Checkbox هستند
خود و پسوندهای Checkbox Certification.

بررسی اجمالی
در حال حاضر این فرآیند به صورت دو هفته‌ای اجرا می‌شود و هر بار چک باکس جدید منتشر می‌شود
دو هفته. این ده روز کاری و وظایف انجام شده در هر روز یا گروهی را شامل می شود
روز در زیر شرح داده شده است:

· روزهای 1-4: زمان مجاز برای اعمال تغییرات جدید در صندوق عقب.

· روز 5: تغییرات از تنه ادغام شدند lp:checkbox و lp:checkbox-certification به
شاخه های انتشار مربوطه خود را. تغییرات برای هر دو هستند دست انداز در این نقطه و
ویرایش ها برچسب گذاری شده اند. در این مرحله ممکن است لازم باشد بسته 'fwts' را نیز کپی کنید.
از FWTS پایدار PPA <https://launchpad.net/~firmware-testing-team/+archive/ppa-
fwts-stable> به جعبه آزاد تست PPA <https://launchpad.net/~checkbox-
dev/+بایگانی/تست>.

· روزهای 6-9: آزمایش توسط مدیر انتشار برای صدور گواهینامه سخت افزار انجام می شود
تیم، و نماینده تیم CE QA (مشتری اصلی برای Checkbox در داخل
ابتدایی)

· روز نهم: جلسه انتشار بین مدیر انتشار برای سخت افزار برگزار می شود
تیم صدور گواهینامه و نماینده تیم CE QA. مشکلات احتمالی با
انتشار شناسایی شده و برنامه هایی برای رسیدگی به آنها انجام شده است.

· روز 10: نسخه آزمایش شده Checkbox در PPA پایدار کپی می شود.

پرتاب شعب
فرآیند انتشار به شاخه‌های جداگانه‌ای در لانچ‌پد نیاز دارد که حاوی یک نیمه منجمد باشد
نسخه کدی که در روز 5 فرآیند در صندوق عقب بود. این است که توسعه است
می تواند بدون به خطر انداختن ثبات نسخه ای که قرار است منتشر شود، روی صندوق عقب ادامه دهد
چک باکس. رابطه بین تمام شاخه های درگیر در فرآیند به شرح زیر است:

· lp:checkbox/release <- lp:checkbox

· lp:checkbox-certification/release <- lp:checkbox-certification

· lp:~checkbox-dev/checkbox/checkbox-packaging-release <-
lp:~checkbox-dev/checkbox/checkbox-packaging

حسابرسی نقطه عطف اشکالات
قبل از ایجاد نامزد انتشار، مدیر انتشار باید لیست اشکالات را بررسی کند
نقطه عطفی برای انتشار بعدی Checkbox. باید بازدید کنند چک باکس نقاط عطف
<https://launchpad.net/checkbox/+milestonesmilestones> و نقطه عطف تاریخ با
تاریخ انتشار

· برای اشکالاتی که روی در حال انجام با یک شاخه مرتبط تنظیم شده اند - با شاخه ارتباط برقرار کنید
مالک برای دیدن اینکه آیا ادغام می تواند قبل از مهلت تکمیل شود یا خیر.

· برای اشکالاتی که در هر وضعیت غیر بسته دیگری هستند (به جز رفع متعهد شد) - نقطه عطف مجدد
آنها را به نقطه عطف زیر رساند.

برش la آزاد
برای برش رهاسازی، باید تغییرات را از تنه در ریلیز ادغام کنیم
شعبه کنید، آنها را با یک پیام مناسب commit کنید و تغییرات لاگ را در ترانک آپدیت کنید تا
تغییرات آینده تحت نسخه صحیح است. برای هر ترکیبی از شاخه های نشان داده شده در بالا،
موارد زیر را انجام دهید (مثال استفاده می کند lp:checkbox و lp:checkbox/release):

bzr شاخه lp:checkbox/release checkbox-release
bzr شاخه lp:checkbox checkbox-trunk
cd checkbox-release
current_stable=`head -n1 $(find . -name 'changelog') | grep -oP '(?<=\().*(?=\))'
bzr ادغام lp:checkbox

در این مرحله اگر هیچ تغییری صورت نگیرد (غیر از یک به debian/changelog) در آن ادغام می شویم سپس انجام می دهیم
انتشار بسته مورد نظر را انجام ندهید. در عمل اغلب این اتفاق می افتد با
چک باکس-گواهینامه اما هرگز با چک باکس:

bzr commit -m "ادغام شده در تغییرات از rev$(bzr revno -r tag:$current_stable lp:checkbox) به rev$(bzr revno lp:checkbox) از lp:checkbox"
bzr push lp:checkbox/release
سی دی `یافتن . -name 'debian'; سی دی ..
تگ bzr `head -n1 debian/changelog | grep -oP '(?<=\().*(?=\))'
dch -r (ذخیره تغییرات اصلاح شده)
dch -i -U "تغییر گزارش افزایش یافته"
debcommit
bzr push lp:checkbox

آخرین مرحله در این فرآیند، ساخت بسته‌های موجود در آن است
ppa:checkbox-dev/testing PPA. برای این کار باید به صفحات دستور غذا برویم
چک باکس و / یا چک باکس-گواهینامه شاخه ها را آزاد کنید

· چک باکس تست دستور العمل <https://code.launchpad.net/~checkbox-dev/+recipe/checkbox-
تست>

· checkbox-certification-testing دستور العمل <https://code.launchpad.net/~checkbox-
dev/+recipe/checkbox-certification-testing>

La ساختن اکنون گزینه باید در صفحه موجود باشد. برای شروع ساخت، روی آن کلیک کنید.

کپی برداری سفت افزار تست سوئیت به la تست PPA
ابزار Firmware Test Suite یک ابزار آزمایشی برای سیستم عامل سیستم است که به طور طبیعی بسیار سنگین است
توسط Checkbox استفاده شده است. برای اطمینان از آخرین نسخه که حاوی اصلاحات و جدید است
تست‌ها/ویژگی‌های مورد نیاز Checkbox موجود است و همچنین هیچ چیزی را خراب نمی‌کند
چک باکس، باید آن را در کنار چک باکس آزاد کنیم. پس از برش رهاسازی اگر
تیم تست Firmware اطلاع داده است که نسخه جدیدی در دسترس است و این نسخه
باید برای صدور گواهینامه استفاده شود، باید آن را در PPA تست کپی کنیم. برای انجام این کار ما
نیاز به رفتن به نسخه بسته دیدن of la سفت افزار تست سوئیت (پایدار) PPA
<https://launchpad.net/~firmware-testing-team/+archive/ppa-fwts-stable/+copy-packages> و
بسته‌های «fwts» را برای همه نسخه‌ها به Precise انتخاب کنید. ما باید تنظیم کنیم
«PPA مقصد» به‌عنوان «تست انتشار چک باکس [~checkbox-dev/testing]» و «کپی»
فیلد گزینه‌ها را به «کپی باینری‌های موجود» بزنید، سپس روی «کپی بسته‌ها» کلیک کنید. پس این مرحله
باید تکرار شود، اما قسمت "PPA مقصد" را روی "PPA for Checkbox Developers" تنظیم کنید
[~checkbox-dev/ppa]'.

بعدی آزاد of جعبه پست الکترونیک
به طوری که همه این فرصت را داشته باشند که هر آزمایشی را که لازم است به موقع انجام دهند
به این ترتیب، پس از تکمیل ساخت‌های PPA باید یک ایمیل به آدرس زیر ارسال شود
لیست های پستی:

· [ایمیل محافظت شده] <سخت افزار-گواهینامه-
[ایمیل محافظت شده]>

· [ایمیل محافظت شده] <[ایمیل محافظت شده]>

محتوا معمولا چیزی شبیه به این است:

موضوع: نسخه بعدی چک باکس (18/11/2013)

سلام،

نسخه بعدی Checkbox در دسترس است
https://code.launchpad.net/~checkbox-dev/+archive/testing PPA.
لطفا آن را به راحتی تست کنید. چک باکس بر اساس ویرایش 2484 است
گواهینامه lp:checkbox و Checkbox بر اساس ویرایش 586 است
lp:checkbox-certification.

با تشکر،

اگر یکی یا دیگری از Checkbox و Checkbox Certification به‌روزرسانی نشده باشد
نیازی به ذکر آن بسته نیست

تست la آزاد
اکنون که انتشار قطع شده است، آزمایش باید قبل از جلسه انتشار انجام شود.
از نظر تیم صدور گواهی، چیزی که باید آزمایش شود این است
checkbox-certification-client و checkbox-certification-server که مبنایی برای
CE QAs نسخه های خاص Checkbox OEM. سرور گواهی چک باکس در تست شده است
مشتری صدور گواهینامه حلقه CI باید به صورت دستی آزمایش شود.

آزاد نشست
پنج‌شنبه قبل از انتشار، جلسه‌ای بین یکی از نمایندگان برگزار می‌شود
تیم صدور گواهینامه و نماینده ای از تجاری مهندسی QA تیم این
همانطور که در این نشان داده شده است، جلسه در ساعت 7:30 UTC برگزار می شود تقویم دعوت
<https://www.google.com/calendar/hosted/canonical.com/event?action=TEMPLATE&tmeid=Y3QxcWVla3ViMTRvMXByOHZlOTFvc283Y2NfMjAxMzA4MjlUMDczMDAwWiBicmVuZGFuLmRvbmVnYW5AY2Fub25pY2FsLmNvbQ&tmsrc=brendan.donegan%40canonical.com>.
دستور جلسه در دعوت نامه گنجانده شده است.

انتشار la آزاد
برای انتشار نسخه، کافی است تعدادی بسته را از آن کپی کنیم جعبه
آزاد تست PPA <https://launchpad.net/~checkbox-dev/+archive/testing> به سخت افزار
گواهی عمومی PPA <https://launchpad.net/~hardware-certification/+archive/public>.
برای انجام این کار به نسخه بسته دیدن of la جعبه آزاد تست PPA
<https://launchpad.net/~checkbox-dev/+archive/testing/+copy-packages> و همه را انتخاب کنید
نسخه های لیست بسته های زیر: چک باکس، چک باکس-گواهینامه، fwts. درست کردن
مطمئن شوید که قسمت "PPA مقصد" روی "PPA عمومی برای صدور گواهینامه سخت افزار" تنظیم شده است
[~hardware-certification/public]" و فیلد "Copy options" روی "Copy" تنظیم شده است.
باینری های موجود، سپس روی «Copy Packages» کلیک کنید.

پس از انجام این کار باید یک ایمیل اعلامیه ارسال شود
[ایمیل محافظت شده] <[ایمیل محافظت شده]>.
الگویی برای اعلامیه در زیر آمده است:

سلام،

نسخه جدیدی از چک باکس در سخت افزار آپلود شده است
گواهی PPA عمومی
(https://launchpad.net/~hardware-certification/+archive/public). در
نسخه بر اساس نسخه 2294 lp:checkbox است

با تشکر،

لطفاً جدیدترین بخش تغییرات گزارش را به عنوان یادداشت های انتشار پیوست کنید

· ژن ایندکس

· modindex

· جستجو کردن

با استفاده از خدمات onworks.net از checkbox-cli آنلاین استفاده کنید