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

الركض و المشي مستقرة RELEASE قم اختبارات

يحتوي CheckboxNG على دعم خاص لتشغيل اختبارات تحديثات الإصدار المستقرة في ملف
طريقة. هذا يدير جميع الوظائف من القائمة البيضاء ويرسل النتائج إلى
موقع الشهادة.

لإجراء اختبارات SRU ، ستحتاج إلى معرفة ما يسمى بـ Secure ID للجهاز الذي أنت عليه
اختبارات. بمجرد أن تعرف أن كل ما عليك فعله هو الجري:

checkbox $ sru $ secure_id submit.xml

المتغير الثاني ، submit.xml ، هو اسم الملف الاحتياطي الذي تم إنشاؤه فقط
عندما يفشل إرسال البيانات إلى موقع الشهادة في العمل لأي سبب من الأسباب.

التبليغ بق

للإبلاغ عن الأخطاء في مشروع Checkbox ، ستحتاج إلى حساب Launchpad. قد تجد ملفات
تعليمات on كيف إلى خلق صورة واحدة؟ <https://help.launchpad.net/YourAccount/NewAccount>
مفيد. بمجرد أن يكون لديك حساب يمكنك تقرير البق <https://bugs.launchpad.net/checkbox-
مشروع / + filebug>.

في تلك الصفحة ، يمكنك تحديد المشروع الذي ترغب في تسجيل الخطأ فيه (نستخدم عددًا من
مشاريع لتنسيق الإصدارات ونحن نفضل أن يكون لدينا أخطاء مرتبطة بالملاءمة
جزء من خانة الاختيار). إذا كنت تعرف المشروع المناسب لاستخدامه ، فما عليك سوى استخدامه وإرسال ملف الخطأ. لو
أنت لا تعرف الأجزاء الداخلية لـ Checkbox كثيرًا أو لديك شك في وضعها على القاعدة
مشروع "Checkbox" (يمكنك استخدام ملفات مباشرة الصفحة
<https://bugs.launchpad.net/checkbox/+filebug>.) يقوم عضو من فريق التطوير
مراجعة الخطأ الخاص بك وإعادة تعيينه إلى الموقع المناسب. رقم الخطأ لا
يتغير عندما يحدث ذلك.

ال صندوق التحقق كومة

Checkbox Stack عبارة عن مجموعة من المشاريع التي تشكل معًا اختبارًا كاملاً
وشهادة الحل. وهي تتألف من الأجزاء التالية (انظر الجدول أدناه للحصول على
تفاصيل إضافية). جميع المشاريع مرتبطة من انطلاق تنفيذ المشاريع رأس التجميع
<https://launchpad.net/checkbox-project>.

معمار رسم بياني
[صورة: مخطط معماري] [صورة]

يحتوي هذا الرسم البياني على تقدير تقريبي عالي المستوى لهيكل مربع الاختيار الحالي.
هناك ثلاث "ركائز" رئيسية. على اليسار لدينا النهاية منتج. هذه أدوات فعلية
التي يستخدمها المهندسون والشهادة. على اليمين لدينا تجربه بالعربي السوق. وهذا هو
سوق مفتوح لبائعي وموردي الاختبارات. الاختبارات ملفوفة في حاويات معروفة باسم
مقدمي. في المركز لدينا ثلاثة مكونات مشتركة. تلك تنفذ الجزء الأكبر من
إطار العمل وواجهات المستخدم لتنفيذ الاختبار. أخيرًا في الزاوية اليسرى السفلية هناك
هو جزء من خانة الاختيار (مكتبة) التي يتم مشاركتها مع HEXR لمهام معينة. HEXR هو ملف
تطبيق ويب خارج النطاق يستخدمه جزء من عملية التصديق. الأسهم تعني
التواصل مع شكل السهم يظهر من يدعو من.

كما ذكرنا سابقًا ، يوجد في العمود الأوسط ثلاثة مكونات رئيسية للكود المشترك
(مشتركة بين كل شخص يستخدم المنتجات النهائية التي تمت مناقشتها أدناه). الكود المشترك هو
يتألف من صندوق عادي ، مربع اختيار نانوغرام و checkbox-gui. عنصر المسؤوليات
تمت مناقشته بمزيد من التفصيل في الجدول أدناه. هنا يمكننا أن نرى أن checkbox-gui تستخدم DBus
تم الكشف عن واجهة برمجة التطبيقات بواسطة checkbox-ng ، والتي بدورها تستخدم دعم مربع الاختيار (مكتبة مساعدة
فصلها ، لذا شارك بعض التعليمات البرمجية مع HEXR) والصندوق العادي.

يوجد في العمود الموجود على الجانب الأيمن العديد من موفري الاختبارات. مشروع مربع الاختيار هو
إنتاج وصيانة عدد من المزودين (انظر الجدول أدناه) ولكن هذا متوقع
أن مستخدمي المصب لدينا سينتجون أيضًا مزودي الخدمة (خاصين بالعميل أو
مشروع). في النهاية ، قد يأتي بعض المزودين من جهات خارجية تتبنى
تنسيق.

أخيرًا في الزاوية اليسرى السفلية ، المكتبة المشتركة ، تحتوي هذه المكتبة على العديد من المحللين
من تنسيقات الملفات المختلفة وتنسيقات الإخراج. من الناحية الفنية ، هذه المكتبة تابعة لـ
HEXR ، checkbox-ng و من مقدمي. كتعقيد إضافي ، يجب استدعاء المكتبة
من كود python3 ورمز python2.

NOTE:
الاتصال بين checkbox-ng والصندوق العادي ثنائي الاتجاه. عروض Plainbox
بعض الواجهات الأساسية ونقاط الامتداد. يتم الكشف عن كل هؤلاء من خلال عادي
(باستخدام واجهات برمجة التطبيقات المشتركة) ولكن يتم تنفيذ بعض منها بالفعل في checkbox-ng.

تحذير:
جميع واجهات برمجة التطبيقات الداخلية شبه غير مستقرة. تعد DBus API أكثر استقرارًا من الناحية العملية ولكنها يجب أن تفعل ذلك
لا يمكن الاعتماد عليها. يتم تشجيع المشاريع على أن يتم دمجها في lp: checkbox حيث API
يمكن التعامل مع التحولات بأمان. واجهة برمجة التطبيقات الوحيدة المستقرة هي تنسيق الملف
المواصفات (تعريفات الوظائف والقوائم البيضاء). ستكون مواصفات المشغل
استقر في الإصدار القادم.

مكون أوصاف
┌─────────────────────────┬─────────────────────── ──────────────────┬──────────────────────────┐
"المشروع" المسؤول عن "النوع"
├─────────────────────────┼─────────────────────── ──────────────────┼──────────────────────────┤
│ مربع اختيار الجيل التالي │ │ التطبيق │
│ (واجهة المستخدم الرسومية) │ · لغة C ++ / QML │ │
│ │ واجهة المستخدم │ │
│ │ │ │
│ │ · الرسم البياني │ │
│ │ قاذفة لـ │ │
│ │ مقدمي مثل │ │
│ │ مربع الاختيار-شهادة العميل │ │
├─────────────────────────┼─────────────────────── ──────────────────┼──────────────────────────┤
│ مربع اختيار الجيل التالي │ │ التطبيق │
│ (CLI) │ · سطر أوامر بيثون │ │
│ │ واجهة │ │
│ │ │ │
│ واجهة مستخدم النص │ │
│ │ │ │
│ │ · أمر اختبار SRU │ │
│ │ │ │
│ │ · شهادات API إضافية │ │
│ │ │ │
│ │ · إرسال البيانات إلى Launchpad │ │
│ │ │ │
│ │ · إرسال البيانات إلى HEXR │ │
│ │ │ │
│ │ · خدمة DBus التي يحتاجها │ │
│ │ واجهة المستخدم الرسومية │ │
└─────────────────────────┴─────────────────────── ──────────────────┴──────────────────────────┘

│ شهادة العميل │ المزود │
│المقدم │ عميل الشهادة الكنسي │ │
│ │ قابل للتنفيذ │ │
│ │ │ │
│ │ · شهادة العميل │ │
│ │ القوائم البيضاء │ │
├─────────────────────────┼─────────────────────── ──────────────────┼──────────────────────────┤
│ شهادة الخادم │ المزود │
│المقدم │ شهادة الخادم │ │
│ │ القوائم البيضاء │ │
│ │ │ │
│ │ قوائم بيضاء إضافية للخادم │ │
├─────────────────────────┼─────────────────────── ──────────────────┼──────────────────────────┤
خادم نظام على رقاقة │ مزود │
│مقدم التصديق شهادة خادم SoC │ │
│ │ القوائم البيضاء │ │
├─────────────────────────┼─────────────────────── ──────────────────┼──────────────────────────┤
موفر مربع الاختيار │ │ المزود │
│ • تقريبا كل تعريفات الوظائف │ │
│ │ │ │
│ │ · معظم "البرامج النصية" المخصصة │ │
│ │ │ │
│ │ · القائمة البيضاء الافتراضية و SRU │ │
├─────────────────────────┼─────────────────────── ──────────────────┼──────────────────────────┤
"مزود الموارد" │ المزود │
│ │ · تقريبا جميع وظائف الموارد │ │
│ │ │ │
│ │ · تقريبا كل الموارد "البرامج النصية" │ │
├─────────────────────────┼─────────────────────── ──────────────────┼──────────────────────────┤
دعم مربع الاختيار │ │ مكتبة
│ │ · رمز الدعم لمختلف │
│ │ مقدمي │ │
│ │ │ │
│ │ موزعي للعديد من تنسيقات النص │
├─────────────────────────┼─────────────────────── ──────────────────┼──────────────────────────┤
│ PlainBox │ │ المكتبة والتطوير │
│ │ تقريبا كل المنطق الأساسي مجموعة الأدوات │
│ │ │ │
│ │ · RFC822 (تعريف الوظيفة) │ │
│ │ المحلل اللغوي │ │
│ │ │ │
│ │ · معالجة التكوين │ │
│ │ │ │
│ │ · جلسة اختبار │ │
│ │ (تعليق / استئناف) │ │
│ │ │ │
│ │ عداء وظيفة │ │
│ │ │ │
│ │ · قاذفة موثوقة │ │
│ │ │ │
│ │ · محلل التبعية │ │
│ │ │ │
│ • معالجة سطر الأوامر │ │
│ │ │ │
│ · XML و HTML و XSLX │ │
│ │ المصدرين │ │
│ │ │ │
│ │ و اكثر ... │ │
│ │ │ │
│ مجموعة أدوات تطوير الموفر │ │
│ │ │ │
│ │ · "موفر بدء التشغيل العادي" │ │
│ │ │ │
│ │ · تنفيذ "manager.py" │ │
└─────────────────────────┴─────────────────────── ──────────────────┴──────────────────────────┘

│ خانة اختيار تراثية (لا │ │ تطبيق متآلف │
صيانتها لفترة أطول) التطبيقات المكتبة والبيانات
│ │ │ │
│ │ · Qt4 GUI │
│ │ │ │
│ │ · Gtk2 واجهة المستخدم الرسومية │ │
│ │ │ │
│ │ · Urwid (نص) GUI │ │
│ │ │ │
│ │ · كور │ │
│ │ │ │
│ │ البرنامج المساعد والحدث / الرسالة │ │
│ │ المحرك │ │
│ │ │ │
│ · تقريبا كل ميزة │ │
│ │ نفذت مكوّنًا أساسيًا │ │
│ │ │ │
│ │ البيانات │ │
│ │ │ │
│ │ · الوظائف والقوائم البيضاء │ │
└─────────────────────────┴─────────────────────── ──────────────────┴──────────────────────────┘

التغيير

NOTE:
يحتوي سجل التغيير هذا فقط على ملخص للتغييرات. للحصول على محاسبة أكثر دقة
تاريخ التطوير يرجى فحص تاريخ المصدر مباشرة.

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 (اختبار الانحدار التلقائي)

الاختبار نصوص

اختبار "البرامج النصية" هي برامج صغيرة تستخدم للمساعدة في تنفيذ الاختبارات.

سطوع_اختبار
يختبر هذا البرنامج النصي سطوع الإضاءة الخلفية للأنظمة ويمكن تغييره باستخدام
واجهات kernel في / sys / class / backlight. قد يكون هناك أكثر من واجهة للاختيار من بينها
من ، لذلك يتم تحديد الواجهة الصحيحة لاستخدامها باستخدام الكشف عن مجريات الأمور الموصوفة في
https://www.kernel.org/doc/Documentation/ABI/stable/sysfs-class-backlight. السطوع
يتم التلاعب بها عن طريق تحديث ملف سطوع الواجهة والسطوع الفعلي
يتم فحص الملف لمعرفة ما إذا تم تعديل القيمة إلى السطوع المحدد.

مظهر CONFIGURATION

تسمح ملفات تعريف التنفيذ ، أو المشغلات ، بتحديد مجموعة محددة مسبقًا من التكوين
الخيارات التي تسمح بتخصيص شاشة الترحيب والقوائم البيضاء المعروضة وكذلك
حفظ النتائج محليًا أو إرسال ملف الإرسال إلى Launchpad أو إلى الشهادة
قاعدة البيانات / HEXR ، وكذلك بعض المعلمات الأخرى.

تعد إعدادات ملف التعريف جزءًا من برنامج التشغيل النصي وتستخدم إما checkbox-gui أو
checkbox-launcher (في وضع النص / CLI) باعتباره shebang لتفسير المفتاح / القيم.

يوفر هذا المستند مرجعًا عن وظائف المشغل وبناء الجملة. لفهم
التصميم والمفاهيم ونرى العديد من الأمثلة ، قد ترغب في قراءة البرنامج التعليمي حول كيفية
إنشاء قاذفات وعلاقتها مع تراث Checkbox.

بناء الجملة
نظرًا لأن checkbox-gui هو تطبيق Qt ، يجب أن تتبع الإعدادات قواعد نمط INI الخاصة بملف
إعدادات Q <http://qt-project.org/doc/qt-5/QSettings.html> فئة.

يتم دعم القيم متعددة الأسطر ولكن يجب تضمينها بين علامات اقتباس مزدوجة وأسطر إضافية
يجب أن يبدأ بمسافة واحدة ، على سبيل المثال:

[الفئة]
key = "مرحبًا
العالمية"

· من QML:

settings.value ("فئة / مفتاح"، i18n.tr ("default_value"))

· من C ++:

إعدادات-> قيمة ("فئة / مفتاح" ، app.tr ("default_value"))

على العكس من ذلك ، يجب أن تتبع المشغلات الخاصة بمربع الاختيار بايثون ConfigParser
<https://docs.python.org/3/library/configparser.html#supported-ini-file-structure> بناء الجملة.

أيضًا ، بعض الإعدادات تكون منطقية فقط لواجهة المستخدم الرسومية أو CLI ، وبالتالي لا يفهمها
الأخرى. هذه مذكورة أدناه.

مدعومة الإعدادات
ترحيب / العنوان
عنوان تطبيق QML ورأس شاشة الترحيب. افتراضات إلى System الاختبار.

ترحيب / نص
رسالة ترحيب ليتم عرضها على الشاشة الأولى (يدعم checkbox-gui النص المنسق
السماح بترميز نمط HTML). افتراضات إلى أهلا بك إلى System اختبارات. [...]

جناح / whitelist_filter
تعبير عادي لمطابقة مجموعة فرعية من أسماء ملفات القائمة البيضاء. على checkbox-gui ذلك
التخلف عن .*. بالنسبة إلى checkbox-launcher ، لا يوجد لديه ملف افتراضي و يجب يمكن تعريف.

جناح / اختيار_القائمة البيضاء
النمط الذي تحتاج القوائم البيضاء لمطابقته ليتم تحديده مسبقًا. التعبير النمطي لبايثون.
ليس لديها الافتراضي و يجب يمكن تعريف. (CLI فقط)

جناح / skip_whitelist_selection
إذا تم التعيين على "صواب" ، فلن يتلقى المستخدم خيار القائمة البيضاء. فقط المختار مسبقا
سيتم اختيار تلك (انظر whitelist_selection). (CLI فقط).

جناح / skip_test_selection
إذا تم التعيين على "صواب" ، فلن يُسمح للمستخدم بإلغاء تحديد الاختبارات قبل تشغيلها: جميع الاختبارات
في القائمة البيضاء المحددة سيتم تشغيلها. (CLI فقط)

التقديم / الرسالة
نص رأس رسالة التقديم المنبثقة ، يظهر للمستخدم بعد الإرسال
منجز. (واجهة المستخدم الرسومية فقط)

التقديم / نوع الإدخال
اعرض حقل إدخال النص لإدخال المعرّف الآمن أو عنوان LP (افتراضيًا). إلى
فقط احفظ النتائج على القرص ، يجب أن تستخدم امتداد لا شيء القيمة. للتحقق من صحة باستخدام regex ،
يجب أن تكون رجإكس. (واجهة المستخدم الرسومية فقط)

التقديم / regex
التعبير العادي للتحقق من صحة الإدخال في حقل الإرسال (مثل البريد الإلكتروني ، معرف_المأمون)
إذا كان input_type هو regex. (واجهة المستخدم الرسومية فقط). RegExpValidator ، افتراضي .*

التقديم / input_placeholder
نص مؤقت يتم وضعه في حقل الإدخال ، ويستخدم لإرشاد المستخدم. انطلاق البريد الإلكتروني
العنوان: (افتراضي) أو آمنة ID (15 or 18 الشخصيات). (واجهة المستخدم الرسومية فقط)

تقديم / معرّف آمن
تم تكوينه مسبقًا secure_id لملء حقل النص.

تقديم / ok_btn_text
تسمية الزر "إرسال". تقدم النتائج (افتراضي) أو حفظ النتائج. (واجهة المستخدم الرسومية
فقط)

تقديم / تحذير_إلغاء
أظهر للمستخدم ما إذا كان يريد الخروج دون حفظ التقرير. انت على وشك
للخروج من هذا التشغيل التجريبي دون حفظ تقرير النتائج الخاص بك. هل تريد حفظ ملف
أبلغ عن؟ (واجهة المستخدم الرسومية فقط)

تقديم / Submit_to_hexr
منطقي ، أضف رأسًا إضافيًا لإرسال النتائج أيضًا إلى HEXR (يعمل مع ملف
نقل الشهادة)

المصدر / xml_export_path
موقع حفظ ملف إرسال XML ، إذا تم تعيينه على سلسلة فارغة ، فسيتم فتح ملف
ملف حفظ الحوار. تقصير: /tmp/submission.xml (واجهة المستخدم الرسومية فقط)

نقل / إرسال إلى
نقطة نهاية النقل. افتراضات إلى . يدعم الإرسال إلى LP (الافتراضي ،
قيمنا منصة الإطلاق), شهادةالطرق أو محلي (حفظ على القرص)

نقل / submit_url
URL لإرسال النتائج إليه. هذا يسمح بالتحميل إلى مواقع مختلفة ، على سبيل المثال
يمكن تحميله مباشرة إلى hexr ، أو إلى مواقع التدريج. تستخدم فقط مع
شهادة إرسال إلى القيمة.

نقل / config_filename
اسم ملف التكوين المخصص للتحميل. تستخدم ملفات التكوين بشكل أساسي للتعريف
متغيرات البيئة. (CLI فقط)

نقل / dont_suppress_output
في حالة التعيين ، سيتم إخراج الموارد والوظائف المحلية والمرفقات إلى الشاشة ، وهذا
يولد الكثير من النص وهو مخصص بشكل أساسي لتصحيح الأخطاء. (CLI فقط)

CHECKBOX / PLAINBOX قاذفات TUTORIAL

يقدم هذا المستند شرحًا لسبب أهمية قاذفات البرامج وما يمكنك تحقيقه
معهم ، ويستعرض العديد من الأمثلة لوصف قدراتهم بشكل أفضل. ل
مرجع مفصل حول الإعدادات التي تدعمها المشغلات ، وبناء جملة محدد لـ
قاذفة ، انظر إلى /مظهر.

إرث مربع سلوك مراقبة
في الماضي ، كان سلوك Checkbox يخضع لثلاث آليات.

أولاً ، يمكن زيادة وظائف مربع الاختيار عن طريق إضافة المكونات الإضافية. على سبيل المثال ، ملف
تمت إضافة القدرة على الإرسال إلى موقع الويب الخاص بالشهادة من خلال حزمة شهادة مربع الاختيار
باستخدام البرنامج المساعد. الإضافات المضمنة في شهادة checkbox والتي تضيف سلوكًا جديدًا
لقاعدة مربع كانت:

/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
تقرير ، وغيرها من المهام.

بعد ذلك ، يمكن تكوين سلوك المكونات الإضافية أو التحكم فيها باستخدام التكوين
الملفات "المتتالية". يمكن أن يشتمل ملف التكوين على الآخرين ويمكن أن يقوم هؤلاء بدورهم
تشمل الآخرين.

هذا مثال على ملف التكوين الرئيسي لمشروع محدد qt.ini. إنه الأول
قراءة الملف عند بدء تشغيل العميل الخاص بالمشروع. بعض الإعدادات مختصرة:

[DEFAULT]
يتضمن =٪ (checkbox_oem_share) s / configs / checkbox-project-base-qt.ini٪ (checkbox_project_share) s / configs / checkbox-project-base.ini

[خانة اختيار / المكونات الإضافية / environment_info]
المستودعات = deb http: //.* \ (أرشيف \ | أمان \). ubuntu.com/ubuntu دقيق - الأمان
أجهزة التوجيه = متعددة
server_iperf = 10.20.30.40
مصادر_قائمة = / الخ / مناسب / sources.list
wpa_n_psk = كلمة المرور
wpa_n_ssid = نقطة الوصول

[مربع الاختيار / المكونات الإضافية / user_interface]
title = My Project System Testing

لاحظ سطر التضمين ، فهذا يوجهه لتحميل ملف التكوين لـ
checkbox-project-base-qt and checkbox-project-base. Checkbox-project-base-qt يقوم بتحميل ملف
تكوينات لشهادة checkbox و checkbox-project. الإعدادات متتالية لذا فإن ملف
تلغي خيارات التكوين بالقرب من الجزء العلوي تلك الموجودة بالقرب من الجزء السفلي.

أخيرًا ، "الثنائي" المستخدم لاستدعاء مربع الاختيار هو برنامج نصي shell يحدد مكان البحث
يحتاج مربع تحديد الأشياء إلى التشغيل: يمكنك تحديد دليل مشاركة ، بيانات محددة
الدليل ، أشر إلى ملف التكوين وحدد بعض متغيرات البيئة التي تريدها
قد تحتاج أثناء الاختبار. فيما يلي مثال على checkbox-project-qt:

#!/ بن / باش
تصدير CHECKBOX_DATA = $ {CHECKBOX_DATA: -~ /. مربع الاختيار}
تصدير CHECKBOX_SHARE = ​​$ {CHECKBOX_SHARE: - / usr / share / checkbox}
تصدير CHECKBOX_OPTIONS = $ {CHECKBOX_OPTIONS: --- مستوى السجل = تصحيح الأخطاء --log = $ CHECKBOX_DATA / checkbox-project.log}
تصدير CHECKBOX_CERTIFICATION_SHARE = ​​$ {CHECKBOX_CERTIFICATION_SHARE: - / usr / share / checkbox-Certificate}
تصدير CHECKBOX_OEM_SHARE = ​​$ {CHECKBOX_PROJECT_BASE_SHARE: - / usr / share / checkbox-project-base}
تصدير CHECKBOX_PROJECT_SHARE = ​​$ {CHECKBOX_PROJECT_SHARE: - / usr / share / checkbox-project}

# ملاءمة لتعريف دليل بايثونباث.
إذا ["$ CHECKBOX_SHARE"! = "/ usr / share / checkbox"]؛ من ثم
تصدير PYTHONPATH = "$ CHECKBOX_SHARE: $ PYTHONPATH"
fi

python3 $ CHECKBOX_SHARE / تشغيل "$ @" $ CHECKBOX_PROJECT_SHARE / configs / $ (basename $ 0) .ini

هنا يمكنك أن ترى أنه يحدد بعض المواقع وجزء مهم هو python3 النهائي
سطر ، حيث سيحدد موقع ملف التكوين .ini المطلوب ويستخدمه سابقًا.

كان هذا التنظيم الهرمي قويًا جدًا ولكن كان من الصعب أيضًا التعامل معه ، و
لديها أيضا بعض القيود. كان جزء من العمل الذي قمنا به باستخدام مربع الاختيار هو دمج كل ملفات
المكونات الإضافية الخاصة بالمشروع في صندوق مربع الاختيار ، وبهذه الطريقة يكون كل الكود الأساسي في مكان واحد ،
والمتغيرات الخاصة بالمشروع توفر فقط الوظائف والقوائم البيضاء والبيانات والتكوين ،
دون إضافة سلوك جديد.

جديد عادي سلوك مراقبة
على عكس مربع الاختيار ، فإن جوهر Plainbox هو أحادي ، وليس له مفهوم المكونات الإضافية. هذه
يسهل فهمها والعمل معها. جوهر عادي لديه تطبيقات للجميع
الوظائف الموجودة في حزم مربعات الاختيار القديمة ، لذلك ليست هناك حاجة إلى إضافات لاستخدام الميزات
مثل التقديم إلى الشهادة أو إنشاء التقرير.

ما نسميه Plainbox هو المكتبة التي تنفذ جميع الوظائف ، كما يمكن رؤيته
هنا.

يوفر Plainbox أدوات لمساعدة مطوري الاختبار في كتابة الاختبارات وحزمها. وهذه هي
يتم تسليمها في "الموفرون" ، وهي كيانات مصممة لتلخيص أوصاف الاختبار ،
نصوص مخصصة للاختبار والقوائم البيضاء والبيانات المتنوعة. تم تصميمها للسماح
الفرق لكتابة وتقديم اختباراتهم المخصصة دون الحاجة إلى القلق كثيرًا بشأن
الكود العادي الأساسي.

للحصول على معلومات حول كيفية كتابة الاختبارات والموفرين ، راجع البرنامج التعليمي للموفر

ومع ذلك ، عند استخدام هذه الاختبارات فعليًا للتحقق من نظام حقيقي ، أردنا توفيرها
شيء أسهل وأقرب إلى تجربة المستخدم في مربع الاختيار. أنشأنا عميلين ،
checkbox-gui و checkbox-cli ، اللذان كان لهما بعض السلوكيات المشفرة ، وقد بدأنا أيضًا
إنشاء عملاء آخرين يعتمدون على هؤلاء ولكنهم محددون لغرض معين. على سبيل المثال،
كان لدينا إصدار من مربع الاختيار لاختبار SRU ، وآخر لشهادة الخادم ، وما إلى ذلك.

لكننا أدركنا بعد ذلك أن الكثير من التعليمات البرمجية مكرر وأن السلوكيات شائعة
باستثناء بعض التغييرات. لذلك توصلنا إلى مفهوم "قاذفات" ، وهي
تشبه إلى حد ما ملفات تكوين مربع الاختيار ومشغلات البرامج النصية.

الفكرة هي أن checkbox-gui و checkbox-cli لهما بعض السلوكيات الأساسية جدًا ، نظرًا لأنهما
هم العملاء الذين يتم شحنها بشكل افتراضي مع ubuntu. يمكنهم إظهار كل ما هو متاح
القوائم البيضاء ، وإظهار رسالة ترحيب محددة مسبقًا ، وفي النهاية ستسمح للمستخدم بمشاهدة ملف
تقرير html وإرساله إلى launchpad باستخدام عنوان البريد الإلكتروني الخاص بهم ، على غرار الإصدار
من خانة الاختيار التي تم شحنها مع Ubuntu.

بدلاً من استخدام محولات سطر أوامر معقدة ، تتيح لك المشغلات تكوين بعضها
سلوكيات اختيارية لتخصيص تجربة الاختبار الخاصة بك. يحتوي المشغل على الإعدادات و
يشبه البرنامج النصي shell ، لكن المترجم سيكون إما checkbox-gui أو
مربع الاختيار.

فيما يلي بعض الأمثلة لما يمكن عمله باستخدام قاذفات.

كمفاجأة ، فإن checkbox-cli هي نفسها قاذفة:

#!/ البيرة / بن / إنف مربع الاختيار
[أهلا بك]
text = مرحبًا بك في اختبار النظام!
يوفر Checkbox اختبارات للتأكد من أن نظامك يعمل بشكل صحيح.
بمجرد الانتهاء من تشغيل الاختبارات ، يمكنك عرض تقرير موجز عن
النظام الخاص بك.
تحذير: قد تتسبب بعض الاختبارات في تجميد نظامك أو توقفه عن العمل
لا تستجيب. يرجى حفظ كل ما تبذلونه من العمل وإغلاق كل أخرى قيد التشغيل
التطبيقات قبل بدء عملية الاختبار.

[بعد]
whitelist_filter = ^ افتراضي $
whitelist_selection = ^ افتراضي $
skip_whitelist_selection = صحيح

[المواصلات]
Submit_to = Launchpad

يمكنك أن ترى هنا أننا نقوم بتخصيص بعض الخيارات: تظهر رسالة ترحيب تلقائيًا
يختار القائمة البيضاء الافتراضية ، ويرسل إلى لوحة التشغيل عند الانتهاء.

مثال على المشغل الرسومي هو عميل الشهادة المتعارف عليه.

#! / usr / bin / checkbox-gui

[أهلا بك]
العنوان = "شهادة النظام"
نص = " مرحبًا بك في System Certification! هذا التطبيق سوف
جمع المعلومات من نظامك. ثم سيُطلب منك إجراء اختبارات يدوية لـ
تأكد من أن النظام يعمل بشكل صحيح. أخيرًا ، سيُطلب منك
المعرّف الآمن لجهاز الكمبيوتر لإرسال المعلومات إلى الشهادة
قاعدة البيانات. لمعرفة كيفية إنشاء أو تحديد موقع المعرّف الآمن ،
يرجى الاطلاع هنا: الشهادات.canonical.com "

[بعد]
whitelist_filter = "^ العميل- (شهادة | selftest). *"

[استسلام]
input_type = "regex"
input_placeholder = "معرف آمن (15 أو 18 حرفًا)"
ok_btn_text = "إرسال النتائج"
submit_to_hexr = "صحيح"

[مصدر]
xml_export_path = "/tmp/submission.xml"

[المواصلات]
Submit_to = "شهادة"

تعد قاذفات الرسوم أكثر تعقيدًا بعض الشيء ، لكنها في الأساس متشابهة ، ما هي
يسمح لك بتحديد بعض المعلمات لتخصيص تجربة الاختبار الخاصة بك.

إن مشغل وضع النص البسيط للغاية هو مجموعة Canonical-hw التي تعمل فقط على الأساسي
اختبارات معلومات الأجهزة وتحميلها إلى قاعدة بيانات الأجهزة:

[أهلا بك]
title = تجميع معلومات الأجهزة
text = تجميع معلومات الأجهزة. قد تتم مطالبتك بكلمة المرور الخاصة بك.
ستستغرق هذه العملية حوالي 30 ثانية وسيتم تزويدك بها
مع عنوان URL يمكنك من خلاله تأكيد وتسجيل أجهزتك
تقديم.

[بعد]
whitelist_filter = ^ hwsubmit $
whitelist_selection = ^ hwsubmit $
skip_whitelist_selection = صحيح
skip_test_selection = صحيح

[استسلام]
# معرف آمن زائف يضمن أننا لا نطلبه
# يمكن دائمًا تجاوزها في ملف .conf.
معرف_المأمون = 000

[المواصلات]
Submit_to = شهادة
Submit_url = https://hardware-server.example.com/

بشكل أساسي ، توفر مجموعة اختبار السائق المتعارف عليه مشغل وضع رسومي ونص ،
والتي هي مكافئة وظيفيًا:

#! / usr / bin / checkbox-gui

[أهلا بك]
العنوان = "Canonical Driver Test Suite"
نص = " مرحبًا بك في Canonical Driver Test Suite.

يحتوي هذا البرنامج على اختبارات آلية ويدوية لمساعدتك على الاكتشاف
المشكلات التي ستظهر عند تشغيل برامج تشغيل جهازك على Ubuntu.

سيقوم هذا التطبيق بتوجيه المستخدم خلال هذه الاختبارات في ملف
أمر محدد مسبقًا وجمع معلومات النظام تلقائيًا على شكل
وكذلك نتائج الاختبار. سيطلب أيضًا من المستخدم الإدخال يدويًا
الاختبار مطلوب.

يتم تحديد وقت تشغيل الاختبارات وفقًا للاختبارات التي تقررها
ينفذ. ستتاح للمستخدم الفرصة لتخصيص التشغيل التجريبي لـ
استيعاب السائق ومقدار الوقت المتاح للاختبار.

للبدء ، ما عليك سوى النقر فوق الزر "متابعة" أدناه واتبع ما يظهر على الشاشة
تعليمات. "

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

[استسلام]
ok_btn_text = "حفظ النتائج"
input_type = "لا شيء"

[مصدر]
xml_export_path = ""

[المواصلات]
Submit_to = "local"

وضع النص:

#!/ البيرة / بن / إنف مربع الاختيار
[أهلا بك]
text = مرحبًا بك في Canonical Driver Test Suite
يحتوي هذا البرنامج على اختبارات آلية ويدوية لمساعدتك على الاكتشاف
المشكلات التي ستظهر عند تشغيل برامج تشغيل جهازك على Ubuntu.
سيقوم هذا التطبيق بتوجيه المستخدم خلال هذه الاختبارات في ملف
أمر محدد مسبقًا وجمع معلومات النظام تلقائيًا على شكل
وكذلك نتائج الاختبار. سيطلب أيضًا من المستخدم الإدخال يدويًا
الاختبار مطلوب.
يتم تحديد وقت تشغيل الاختبارات وفقًا للاختبارات التي تقررها
ينفذ. ستتاح للمستخدم الفرصة لتخصيص التشغيل التجريبي لـ
استيعاب السائق ومقدار الوقت المتاح للاختبار.
للبدء ، ما عليك سوى النقر فوق الزر "متابعة" أدناه واتبع ما يظهر على الشاشة
تعليمات.

[بعد]
# القائمة البيضاء المعروضة في شاشة اختيار الجناح
whitelist_filter = ^ ihv -. *
# اختيار القائمة البيضاء إلزامي لذا قمنا بتعيينه على قيمة زائفة
# لم يتم تحديد أي قوائم بيضاء مسبقًا.
whitelist_selection = زائف

صندوق التحقق RELEASE PROCESS

تصف هذه الصفحة الخطوات الضرورية لإصدار إصدارات من مربع الاختيار ومربع الاختيار
شهادة PPA المستقرة التي تنتمي إلى فريق شهادة الأجهزة ، بشكل منتظم
أساس. في هذا المستند ، يتم استخدام مصطلح "مربع الاختيار" كمصطلح شامل يجب تغطيته
جميع إصدارات Checkbox مملوكة لفريق اعتماد الأجهزة ، وهو مربع الاختيار حاليًا
نفسها وامتدادات شهادة مربع الاختيار.

نبذة
تعمل العملية حاليًا بإيقاع كل أسبوعين ، مع إصدار جديد من Checkbox كل أسبوعين
إسبوعين. يغطي هذا عشرة أيام عمل ، والمهام التي تنفذ في كل يوم أو مجموعة
الأيام موصوفة أدناه:

· الأيام 1-4: الوقت المسموح به لإدخال تغييرات جديدة في صندوق الأمتعة.

· اليوم الخامس: يتم دمج التغييرات من صندوق ملفات lp: خانة اختيار و lp: شهادة مربع الاختيار إلى
فروع الإفراج الخاصة بهم. التغيير لكليهما صدم في هذه المرحلة و
المراجعات الموسومة. في هذه المرحلة ، قد يكون من الضروري أيضًا نسخ الحزمة "fwts"
من FWTS مستقر المؤسسة العامة للتقاعد <https://launchpad.net/~firmware-testing-team/+archive/ppa-
fwts- مستقرة> إلى مربع الإفراج عن الاختبار المؤسسة العامة للتقاعد <https://launchpad.net/~checkbox-
ديف / + أرشيف / اختبار>.

· الأيام من 6 إلى 9: يتم إجراء الاختبار بواسطة مدير الإصدار لشهادة الأجهزة
وممثل عن فريق ضمان الجودة CE (العميل الرئيسي لـ Checkbox في الداخل
العنوان الأساسي)

· اليوم 9: عقد اجتماع تحرير بين مدير الإصدار للأجهزة
فريق الاعتماد وممثل فريق ضمان الجودة CE. المشكلات المحتملة مع
تحديد الإفراج ووضع الخطط لمعالجتها.

• اليوم العاشر: يتم نسخ النسخة المختبرة من Checkbox إلى PPA المستقر.

انطلاق افرعنا
تتطلب عملية التحرير فروعًا منفصلة في Launchpad تحتوي على شبه مجمدة
نسخة من الكود كانت في صندوق الأمتعة في اليوم الخامس من العملية. هذا هو ذلك التطور
يمكن أن يستمر على الجذع دون تعريض استقرار النسخة التي سيتم إطلاقها من
خانة اختيار. العلاقة بين جميع الفروع المشاركة في العملية كما هو موضح أدناه:

· lp: خانة اختيار / تحرير <- lp: خانة اختيار

· ليرة لبنانية: خانة الاختيار / الإصدار <- lp: شهادة مربع الاختيار

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

التدقيق ميلستونيد البق
قبل إنشاء مرشح الإصدار ، يجب على مدير الإصدار مراجعة قائمة الأخطاء
Milestoned للإصدار التالي من Checkbox. يجب أن يزوروا مربع معالم
<https://launchpad.net/checkbox/+milestonesmilestones> وحدد موقع المعلم مؤرخًا بـ
تاريخ الافراج عنه.

· للأخطاء التي تم تعيينها على قيد التقدم مع فرع مرتبط - الارتباط بالفرع
المالك لمعرفة ما إذا كان يمكن إكمال الدمج قبل الموعد النهائي.

· للأخطاء الموجودة في أي حالة أخرى غير مغلقة (باستثناء حل ملتزم) - إعادة معلم
منهم إلى المرحلة التالية.

القطع: ال الافراج عن
من أجل قطع الإصدار ، يتعين علينا دمج التغييرات من الجذع في الإصدار
، أرسل لهم رسالة مناسبة وقم بتحديث سجل التغيير في صندوق السيارة بحيث
التغييرات المستقبلية تخضع للإصدار الصحيح. لكل مجموعة من الفروع الموضحة أعلاه ،
قم بما يلي (يستخدم المثال lp: خانة اختيار و lp: خانة اختيار / تحرير):

فرع bzr lp: خانة اختيار / تحرير خانة الاختيار
فرع bzr lp: checkbox-trunk
مربع الاختيار cd
current_stable = `head -n1 $ (find. -name 'changelog') | grep -oP '(؟ <= \ (). * (؟ = \))' '
bzr merge lp: خانة اختيار

في هذه المرحلة إذا لم يتغير (بخلاف واحد إلى ديبيان / سجل التغيير) يتم دمجها ثم نقوم بذلك
عدم تنفيذ إصدار الحزمة المعنية. في الممارسة العملية يحدث هذا غالبًا مع
خانة الاختيار ولكن أبدا مع مربع:

bzr الالتزام -m "تم دمج التغييرات من rev $ (علامة bzr revno -r: $ current_stable lp: checkbox) إلى rev $ (bzr revno lp: checkbox) من lp: checkbox"
bzr push lp: خانة اختيار / تحرير
قرص مضغوط `تجد. -اسم "ديبيان "` ؛ قرص مضغوط ..
علامة bzr `head -n1 debian / changelog | grep -oP '(؟ <= \ (). * (؟ = \))' '
dch -r (حفظ سجل التغيير المعدل)
dch -i -U "سجل التغيير المتزايد"
المدين
bzr push lp: خانة اختيار

تتمثل الخطوة الأخيرة في العملية في تنفيذ إنشاء الحزم في ملف
ppa: checkbox-dev / test المؤسسة العامة للتقاعد. للقيام بذلك ، نحتاج إلى الانتقال إلى صفحات الوصفات الخاصة بـ
مربع و / أو خانة الاختيار الافراج عن الفروع.

· اختبار مربع الاختيار وصفة <https://code.launchpad.net/~checkbox-dev/+recipe/checkbox-
تجريب>

· اختبار شهادة خانة الاختيار وصفة <https://code.launchpad.net/~checkbox-
dev / + وصفة / اختبار شهادة مربع الاختيار>

• البناء الآن يجب أن يكون الخيار متاحًا على الصفحة. انقر فوقه لبدء بناء.

نسخ الثابتة اختبار التالي إلى ال الاختبار المؤسسة العامة للتقاعد
أداة Firmware Test Suite هي أداة اختبار للبرامج الثابتة للنظام والتي تكون كثيفة بشكل طبيعي
تستخدم من قبل Checkbox. للتأكد من أحدث إصدار يحتوي على إصلاحات وجديدة
الاختبارات / الميزات التي يحتاجها Checkbox متاحة ولا تحطم أي شيء
مربع الاختيار ، نحتاج إلى تحريره بجانب Checkbox. بعد قطع الإصدار إذا كان
أخطر فريق اختبار البرامج الثابتة بتوفر إصدار جديد وبأن هذا الإصدار
يجب استخدامها للحصول على الشهادة ، فنحن بحاجة إلى نسخها إلى اختبار PPA. للقيام بهذا نحن
بحاجة للذهاب إلى نسخ حزم عرض of ال الثابتة اختبار التالي (مستقر) المؤسسة العامة للتقاعد
<https://launchpad.net/~firmware-testing-team/+archive/ppa-fwts-stable/+copy-packages> و
حدد حزم "fwts" لجميع الإصدارات مرة أخرى إلى Precise. نحن بحاجة إلى ضبط
"Destination PPA" مثل "Checkbox Release Testing [~ checkbox-dev / testing]" و "نسخ
options "لنسخ الثنائيات الموجودة" ، ثم انقر فوق "نسخ الحزم". هذه الخطوة إذن
يجب تكرارها ولكن قم بتعيين حقل "الوجهة PPA" على "PPA لمطوري Checkbox
[~ checkbox-dev / ppa] '.

التالى الإفراج عن of مربع بريد الإلكتروني
حتى تتاح للجميع الفرصة لإجراء أي اختبار مطلوب في الوقت المناسب
بعد اكتمال إنشاءات اتفاقية شراء الطاقة ، يجب إرسال بريد إلكتروني إلى العنوان التالي
القوائم البريدية:

· [البريد الإلكتروني محمي] <شهادة الأجهزة-
[البريد الإلكتروني محمي]>

· [البريد الإلكتروني محمي] <[البريد الإلكتروني محمي]>

المحتوى عادة شيء مثل هذا:

الموضوع: الإصدار التالي من خانة الاختيار (18/11/2013)

مرحبا،

الإصدار التالي من Checkbox متاح في
https://code.launchpad.net/~checkbox-dev/+archive/testing PPA.
يرجى اختباره على راحتك. تستند خانة الاختيار إلى المراجعة 2484 من
lp: تستند خانة الاختيار وشهادة مربع الاختيار إلى المراجعة 586 من
lp: شهادة مربع الاختيار.

شكر،

إذا لم يتم تحديث أحدهما أو الآخر من Checkbox و Checkbox Certification ثم
ليست هناك حاجة لذكر تلك الحزمة

الاختبار ال الافراج عن
الآن بعد أن تم قطع الإصدار ، يجب إجراء الاختبار قبل اجتماع الإصدار.
من وجهة نظر فريق الاعتماد ، ما يجب اختباره هو
مربع الاختيار-شهادة-العميل و خانة الاختيار خادم الشهادات التي تشكل الأساس ل
إصدارات CE QAs OEM محددة من Checkbox. يتم اختبار خادم شهادة Checkbox في ملف
يحتاج عميل شهادة مربع الاختيار CI loop إلى اختباره يدويًا.

الإفراج عن لقاء
في يوم الخميس قبل إصدار الإصدار ، يتم عقد اجتماع بين ممثل
فريق الاعتماد وممثل عن تجاري الهندسة QA الفريق. ال
يُعقد الاجتماع في الساعة 7:30 بالتوقيت العالمي المنسق كما هو موضح في هذا تقويم دعا
<https://www.google.com/calendar/hosted/canonical.com/event?action=TEMPLATE&tmeid=Y3QxcWVla3ViMTRvMXByOHZlOTFvc283Y2NfMjAxMzA4MjlUMDczMDAwWiBicmVuZGFuLmRvbmVnYW5AY2Fub25pY2FsLmNvbQ&tmsrc=brendan.donegan%40canonical.com>.
يتم تضمين جدول أعمال الاجتماع في الدعوة.

نشر ال الافراج عن
لنشر الإصدار ، نحتاج ببساطة إلى نسخ عدد من الحزم من ملف مربع
الإفراج عن الاختبار المؤسسة العامة للتقاعد <https://launchpad.net/~checkbox-dev/+archive/testing> إلى أجهزة التبخير
الشهادات عام المؤسسة العامة للتقاعد <https://launchpad.net/~hardware-certification/+archive/public>.
للقيام بذلك نذهب إلى نسخ حزم عرض of ال مربع الإفراج عن الاختبار المؤسسة العامة للتقاعد
<https://launchpad.net/~checkbox-dev/+archive/testing/+copy-packages> وحدد الكل
إصدارات من قائمة الحزم التالية: مربع الاختيار شهادة مربع الاختيار fwts. يصنع
تأكد من تعيين حقل "الوجهة PPA" على "Public PPA for Hardware Certification"
[~ شهادة الأجهزة / عامة] 'وأن حقل "خيارات النسخ" مضبوط على "نسخ
الثنائيات الموجودة "، ثم انقر فوق" نسخ الحزم ".

بعد الانتهاء من ذلك ، يجب إرسال بريد إلكتروني للإعلان إلى
[البريد الإلكتروني محمي] <[البريد الإلكتروني محمي]>.
تم تضمين نموذج للإعلان أدناه:

مرحبا،

تم تحميل إصدار جديد من خانة الاختيار على الجهاز
شهادة PPA العامة
(https://launchpad.net/~hardware-certification/+archive/public). ال
يعتمد الإصدار على المراجعة رقم 2294 من مربع الاختيار lp:

شكر،

يرجى إرفاق أحدث جزء من سجل التغيير كملاحظات الإصدار

· جينينديكس

موديديكس

· بحث

استخدم checkbox-cli عبر الإنترنت باستخدام خدمات onworks.net