kotak semak-cli - Dalam talian dalam Awan

JADUAL:

NAMA

checkbox_ng - CheckboxNG Dokumentasi

CheckboxNG ialah alat ujian perkakasan yang berguna untuk memperakui komputer riba, desktop dan pelayan
dengan Ubuntu. Ia ialah versi baharu Kotak Semak yang dibina terus di atas Kotak Plain

Kotak semakNG menggantikan Kotak semak, jika berkenaan.

AMARAN :
Dokumentasi sedang dalam pembangunan. Beberapa perkara adalah salah, tidak tepat atau menerangkan
matlamat pembangunan berbanding keadaan semasa.

PEMASANGAN

CheckboxNG boleh dipasang daripada PPA (disyorkan) atau pypi pada Ubuntu Precise (12.04) atau
lebih baru.

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

BERGUNA KEDAI SIARAN UPDATE UJIAN

CheckboxNG mempunyai sokongan khas untuk menjalankan ujian kemas kini keluaran stabil secara automatik
cara. Ini menjalankan semua pekerjaan dari sru.senarai putih dan menghantar hasilnya kepada
laman web pensijilan.

Untuk menjalankan ujian SRU anda perlu mengetahui apa yang dipanggil ID Selamat bagi peranti anda
ujian. Sebaik sahaja anda tahu bahawa semua yang anda perlu lakukan ialah jalankan:

$ kotak semak sru $secure_id submission.xml

Argumen kedua, submission.xml, ialah nama fail sandaran yang hanya dibuat
apabila menghantar data ke tapak web pensijilan gagal berfungsi atas sebarang sebab.

PELAPORAN BUANG

Untuk melaporkan pepijat pada projek Kotak Semak, anda memerlukan akaun pad pelancar. Anda mungkin dapati
arahan on bagaimana kepada mewujudkan 1 <https://help.launchpad.net/YourAccount/NewAccount>
berguna. Sebaik sahaja anda mempunyai akaun anda boleh melaporkan pepijat <https://bugs.launchpad.net/checkbox-
projek/+pepijat fail>.

Pada halaman itu anda boleh memilih projek yang anda ingin failkan pepijat (kami menggunakan beberapa
projek untuk menyelaraskan keluaran dan kami lebih suka mempunyai pepijat yang dikaitkan dengan yang sesuai
sebahagian daripada Kotak Semak). Jika anda tahu projek yang betul untuk digunakan, hanya gunakannya dan failkan pepijat. Jika
anda tidak begitu mengetahui dalaman Kotak Semak atau ragu-ragu hanya failkannya di pangkalan
Projek 'Kotak Semak' (anda boleh menggunakan ini terus pautan
<https://bugs.launchpad.net/checkbox/+filebug>.) Seorang ahli pasukan pembangunan akan
semak pepijat anda dan tetapkan semula ke lokasi yang sesuai. Nombor pepijat tidak akan
berubah apabila itu berlaku.

THE KOTAK SEMAK TIMBUNAN

Tindanan Kotak Semak ialah koleksi projek yang bersama-sama membentuk ujian lengkap
dan penyelesaian pensijilan. Ia terdiri daripada bahagian berikut (lihat jadual di bawah untuk
butiran tambahan). Semua projek dikaitkan dengan daripada Launchpad projek kumpulan
<https://launchpad.net/checkbox-project>.

Seni bina Rajah
[imej: Rajah Seni Bina] [imej]

Gambar rajah ini mengandungi anggaran peringkat tinggi seni bina Kotak Semak semasa.
Terdapat tiga "tiang" utama. Di sebelah kiri kita ada akhir produk. Itu adalah alat sebenar
yang pensijilan dan jurutera gunakan. Di sebelah kanan kita mempunyai ujian pasaran. Ini adalah
pasaran terbuka vendor dan pembekal ujian. Ujian dibungkus dalam bekas yang dikenali sebagai
pembekal. Di tengah kami mempunyai tiga komponen yang dikongsi. Mereka melaksanakan sebahagian besar daripada
rangka kerja dan antara muka pengguna untuk pelaksanaan ujian. Akhirnya di sudut kiri bawah sana
ialah sebahagian daripada kotak pilihan (pustaka) yang dikongsi dengan HEXR untuk tugasan tertentu. HEXR ialah a
aplikasi web di luar skop yang digunakan oleh sebahagian daripada proses pensijilan. Anak panah menyiratkan
komunikasi dengan bentuk anak panah menunjukkan siapa yang memanggil siapa.

Seperti yang dinyatakan sebelum ini, dalam lajur tengah terdapat tiga komponen utama kod kongsi
(dikongsi oleh semua orang menggunakan produk akhir yang dibincangkan di bawah). Kod yang dikongsi ialah
terdiri daripada kotak biasa, kotak semak-ng dan kotak semak-gui. Tanggungjawab komponen ialah
dibincangkan dengan lebih terperinci dalam jadual di bawah. Di sini kita dapat melihat bahawa kotak semak-gui menggunakan DBus
API didedahkan oleh checkbox-ng, yang seterusnya menggunakan checkbox-support (perpustakaan pembantu
dipisahkan jadi kongsi beberapa kod dengan HEXR) dan kotak biasa.

Di lajur sebelah kanan terdapat pelbagai penyedia ujian. Projek kotak semak ialah
menghasilkan dan menyelenggara beberapa pembekal (lihat jadual di bawah) tetapi ia dijangka
bahawa pengguna hiliran kami juga akan menghasilkan pembekal mereka sendiri (khusus kepada pelanggan atau
projek). Akhirnya beberapa pembekal mungkin datang daripada pihak ketiga yang akan menerima pakai
format.

Akhir sekali di sudut kiri bawah, perpustakaan kongsi, perpustakaan ini mengandungi banyak penghurai
daripada pelbagai format fail dan format output. Secara teknikal perpustakaan ini adalah bergantung kepada
HEXR, kotak semak-ng and daripada pembekal. Sebagai kerumitan tambahan perpustakaan perlu dipanggil
daripada kod python3 dan kod python2.

PERHATIAN:
Komunikasi antara checkbox-ng dan plainbox adalah dua arah. Tawaran kotak kosong
beberapa antara muka asas dan titik sambungan. Itu semua didedahkan melalui kotak biasa
(menggunakan API biasa) tetapi sebahagian daripadanya sebenarnya dilaksanakan dalam kotak semak-ng.

AMARAN :
Semua API dalaman adalah separa tidak stabil. API DBus lebih stabil dalam amalan tetapi sepatutnya
tidak boleh diharap. Projek digalakkan untuk digabungkan ke dalam lp:checkbox di mana API
peralihan boleh dikendalikan dengan anggun. Satu-satunya API yang stabil ialah format fail
spesifikasi (takrifan kerja dan lampu putih). Spesifikasi pelancar akan menjadi
stabil dalam keluaran seterusnya.

Komponen Perihal
┌─────────────────────────┬─────────────────────── ──────────────────┬─────────────────┬────────────‐───‐‐──‐‐──‐‐
│Projek │ Bertanggungjawab untuk │ Jenis │
├─────────────────────────┼─────────────────────── ──────────────────┼─────────────────┼────────────․․
│Kotak Semak Generasi Seterusnya │ │ Aplikasi │
│(GUI) │ · C++/QML │ │
│ │ antara muka pengguna │ │
│ │ │ │
│ │ · Grafik │ │
│ │ pelancar untuk │ │
│ │ pembekal, cth │ │
│ │ kotak semak-pensijilan-klien │ │
├─────────────────────────┼─────────────────────── ──────────────────┼─────────────────┼────────────․․
│Kotak Semak Generasi Seterusnya │ │ Aplikasi │
│(CLI) │ · Baris arahan python │ │
│ │ antara muka │ │
│ │ │ │
│ │ · antara muka pengguna teks │ │
│ │ │ │
│ │ · arahan ujian SRU │ │
│ │ │ │
│ │ · API pensijilan tambahan │ │
│ │ │ │
│ │ · menghantar data ke Launchpad │ │
│ │ │ │
│ │ · menghantar data ke HEXR │ │
│ │ │ │
│ │ · perkhidmatan DBus diperlukan oleh │ │
│ │ GUI │ │
└─────────────────────────┴─────────────────────── -

│Persijilan Pelanggan │ │ Pembekal │
│Pembekal │ · pelanggan pensijilan-kanonikal │ │
│ │ boleh laku │ │
│ │ │ │
│ │ · pensijilan pelanggan │ │
│ │ senarai putih │ │
├─────────────────────────┼─────────────────────── ──────────────────┼─────────────────┼────────────․․
│Pensijilan Pelayan │ │ Pembekal │
│Pembekal │ · pensijilan pelayan │ │
│ │ senarai putih │ │
│ │ │ │
│ │ · senarai putih pelayan tambahan │ │
├─────────────────────────┼─────────────────────── ──────────────────┼─────────────────┼────────────․․
│System-on-Chip Server │ │ Pembekal │
│Pembekal Pensijilan │ · Pensijilan pelayan SoC │ │
│ │ senarai putih │ │
├─────────────────────────┼─────────────────────── ──────────────────┼─────────────────┼────────────․․
│Pembekal Kotak semak │ │ Pembekal │
│ │ · Hampir semua definisi pekerjaan │ │
│ │ │ │
│ │ · Kebanyakan "skrip" tersuai │ │
│ │ │ │
│ │ · Senarai putih lalai dan SRU │ │
├─────────────────────────┼─────────────────────── ──────────────────┼─────────────────┼────────────․․
│Pembekal Sumber │ │ Pembekal │
│ │ · Hampir semua kerja sumber │ │
│ │ │ │
│ │ · Hampir semua "skrip" sumber │ │
├─────────────────────────┼─────────────────────── ──────────────────┼─────────────────┼────────────․․
│Sokongan Kotak semak │ │ Perpustakaan │
│ │ · Kod sokongan untuk pelbagai │ │
│ │ pembekal │ │
│ │ │ │
│ │ · Penghurai untuk banyak format teks │ │
├─────────────────────────┼─────────────────────── ──────────────────┼─────────────────┼────────────․․
│PlainBox │ │ Perpustakaan dan Pembangunan │
│ │ · Hampir semua logik teras │ Toolkit │
│ │ │ │
│ │ · RFC822 (takrif pekerjaan) │ │
│ │ penghurai │ │
│ │ │ │
│ │ · Pengendalian konfigurasi │ │
│ │ │ │
│ │ · Sesi ujian │ │
│ │ (gantung/sambung semula) │ │
│ │ │ │
│ │ · Pelari kerja │ │
│ │ │ │
│ │ · Pelancar yang dipercayai │ │
│ │ │ │
│ │ · Penyelesai kebergantungan │ │
│ │ │ │
│ │ · Pengendalian baris arahan │ │
│ │ │ │
│ │ · XML, HTML dan XSLX │ │
│ │ pengeksport │ │
│ │ │ │
│ │ · dan banyak lagi... │ │
│ │ │ │
│ │ · Kit alat pembangunan pembekal │ │
│ │ │ │
│ │ · 'pembekal permulaan kotak kosong' │ │
│ │ │ │
│ │ · pelaksanaan 'manage.py' │ │
└─────────────────────────┴─────────────────────── -

│Kotak Semak Warisan (tidak │ │ Aplikasi Monolitik │
│lebih lama diselenggara) │ · Aplikasi │ Perpustakaan dan Data │
│ │ │ │
│ │ · GUI Qt4 │ │
│ │ │ │
│ │ · Gtk2 GUI │ │
│ │ │ │
│ │ · Urwid (teks) GUI │ │
│ │ │ │
│ │ · Teras │ │
│ │ │ │
│ │ · Pemalam dan Acara / Mesej │ │
│ │ Enjin │ │
│ │ │ │
│ │ · Hampir Setiap ciri │ │
│ │ melaksanakan pemalam teras │ │
│ │ │ │
│ │ · Data │ │
│ │ │ │
│ │ · Pekerjaan dan senarai putih │ │
└─────────────────────────┴─────────────────────── -

BAHASA MELAYU

PERHATIAN:
Log perubahan ini hanya mengandungi ringkasan perubahan. Untuk perakaunan yang lebih tepat
sejarah pembangunan sila periksa sejarah sumber secara langsung.

Kotak semakNG 0.23 (belum dikeluarkan)
· Pembetulan pepijat: https://launchpad.net/checkbox-ng/+milestone/0.23

Kotak semakNG 0.22
· Pembetulan pepijat: https://launchpad.net/checkbox-ng/+milestone/0.22

Kotak semakNG 0.3
· Pembetulan pepijat: https://launchpad.net/checkbox-ng/+milestone/0.3

Kotak semakNG 0.2
· Pembetulan pepijat: https://launchpad.net/checkbox-ng/+milestone/0.2

Kotak semakNG 0.1
· Keluaran awal

· Sokongan untuk memaparkan konfigurasi

· Sokongan untuk menjalankan ujian SRU (ujian regresi automatik)

UJIAN SKRIP

'Skrip' ujian ialah program kecil yang digunakan untuk membantu dalam melaksanakan ujian.

ujian_kecerahan
Skrip ini menguji kecerahan lampu latar sistem boleh ditukar dengan menggunakan
antara muka kernel dalam /sys/class/backlight. Mungkin terdapat lebih daripada satu antara muka untuk dipilih
daripada, jadi antara muka yang betul untuk digunakan dipilih dengan menggunakan heuristik yang ditetapkan dalam
https://www.kernel.org/doc/Documentation/ABI/stable/sysfs-class-backlight. Kecerahannya
dimanipulasi dengan mengemas kini fail kecerahan antara muka dan actual_brightness
fail diperiksa untuk melihat sama ada nilai telah diubah suai kepada kecerahan yang dipilih.

PROFIL CONFIGURATION

Profil pelaksanaan, atau pelancar, membenarkan menentukan set konfigurasi yang telah ditetapkan
pilihan yang membenarkan penyesuaian skrin alu-aluan, senarai putih yang dipaparkan serta
menyimpan hasil secara setempat atau menghantar fail penyerahan ke Launchpad atau ke Pensijilan
pangkalan data/HEXR, serta beberapa parameter lain.

Tetapan profil adalah sebahagian daripada skrip pelancar dan gunakan sama ada kotak semak-gui atau
pelancar kotak semak (dalam mod teks/CLI) sebagai shebang untuk mentafsir kunci/nilai.

Dokumen ini menyediakan rujukan tentang fungsi pelancar dan sintaks. Untuk memahami
reka bentuk dan konsep dan lihat beberapa contoh, anda mungkin mahu membaca tutorial bagaimana untuk
buat pelancar dan hubungannya dengan Kotak Semak warisan.

Syntax
Memandangkan checkbox-gui ialah aplikasi Qt, tetapan mesti mengikut peraturan gaya INI
QSettings <http://qt-project.org/doc/qt-5/QSettings.html> kelas.

Nilai berbilang baris disokong tetapi mesti disertakan dalam petikan berganda dan baris tambahan
mesti bermula dengan satu ruang, cth:

[kategori]
kunci = "Hello
dunia"

· Daripada QML:

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

· Daripada C++:

tetapan->nilai("kategori/kunci", app.tr("nilai_default"))

Sebaliknya, pelancar khusus kotak semak-pelancar mesti mengikut Python ConfigParser
<https://docs.python.org/3/library/configparser.html#supported-ini-file-structure> sintaks.

Selain itu, sesetengah tetapan hanya masuk akal untuk GUI atau CLI, dan oleh itu tidak difahami oleh
yang lain. Ini dinyatakan di bawah.

Disokong Tetapan
selamat datang/tajuk
Tajuk aplikasi QML dan pengepala skrin selamat datang. Lalai kepada sistem Ujian.

selamat datang / teks
Mesej alu-aluan untuk dipaparkan pada skrin pertama (checkbox-gui menyokong Teks kaya
membenarkan markup gaya HTML). Lalai kepada selamat datang kepada sistem Menguji. [...]

suite/penapis_senarai putih
Ungkapan biasa untuk memadankan subset nama fail senarai putih. Pada kotak semak-gui itu
lalai kepada .*. Untuk pelancar kotak semak ia tidak mempunyai lalai dan kemestian ditakrifkan.

suite/senarai putih_pilihan
Corak yang perlu dipadankan oleh senarai putih untuk diprapilih. Ungkapan biasa Python.
Ia tidak mempunyai lalai dan kemestian ditakrifkan. (CLI sahaja)

suite/skip_whitelist_selection
Jika ditetapkan kepada benar, pengguna tidak akan menerima pilihan senarai putih. Hanya yang telah dipilih
satu (lihat senarai_putih) akan dipilih. (CLI sahaja).

suite/skip_test_selection
Jika ditetapkan kepada benar, pengguna tidak akan dibenarkan menyahpilih ujian sebelum dijalankan: semua ujian
dalam senarai putih yang dipilih akan dijalankan. (CLI sahaja)

penyerahan/mesej
Teks pengepala pop timbul penyerahan , ditunjukkan kepada pengguna selepas penyerahan telah dibuat
selesai. (GUI sahaja)

penyerahan/jenis_input
Tunjukkan medan input Teks untuk memasukkan ID selamat atau alamat LP (lalai). Kepada
hanya simpan keputusan ke cakera, mesti menggunakan tiada nilai. Untuk mengesahkan menggunakan regex,
mesti regex. (GUI sahaja)

penyerahan/regex
Ungkapan biasa untuk mengesahkan input dalam medan penyerahan (cth e-mel, secure_id)
jika input_type ialah regex. (GUI sahaja). RegExpValidator, lalai .*

penyerahan/input_placeholder
Teks sementara untuk dimasukkan ke dalam medan input, digunakan untuk membimbing pengguna. Launchpad E-Mail
Alamat (lalai) atau Selamat ID (15 or 18 watak). (GUI sahaja)

penyerahan/id_secure
Secure_id diprakonfigurasikan untuk mengisi medan teks.

penyerahan/ok_btn_text
Label untuk butang "Hantar". Hantar Hasil (lalai) atau Jimat Hasil. (GUI
sahaja)

penyerahan/batal_amaran
Tunjukkan kepada pengguna jika dia mahu keluar tanpa menyimpan laporan. Anda kira-kira
untuk keluar dari ujian ini tanpa menyimpan laporan keputusan anda. Adakah anda ingin menyimpan
laporan? (GUI sahaja)

penyerahan/serahkan_ke_hexr
Boolean, tambahkan pengepala tambahan untuk turut menghantar hasil ke HEXR (berfungsi dengan
pengangkutan pensijilan)

pengeksport/xml_export_path
Lokasi untuk menyimpan fail penyerahan XML, jika ditetapkan kepada rentetan kosong akan membuka a
dialog simpan fail. Lalai: /tmp/submission.xml (GUI sahaja)

pengangkutan/serahkan_kepada
Titik akhir pengangkutan. Lalai kepada . Menyokong penyerahan kepada LP (lalai,
nilai PAD pelancaran), pensijilan, Atau tempatan (simpan ke cakera)

transport/submit_url
URL untuk menyerahkan keputusan. Ini membolehkan anda memuat naik ke tapak web yang berbeza, contohnya
ia boleh memuat naik terus ke hexr, atau ke tapak pementasan. Digunakan hanya dengan
pensijilan serahkan_kepada nilai.

transport/config_filename
Nama fail konfigurasi tersuai untuk dimuatkan. Fail konfigurasi digunakan terutamanya untuk menentukan
pembolehubah persekitaran. (CLI sahaja)

pengangkutan/jangan_sekat_keluaran
Jika ditetapkan, sumber, kerja tempatan dan lampiran akan dikeluarkan ke skrin, ini
menjana banyak teks dan terutamanya untuk nyahpepijat. (CLI sahaja)

KOTAK CHECKBOX/PLAINBOX PELANCUR TUTORIAL

Dokumen ini memberikan penjelasan tentang sebab pelancar diperlukan, perkara yang boleh anda capai
dengan mereka, dan membincangkan beberapa contoh untuk menerangkan dengan lebih baik keupayaan mereka. Untuk
rujukan terperinci tentang tetapan yang disokong oleh pelancar, dan sintaks khusus untuk
fail pelancar, lihat /profil.

Warisan kotak semak tingkah laku kawalan
Pada masa lalu, tingkah laku Kotak Semak dikawal oleh tiga mekanisme.

Pertama, fungsi kotak semak boleh ditambah dengan menambah pemalam. Sebagai contoh, yang
keupayaan untuk menyerahkan ke tapak web pensijilan telah ditambahkan oleh pakej pensijilan kotak semak
menggunakan pemalam. Pemalam yang disertakan oleh pensijilan kotak semak dan yang menambah tingkah laku baharu
ke kotak semak asas ialah:

/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

Ini menambah cara untuk menggesa pengguna untuk data khusus penyerahan, menjana xml
laporan, dan fungsi lain.

Seterusnya, gelagat pemalam boleh dikonfigurasikan atau dikawal menggunakan konfigurasi
fail, yang "melata". Fail konfigurasi boleh termasuk yang lain dan yang boleh pula
termasuk orang lain.

Ini ialah contoh fail konfigurasi utama projek-qt.ini khusus projek. Ia yang pertama
fail dibaca apabila klien khusus projek dilancarkan. Beberapa tetapan disingkatkan:

[DEFAULT]
termasuk = %(checkbox_oem_share)s/configs/checkbox-project-base-qt.ini %(checkbox_project_share)s/configs/checkbox-project-base.ini

[kotak semak/plugin/environment_info]
repositori = deb http: //.*\(archive\|security\).ubuntu.com/ubuntu precise-security
penghala = berbilang
server_iperf = 10.20.30.40
senarai_sumber = / Etc / apt / sources.list
wpa_n_psk = kata laluan
wpa_n_ssid = titik akses

[kotak semak/plugin/antara muka_pengguna]
tajuk = Ujian Sistem projek saya

Perhatikan baris termasuk, ini mengarahkannya untuk memuatkan fail konfigurasi untuk
checkbox-project-base-qt dan checkbox-project-base. Kotak semak-project-base-qt memuatkan
konfigurasi untuk pensijilan kotak semak dan projek kotak semak. Tetapan dilantunkan supaya
pilihan konfigurasi berhampiran bahagian atas mengatasi yang berhampiran bahagian bawah.

Akhir sekali, "perduaan" yang digunakan untuk memanggil kotak semak ialah skrip shell yang mentakrifkan tempat untuk mencari
kotak semak perkara yang perlu dijalankan: anda boleh menentukan direktori kongsi, data tertentu
direktori, tuding pada fail konfigurasi dan tentukan beberapa pembolehubah persekitaran yang anda
mungkin diperlukan semasa ujian. Berikut ialah contoh untuk checkbox-project-qt:

#!/ bin / bash
eksport CHECKBOX_DATA=${CHECKBOX_DATA:-~/.kotak semak}
eksport CHECKBOX_SHARE=${CHECKBOX_SHARE:-/usr/share/checkbox}
eksport CHECKBOX_OPTIONS=${CHECKBOX_OPTIONS:---log-level=debug --log=$CHECKBOX_DATA/checkbox-project.log}
eksport CHECKBOX_CERTIFICATION_SHARE=${CHECKBOX_CERTIFICATION_SHARE:-/usr/share/checkbox-certification}
eksport CHECKBOX_OEM_SHARE=${CHECKBOX_PROJECT_BASE_SHARE:-/usr/share/checkbox-project-base}
eksport CHECKBOX_PROJECT_SHARE=${CHECKBOX_PROJECT_SHARE:-/usr/share/checkbox-project}

# Kemudahan untuk menentukan direktori PYTHONPATH.
jika [ "$CHECKBOX_SHARE" != "/usr/share/checkbox" ]; kemudian
eksport PYTHONPATH="$CHECKBOX_SHARE:$PYTHONPATH"
fi

python3 $CHECKBOX_SHARE/run "$@" $CHECKBOX_PROJECT_SHARE/configs/$(basename $0).ini

Di sini anda boleh melihat bahawa ia mentakrifkan beberapa lokasi dan bahagian penting ialah python3 terakhir
baris, di mana ia akan mencari dan menggunakan fail konfigurasi .ini yang diperlukan yang kami lihat sebelum ini.

Organisasi hierarki ini sangat berkuasa tetapi juga sukar dikendalikan, dan
juga mempunyai beberapa batasan. Sebahagian daripada kerja yang kami lakukan dengan kotak semak adalah untuk menyepadukan semua
pemalam khusus projek ke dalam batang kotak semak, dengan cara ini semua kod teras berada di satu tempat,
dan varian khusus projek hanya membekalkan kerja, senarai putih, data dan konfigurasi,
tanpa menambah tingkah laku baru.

Baru kotak kosong tingkah laku kawalan
Tidak seperti kotak pilihan, teras kotak kosong adalah monolitik, dan ia tidak mempunyai konsep pemalam. ini
memudahkan untuk memahami dan bekerja dengannya. Teras peti biasa mempunyai pelaksanaan untuk semua
fungsi dalam pakej kotak semak lama, jadi tiada penambahan diperlukan untuk menggunakan ciri
seperti penyerahan kepada pensijilan atau penjanaan laporan.

Apa yang kami panggil plainbox ialah perpustakaan yang melaksanakan semua fungsi, seperti yang dapat dilihat
disini.

Plainbox menyediakan alatan untuk membantu pembangun ujian menulis dan membungkus ujian. Ini adalah
dihantar dalam "penyedia", yang merupakan entiti yang direka untuk merangkum penerangan ujian,
skrip tersuai untuk ujian, senarai putih dan pelbagai data. Mereka direka untuk membenarkan
pasukan untuk menulis dan menyampaikan ujian tersuai mereka tanpa terlalu risau tentang
kod peti kosong asas.

Untuk mendapatkan maklumat tentang cara menulis ujian dan pembekal, lihat Tutorial Penyedia

Walau bagaimanapun, apabila benar-benar menggunakan ujian ini untuk mengesahkan sistem sebenar, kami ingin menyediakannya
sesuatu yang lebih mudah dan lebih dekat dengan pengalaman pengguna kotak semak. Kami mencipta dua pelanggan,
checkbox-gui dan checkbox-cli, yang mempunyai beberapa tingkah laku berkod keras, dan kami juga mula
mencipta pelanggan lain yang berdasarkan ini tetapi khusus untuk tujuan. Sebagai contoh,
kami mempunyai versi kotak pilihan untuk ujian SRU, satu lagi untuk pensijilan pelayan, dan sebagainya.

Tetapi kemudian kami menyedari bahawa banyak kod telah diduplikasi dan tingkah laku adalah perkara biasa
kecuali beberapa perubahan. Jadi kami datang dengan konsep "pelancar", iaitu
agak serupa dengan fail konfigurasi kotak semak dan pelancar skrip shell.

Ideanya ialah checkbox-gui dan checkbox-cli mempunyai beberapa tingkah laku yang sangat asas, kerana mereka
adalah pelanggan yang dihantar secara lalai dengan ubuntu. Mereka boleh menunjukkan semua yang ada
senarai putih, tunjukkan mesej alu-aluan yang telah ditetapkan, dan pada akhirnya akan membolehkan pengguna melihat
html dan serahkannya ke launchpad menggunakan alamat e-mel mereka, serupa dengan versi
daripada kotak pilihan yang dihantar dengan Ubuntu.

Daripada menggunakan suis baris arahan yang rumit, pelancar membenarkan anda untuk mengkonfigurasi beberapa
tingkah laku pilihan untuk menyesuaikan pengalaman ujian anda. Pelancar mengandungi tetapan dan
adalah serupa dengan skrip shell, tetapi jurubahasa akan sama ada kotak semak-gui atau
kotak semak-pelancar.

Berikut ialah beberapa contoh perkara yang boleh dilakukan dengan pelancar.

Sebagai kejutan, checkbox-cli itu sendiri adalah pelancar:

#!/usr/bin/env kotak semak-pelancar
[selamat datang]
text = Selamat Datang ke Pengujian Sistem!
Kotak semak menyediakan ujian untuk mengesahkan bahawa sistem anda berfungsi dengan betul.
Setelah anda selesai menjalankan ujian, anda boleh melihat laporan ringkasan untuk
sistem anda.
Amaran: Sesetengah ujian boleh menyebabkan sistem anda membeku atau menjadi
tidak responsif. Sila simpan semua kerja anda dan tutup semua larian lain
permohonan sebelum memulakan proses ujian.

[suite]
whitelist_filter = ^default$
whitelist_selection = ^default$
skip_whitelist_selection = Benar

[pengangkutan]
submit_to = pad pelancaran

Anda boleh lihat di sini kami menyesuaikan beberapa pilihan: ia menunjukkan mesej alu-aluan, secara automatik
memilih senarai putih lalai, dan akan menyerahkan kepada pad pelancaran apabila ia selesai.

Contoh pelancar grafik ialah kanonik-pensijilan-klien.

#!/usr/bin/checkbox-gui

[selamat datang]
title = "Pensijilan Sistem"
teks = " Selamat datang ke Pensijilan Sistem! Permohonan ini akan
kumpulkan maklumat daripada sistem anda. Kemudian anda akan diminta ujian manual untuk
mengesahkan bahawa sistem berfungsi dengan baik. Akhirnya, anda akan diminta
ID Selamat komputer untuk menyerahkan maklumat kepada pensijilan
pangkalan data. Untuk mengetahui cara membuat atau mencari ID Selamat,
sila lihat di sini: certification.canonical.com "

[suite]
whitelist_filter = "^client-(cert|selftest).*"

[penyerahan]
input_type = "regex"
input_placeholder = "ID Selamat (15 atau 18 aksara)"
ok_btn_text = "Serahkan Keputusan"
submit_to_hexr = "benar"

[pengeksport]
xml_export_path = "/tmp/submission.xml"

[pengangkutan]
submit_to = "pensijilan"

Pelancar grafik adalah sedikit lebih rumit, tetapi pada asasnya ia adalah serupa, apa itu
membolehkan anda menentukan beberapa parameter untuk menyesuaikan pengalaman ujian anda.

Pelancar mod teks yang sangat mudah ialah canonical-hw-collection yang hanya menjalankan asas
ujian maklumat perkakasan dan memuat naiknya ke pangkalan data perkakasan:

[selamat datang]
tajuk = Mengumpul maklumat perkakasan
teks = Mengumpul maklumat perkakasan. Anda mungkin digesa untuk kata laluan anda.
Proses ini akan mengambil masa kira-kira 30 saat dan anda akan diberikan
dengan URL yang melaluinya anda boleh mengesahkan dan mendaftar perkakasan anda
penyerahan.

[suite]
whitelist_filter = ^hwsubmit$
whitelist_selection = ^hwsubmit$
skip_whitelist_selection = Benar
skip_test_selection = Benar

[penyerahan]
# Id_secure palsu memastikan kami tidak memintanya
# Ia sentiasa boleh diganti dalam fail .conf.
secure_id = 000

[pengangkutan]
submit_to = pensijilan
submit_url = https://hardware-server.example.com/

Akhir sekali, suite-ujian-pemandu-kanonikal menyediakan kedua-dua pelancar mod grafik dan teks,
yang setara secara fungsi:

#!/usr/bin/checkbox-gui

[selamat datang]
title = "Suit Ujian Pemandu Canonical"
teks = " Selamat datang ke Canonical Driver Test Suite.

Program ini mengandungi ujian automatik dan manual untuk membantu anda menemui
isu yang akan timbul semasa menjalankan pemacu peranti anda pada Ubuntu.

Aplikasi ini akan melangkah pengguna melalui ujian ini dalam a
pesanan yang telah ditetapkan dan secara automatik mengumpul kedua-dua maklumat sistem sebagai
serta keputusan ujian. Ia juga akan menggesa pengguna untuk input apabila manual
ujian diperlukan.

Masa berjalan untuk ujian ditentukan oleh ujian yang anda buat keputusan
laksanakan. Pengguna akan berpeluang untuk menyesuaikan ujian dijalankan
menampung pemandu dan jumlah masa yang ada untuk ujian.

Untuk memulakan, hanya klik butang Teruskan di bawah dan ikuti pada skrin
arahan. "

[suite]
whitelist_filter = "^ihv-.*"

[penyerahan]
ok_btn_text = "Simpan Hasil"
input_type = "tiada"

[pengeksport]
xml_export_path = ""

[pengangkutan]
submit_to = "tempatan"

Mod teks:

#!/usr/bin/env kotak semak-pelancar
[selamat datang]
text = Selamat datang ke Canonical Driver Test Suite
Program ini mengandungi ujian automatik dan manual untuk membantu anda menemui
isu yang akan timbul semasa menjalankan pemacu peranti anda pada Ubuntu.
Aplikasi ini akan melangkah pengguna melalui ujian ini dalam a
pesanan yang telah ditetapkan dan secara automatik mengumpul kedua-dua maklumat sistem sebagai
serta keputusan ujian. Ia juga akan menggesa pengguna untuk input apabila manual
ujian diperlukan.
Masa berjalan untuk ujian ditentukan oleh ujian yang anda buat keputusan
laksanakan. Pengguna akan berpeluang untuk menyesuaikan ujian dijalankan
menampung pemandu dan jumlah masa yang ada untuk ujian.
Untuk memulakan, hanya klik butang Teruskan di bawah dan ikuti pada skrin
arahan.

[suite]
# Senarai putih dipaparkan dalam skrin pemilihan suite
whitelist_filter = ^ihv-.*
# Pemilihan_senarai putih adalah wajib jadi kami menetapkannya kepada nilai palsu
# tiada senarai putih diprapilih.
whitelist_selection = palsu

KOTAK SEMAK SIARAN PROSES

Halaman ini menerangkan langkah-langkah yang perlu untuk mengeluarkan versi Kotak Semak dan Kotak Semak
Pensijilan kepada PPA stabil milik pasukan Pensijilan Perkakasan, secara tetap
asas. Sepanjang dokumen ini, istilah 'Kotak Semak' digunakan sebagai istilah lengkap untuk dilindungi
semua versi Kotak Semak yang dimiliki oleh pasukan Pensijilan Perkakasan, pada masa ini Kotak Semak
sendiri dan sambungan Pensijilan Kotak Semak.

Gambaran Keseluruhan
Pada masa ini proses berjalan pada irama dwi-mingguan, dengan keluaran baharu Kotak Semak setiap
dua minggu. Ini meliputi sepuluh hari bekerja, dan tugas yang dijalankan pada setiap hari atau kumpulan
hari diterangkan di bawah:

· Hari 1-4: Masa dibenarkan untuk perubahan baharu dimasukkan ke dalam batang.

· Hari 5: Perubahan digabungkan daripada batang lp:kotak semak and lp:kotak semak-pensijilan kepada
cawangan keluaran masing-masing. Log perubahan untuk kedua-duanya ialah bumped pada ketika ini dan
semakan ditandakan. Pada peringkat ini mungkin juga perlu untuk menyalin pakej 'fwts'
daripada FWTS Stabil PPA <https://launchpad.net/~firmware-testing-team/+archive/ppa-
fwts-stabil> kepada Kotak semak Lepaskan Ujian PPA <https://launchpad.net/~checkbox-
dev/+archive/testing>.

· Hari 6-9: Ujian dilakukan oleh pengurus keluaran untuk Pensijilan Perkakasan
pasukan, dan wakil pasukan QA CE (pelanggan utama untuk Kotak Semak dalam
kanonik)

· Hari 9: Mesyuarat keluaran diadakan antara pengurus keluaran untuk Perkakasan
Pasukan pensijilan dan wakil pasukan QA CE. Isu yang berpotensi dengan
pelepasan dikenal pasti dan rancangan dibuat untuk menanganinya.

· Hari 10: Versi Kotak Semak yang diuji disalin ke PPA yang stabil.

Launchpad Cawangan
Proses keluaran memerlukan cawangan berasingan dalam Launchpad yang mengandungi separa beku
versi kod yang berada dalam trunk pada hari ke-5 proses. Ini supaya pembangunan
boleh meneruskan pada batang tanpa menjejaskan kestabilan versi yang akan dikeluarkan
Kotak semak. Hubungan antara semua cawangan yang terlibat dalam proses adalah seperti yang ditunjukkan di bawah:

· lp:kotak semak/keluaran <- lp:kotak semak

· lp:kotak semak-pensijilan/pelepasan <- lp:kotak semak-pensijilan

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

pengauditan mencatat kejayaan pepijat
Sebelum membuat calon keluaran, pengurus keluaran harus menyemak senarai pepijat
mencatat kejayaan untuk keluaran Kotak Semak seterusnya. Mereka patut melawat kotak semak pencapaian
<https://launchpad.net/checkbox/+milestonesmilestones> dan cari peristiwa penting yang bertarikh dengan
tarikh keluaran.

· Untuk pepijat yang ditetapkan kepada Sedang Berlangsung dengan cawangan yang berkaitan - berhubung dengan cawangan
pemilik untuk melihat sama ada penggabungan boleh diselesaikan sebelum tarikh akhir.

· Untuk pepijat yang berada dalam mana-mana status tidak tertutup lain (kecuali Menetapkan komited) - pencapaian semula
mereka ke pencapaian berikut.

Cutting yang melepaskan
Untuk memotong keluaran, kita perlu menggabungkan perubahan daripada batang ke dalam keluaran
cawangan, komit mereka dengan mesej yang sesuai dan kemas kini log perubahan dalam trunk supaya
perubahan masa hadapan mengikut versi yang betul. Bagi setiap gabungan cawangan yang ditunjukkan di atas,
lakukan perkara berikut (contoh menggunakan lp:kotak semak and lp:kotak semak/keluaran):

bzr branch lp:checkbox/release checkbox-release
cawangan bzr lp:kotak semak kotak-batang
keluaran kotak semak cd
current_stable=`head -n1 $(cari . -nama 'changelog') | grep -oP '(?<=\().*(?=\))'`
bzr merge lp:kotak semak

pada ketika ini jika tiada perubahan (selain daripada satu kepada debian/changelog) dicantumkan kemudian kita lakukan
tidak melaksanakan pelepasan pakej yang dipersoalkan. Dalam amalan ini sering berlaku dengan
pensijilan kotak semak tetapi tidak pernah dengan kotak semak:

bzr commit -m "Digabungkan dalam perubahan daripada rev$(bzr revno -r tag:$current_stable lp:checkbox) kepada rev$(bzr revno lp:checkbox) daripada lp:checkbox"
bzr tolak lp:kotak semak/lepaskan
cd `cari . -nama 'debian'`; cd..
tag bzr `head -n1 debian/changelog | grep -oP '(?<=\().*(?=\))'`
dch -r (simpan log perubahan yang diubah suai)
dch -i -U 'Incremented changelog'
debcommit
bzr tolak lp:kotak semak

Langkah terakhir dalam proses adalah untuk melaksanakan binaan pakej dalam
ppa:checkbox-dev/testing PPA. Untuk melakukan ini kita perlu pergi ke halaman resipi untuk
kotak semak dan / atau pensijilan kotak semak melepaskan cawangan.

· ujian kotak semak resipi <https://code.launchpad.net/~checkbox-dev/+recipe/checkbox-
ujian>

· kotak semak-pengujian-pensijilan resipi <https://code.launchpad.net/~checkbox-
dev/+resipi/kotak semak-pengujian-pensijilan>

. Membina Sekarang pilihan harus tersedia pada halaman. Klik untuk memulakan binaan.

Menyalin firmware ujian Suite kepada yang Ujian PPA
Alat Firmware Test Suite ialah alat ujian untuk perisian tegar sistem yang secara semula jadi berat
digunakan oleh Kotak Semak. Untuk memastikan versi terkini yang mengandungi pembetulan dan baharu
ujian/ciri yang diperlukan oleh Kotak Semak tersedia dan juga tidak memecahkan apa-apa
Kotak semak, kami perlu mengeluarkannya bersama Kotak Semak. Selepas memotong pelepasan jika
Pasukan Pengujian Perisian Tegar telah memberitahu bahawa versi baharu tersedia dan versi ini
harus digunakan untuk pensijilan, kami perlu menyalinnya ke PPA Pengujian. Untuk melakukan ini kita
perlu pergi ke Salinan pakej pandangan of yang firmware ujian Suite (Stabil) PPA
<https://launchpad.net/~firmware-testing-team/+archive/ppa-fwts-stable/+copy-packages> dan
pilih pakej 'fwts' untuk semua keluaran kembali ke Precise. Kita perlu menetapkan
'PPA Destinasi' sebagai 'Ujian Keluaran Kotak Semak [~checkbox-dev/testing]' dan 'Salin
medan pilihan kepada 'Salin binari sedia ada', kemudian klik 'Salin pakej'. Langkah ini kemudian
perlu diulang tetapi tetapkan medan 'PPA Destinasi' kepada 'PPA untuk Pembangun Kotak Semak
[~checkbox-dev/ppa]'.

Seterusnya Lepaskan of Kotak semak e-mel
Supaya semua orang berpeluang melakukan apa sahaja ujian yang diperlukan tepat pada masanya
dengan cara, selepas binaan PPA telah siap, e-mel hendaklah dihantar kepada yang berikut
senarai mel:

· [e-mel dilindungi] <pensijilan perkakasan-
[e-mel dilindungi]>

· [e-mel dilindungi] <[e-mel dilindungi]>

Kandungannya biasanya seperti ini:

Subjek: Keluaran Kotak Semak Seterusnya (18/11/2013)

Hi,

Keluaran Kotak Semak seterusnya tersedia dalam
https://code.launchpad.net/~checkbox-dev/+archive/testing PPA.
Sila uji ia mengikut keselesaan anda. Kotak pilihan adalah berdasarkan semakan 2484 daripada
lp:checkbox dan Pensijilan Kotak Semak adalah berdasarkan semakan 586 daripada
lp:kotak semak-pensijilan.

Terima kasih,

Jika satu atau satu lagi Pensijilan Kotak Semak dan Kotak Semak belum dikemas kini
tak perlu sebut pakej tu

Ujian yang melepaskan
Memandangkan keluaran telah dipotong, ujian harus dilakukan sebelum mesyuarat keluaran.
Dari sudut pandangan pasukan pensijilan, apa yang perlu diuji adalah
kotak semak-pensijilan-klien and kotak semak-pensijilan-pelayan yang menjadi asas kepada
CE QAs OEM versi khusus Kotak Semak. Pelayan pensijilan kotak semak diuji dalam
Pelanggan pensijilan Kotak Semak gelung CI perlu diuji secara manual.

Lepaskan mesyuarat
Pada hari Khamis sebelum pelepasan dibuat, satu mesyuarat diadakan antara wakil
pasukan Pensijilan dan wakil daripada Commercial Kejuruteraan QA pasukan. The
mesyuarat diadakan pada 7:30 UTC seperti yang ditunjukkan dalam ini kalendar menjemput
<https://www.google.com/calendar/hosted/canonical.com/event?action=TEMPLATE&tmeid=Y3QxcWVla3ViMTRvMXByOHZlOTFvc283Y2NfMjAxMzA4MjlUMDczMDAwWiBicmVuZGFuLmRvbmVnYW5AY2Fub25pY2FsLmNvbQ&tmsrc=brendan.donegan%40canonical.com>.
Agenda mesyuarat disertakan dalam jemputan.

Penerbitan yang melepaskan
Untuk menerbitkan keluaran kami hanya perlu menyalin beberapa pakej daripada Kotak semak
Lepaskan Ujian PPA <https://launchpad.net/~checkbox-dev/+archive/testing> kepada perkakasan
Pensijilan Awam PPA <https://launchpad.net/~hardware-certification/+archive/public>.
Untuk melakukan ini kita pergi ke Salinan pakej pandangan of yang Kotak semak Lepaskan Ujian PPA
<https://launchpad.net/~checkbox-dev/+archive/testing/+copy-packages> dan pilih semua
versi senarai pakej berikut: kotak semak, pensijilan kotak semak, fwts. Buat
pastikan medan 'PPA Destinasi' ditetapkan kepada 'PPA Awam untuk Pensijilan Perkakasan
[~hardware-certification/public]' dan medan 'Salin pilihan' ditetapkan kepada 'Salin
binari sedia ada', kemudian klik 'Salin Pakej'.

Selepas itu dilakukan e-mel pengumuman hendaklah dihantar kepada
[e-mel dilindungi] <[e-mel dilindungi]>.
Templat untuk pengumuman disertakan di bawah:

Hi,

Keluaran baharu kotak pilihan telah dimuat naik ke Perkakasan
Pensijilan PPA Awam
(https://launchpad.net/~hardware-certification/+archive/public). The
keluaran adalah berdasarkan semakan 2294 lp:kotak semak

Terima kasih,

Sila lampirkan bahagian terbaharu changelog sebagai nota keluaran

· genindex

· modindex

· carian

Gunakan checkbox-cli dalam talian menggunakan perkhidmatan onworks.net