checkbox-cli - Online di Cloud

PROGRAM:

NAMA

checkbox_ng - Dokumentasi CheckboxNG

CheckboxNG adalah alat pengujian perangkat keras yang berguna untuk mensertifikasi laptop, desktop, dan server
dengan Ubuntu. Ini adalah versi baru dari Checkbox yang dibangun langsung di atas PlainBox

Kotak centang NG menggantikan Kotak centang, jika berlaku.

PERINGATAN:
Dokumentasi sedang dalam pengembangan. Beberapa hal yang salah, tidak akurat atau menggambarkan
tujuan pembangunan daripada keadaan saat ini.

INSTALASI

CheckboxNG dapat diinstal dari PPA (disarankan) atau pypi di Ubuntu Precise (12.04) atau
lebih baru.

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

RUNNING STABIL RELEASE UPDATE UJI

CheckboxNG memiliki dukungan khusus untuk menjalankan tes pembaruan rilis stabil secara otomatis
tata krama. Ini menjalankan semua pekerjaan dari sru.daftar putih dan mengirimkan hasilnya ke
situs sertifikasi.

Untuk menjalankan tes SRU, Anda perlu mengetahui apa yang disebut ID Aman dari perangkat Anda
pengujian. Setelah Anda tahu bahwa yang perlu Anda lakukan hanyalah menjalankan:

$ kotak centang dari pengiriman $secure_id.xml

Argumen kedua, submission.xml, adalah nama file fallback yang hanya dibuat
saat mengirim data ke situs web sertifikasi gagal berfungsi karena alasan apa pun.

PELAPORAN BUG

Untuk melaporkan bug pada proyek Kotak Centang, Anda memerlukan akun landasan peluncuran. Kamu mungkin menemukan
instruksi on bagaimana untuk membuat satu <https://help.launchpad.net/YourAccount/NewAccount>
berguna. Setelah Anda memiliki akun, Anda dapat melaporkan bug <https://bugs.launchpad.net/checkbox-
proyek/+filebug>.

Pada halaman itu Anda dapat memilih proyek yang Anda inginkan untuk mengajukan bug (kami menggunakan sejumlah
proyek untuk mengoordinasikan rilis dan kami lebih suka memiliki bug yang terkait dengan yang sesuai
bagian dari Kotak Centang). Jika Anda tahu proyek yang tepat untuk digunakan, gunakan saja dan laporkan bug. Jika
Anda tidak tahu banyak kotak centang internal atau ragu, cukup arsipkan di pangkalan
Proyek 'Kotak Centang' (Anda dapat menggunakan ini langsung link
<https://bugs.launchpad.net/checkbox/+filebug>.) Seorang anggota tim pengembangan akan
tinjau bug Anda dan tetapkan kembali ke lokasi yang sesuai. Nomor bug tidak akan
berubah ketika itu terjadi.

THE KOTAK CEK TUMPUKAN

Tumpukan Kotak Centang adalah kumpulan proyek yang bersama-sama membentuk pengujian lengkap
dan solusi sertifikasi. Ini terdiri dari bagian-bagian berikut (lihat tabel di bawah untuk
rincian tambahan). Semua proyek ditautkan dari Launchpad proyek kelompok
<https://launchpad.net/checkbox-project>.

Arsitektur Diagram
[gambar: Diagram Arsitektur] [gambar]

Diagram ini berisi perkiraan tingkat tinggi dari arsitektur Kotak Centang saat ini.
Ada tiga "pilar" utama. Di sebelah kiri kita memiliki akhir produk. Itu adalah alat yang sebenarnya
sertifikasi dan insinyur yang menggunakan. Di sebelah kanan kita memiliki uji pasar. Ini
pasar terbuka dari vendor dan pemasok tes. Tes dibungkus dalam wadah yang dikenal sebagai
penyedia. Di tengah kami memiliki tiga komponen bersama. Mereka menerapkan sebagian besar dari
kerangka kerja dan antarmuka pengguna untuk eksekusi pengujian. Akhirnya di pojok kiri bawah sana
adalah bagian dari kotak centang (perpustakaan) yang dibagikan dengan HEXR untuk tugas tertentu. HEXR adalah
aplikasi web di luar cakupan yang digunakan oleh bagian dari proses sertifikasi. Panah menyiratkan
komunikasi dengan bentuk panah menunjukkan siapa memanggil siapa.

Seperti disebutkan sebelumnya, di kolom tengah ada tiga komponen utama kode bersama
(dibagikan oleh semua orang menggunakan produk akhir yang dibahas di bawah). Kode yang dibagikan adalah
terdiri dari plainbox, checkbox-ng dan checkbox-gui. Tanggung jawab komponen adalah
dibahas lebih rinci dalam tabel di bawah ini. Di sini kita dapat melihat bahwa kotak centang-gui menggunakan DBus
API diekspos oleh kotak centang-ng, yang pada gilirannya menggunakan dukungan kotak centang (pustaka pembantu
dipisahkan jadi bagikan beberapa kode dengan HEXR) dan plainbox.

Di kolom sebelah kanan ada berbagai penyedia tes. Proyek kotak centang adalah
memproduksi dan memelihara sejumlah penyedia (lihat tabel di bawah) tetapi diharapkan
bahwa pengguna hilir kami juga akan memproduksi penyedia mereka sendiri (khusus untuk pelanggan atau
proyek). Akhirnya beberapa penyedia mungkin datang dari pihak ketiga yang akan mengadopsi
Format.

Terakhir di pojok kiri bawah, perpustakaan bersama, perpustakaan ini berisi banyak parser
dari berbagai format file dan format output. Secara teknis perpustakaan ini merupakan ketergantungan dari
HEXR, kotak centang-ng dan penyedia. Sebagai kompleksitas tambahan, perpustakaan perlu dipanggil
dari kode python3 dan kode python2.

CATATAN:
Komunikasi antara checkbox-ng dan plainbox adalah dua arah. Penawaran kotak biasa
beberapa antarmuka dasar dan titik ekstensi. Itu semua diekspos melalui plainbox
(menggunakan API umum) tetapi beberapa di antaranya benar-benar diimplementasikan di kotak centang-ng.

PERINGATAN:
Semua API internal semi-tidak stabil. API DBus lebih stabil dalam praktiknya tetapi seharusnya
tidak bisa diandalkan. Proyek didorong untuk digabungkan ke lp: kotak centang di mana API
transisi dapat ditangani dengan anggun. Satu-satunya API yang stabil adalah format file
spesifikasi (definisi pekerjaan dan whitelits). Spesifikasi peluncur adalah
stabil di rilis berikutnya.

Komponen Deskripsi
┌─────────────────────────┬─────────────────────── ──────────────────┬──────────────────────────┐
Proyek Bertanggung jawab untuk Tipe
├─────────────────────────┼─────────────────────── ──────────────────┼──────────────────────────┤
Kotak Centang Generasi Berikutnya Aplikasi
(GUI) · C++/QML
antarmuka pengguna
│ │ │ │
· Grafik
peluncur untuk
penyedia, misalnya
kotak centang-sertifikasi-klien
├─────────────────────────┼─────────────────────── ──────────────────┼──────────────────────────┤
Kotak Centang Generasi Berikutnya Aplikasi
(CLI) · Baris perintah python
antarmuka
│ │ │ │
· antarmuka pengguna teks
│ │ │ │
· perintah pengujian SRU
│ │ │ │
· API sertifikasi tambahan
│ │ │ │
· mengirim data ke Launchpad
│ │ │ │
· mengirim data ke HEXR
│ │ │ │
· layanan DBus yang dibutuhkan oleh
GUI
└─────────────────────────┴─────────────────────── ──────────────────┴──────────────────────────┘

Sertifikasi Klien Penyedia
Penyedia · kanonik-sertifikasi-klien
dapat dieksekusi
│ │ │ │
· sertifikasi klien
daftar putih
├─────────────────────────┼─────────────────────── ──────────────────┼──────────────────────────┤
Sertifikasi Server Penyedia
Penyedia · sertifikasi server
daftar putih
│ │ │ │
· daftar putih server tambahan
├─────────────────────────┼─────────────────────── ──────────────────┼──────────────────────────┤
Server System-on-Chip Penyedia
Penyedia Sertifikasi · Sertifikasi server SoC
daftar putih
├─────────────────────────┼─────────────────────── ──────────────────┼──────────────────────────┤
Penyedia Kotak Centang Penyedia
· Hampir semua definisi pekerjaan
│ │ │ │
· Sebagian besar "skrip" khusus
│ │ │ │
· Default dan daftar putih SRU
├─────────────────────────┼─────────────────────── ──────────────────┼──────────────────────────┤
Penyedia Sumber Daya Penyedia
· Hampir semua pekerjaan sumber daya
│ │ │ │
· Hampir semua "skrip" sumber daya
├─────────────────────────┼─────────────────────── ──────────────────┼──────────────────────────┤
Dukungan Kotak Centang Perpustakaan
· Kode dukungan untuk berbagai
penyedia
│ │ │ │
· Parser untuk banyak format teks
├─────────────────────────┼─────────────────────── ──────────────────┼──────────────────────────┤
PlainBox Perpustakaan dan Pengembangan
· Hampir semua logika inti Toolkit
│ │ │ │
· RFC822 (definisi pekerjaan)
pengurai
│ │ │ │
· Penanganan konfigurasi
│ │ │ │
· Sesi pengujian
(tangguhkan/lanjutkan)
│ │ │ │
· Pelari pekerjaan
│ │ │ │
· Peluncur tepercaya
│ │ │ │
· Penyelesai ketergantungan
│ │ │ │
· Penanganan baris perintah
│ │ │ │
· XML, HTML dan XSLX
eksportir
│ │ │ │
· dan banyak lagi...
│ │ │ │
· Toolkit pengembangan penyedia
│ │ │ │
· 'plainbox startprovider'
│ │ │ │
· implementasi 'manage.py'
└─────────────────────────┴─────────────────────── ──────────────────┴──────────────────────────┘

Kotak Centang Legacy (tidak ada Aplikasi Monolitik
dipelihara lagi) · Aplikasi Perpustakaan dan Data
│ │ │ │
· Qt4 GUI
│ │ │ │
· Gtk2 GUI
│ │ │ │
· Urwid (teks) GUI
│ │ │ │
· Inti
│ │ │ │
· Plugin dan Acara / Pesan
Mesin
│ │ │ │
· Hampir Setiap fitur
menerapkan plugin inti
│ │ │ │
· Data
│ │ │ │
· Pekerjaan dan daftar putih
└─────────────────────────┴─────────────────────── ──────────────────┴──────────────────────────┘

CHANGELOG

CATATAN:
Changelog ini hanya berisi ringkasan perubahan. Untuk akuntansi yang lebih akurat dari
riwayat pengembangan, silakan periksa riwayat sumber secara langsung.

Kotak centang NG 0.23 (belum dirilis)
· Perbaikan kerusakan: https://launchpad.net/checkbox-ng/+milestone/0.23

Kotak centang NG 0.22
· Perbaikan kerusakan: https://launchpad.net/checkbox-ng/+milestone/0.22

Kotak centang NG 0.3
· Perbaikan kerusakan: https://launchpad.net/checkbox-ng/+milestone/0.3

Kotak centang NG 0.2
· Perbaikan kerusakan: https://launchpad.net/checkbox-ng/+milestone/0.2

Kotak centang NG 0.1
· Peluncuran pertama

· Dukungan untuk menampilkan konfigurasi

· Dukungan untuk menjalankan tes SRU (pengujian regresi otomatis)

UJI SKRIP

Tes 'skrip' adalah program kecil yang digunakan untuk membantu dalam mengimplementasikan tes.

kecerahan_test
Skrip ini menguji kecerahan lampu latar sistem dapat diubah dengan menggunakan
antarmuka kernel di /sys/class/backlight. Mungkin ada lebih dari satu antarmuka untuk dipilih
dari, sehingga antarmuka yang benar untuk digunakan dipilih dengan menggunakan heuristik yang ditentukan dalam
https://www.kernel.org/doc/Documentation/ABI/stable/sysfs-class-backlight. kecerahan
dimanipulasi dengan memperbarui file kecerahan antarmuka dan aktual_brightness
file diperiksa untuk melihat apakah nilainya diubah ke kecerahan yang dipilih.

PROFIL KONFIGURASI

Profil eksekusi, atau peluncur, memungkinkan menentukan set konfigurasi yang telah ditentukan sebelumnya
opsi yang memungkinkan penyesuaian layar selamat datang, daftar putih yang ditampilkan serta
menyimpan hasil secara lokal atau mengirim file pengiriman ke Launchpad atau ke Sertifikasi
database/HEXR, serta beberapa parameter lainnya.

Pengaturan profil adalah bagian dari skrip peluncur dan menggunakan kotak centang-gui atau
checkbox-launcher (dalam mode teks/CLI) sebagai shebang untuk menafsirkan kunci/nilai.

Dokumen ini memberikan referensi tentang fungsionalitas dan sintaks peluncur. Untuk memahami
desain dan konsep dan lihat beberapa contoh, Anda mungkin ingin membaca tutorial tentang cara
buat peluncur dan hubungannya dengan Kotak Centang lawas.

Sintaksis
Karena kotak centang-gui adalah aplikasi Qt, pengaturan harus mengikuti aturan gaya INI dari
Pengaturan Q <http://qt-project.org/doc/qt-5/QSettings.html> kelas.

Nilai beberapa baris didukung tetapi harus diapit oleh tanda kutip ganda dan baris tambahan
harus dimulai dengan satu spasi, misalnya:

[kategori]
kunci = "Halo
Dunia"

· Dari QML:

settings.value("kategori/kunci", i18n.tr("nilai_default"))

· Dari C++:

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

Sebaliknya, peluncur khusus kotak centang-peluncur harus mengikuti Ular sanca KonfigurasiParser
<https://docs.python.org/3/library/configparser.html#supported-ini-file-structure> sintaks.

Juga, beberapa pengaturan hanya masuk akal untuk GUI atau CLI, dan karenanya tidak dipahami oleh
yang lain. Ini dicatat di bawah ini.

Didukung Settings
selamat datang/judul
Judul aplikasi QML dan header layar selamat datang. Default untuk System pengujian.

selamat datang/teks
Pesan selamat datang untuk ditampilkan di layar pertama (kotak centang-gui mendukung Teks kaya
memungkinkan markup gaya HTML). Default untuk Selamat datang untuk System Pengujian. [...]

suite/daftar putih_filter
Ekspresi reguler untuk mencocokkan subset dari nama file daftar putih. Di kotak centang-gui it
default ke .*. Untuk peluncur kotak centang tidak memiliki default dan harus didefinisikan.

suite/daftar putih_pilihan
Pola yang harus dicocokkan dengan daftar putih untuk dipilih sebelumnya. Ekspresi reguler Python.
Tidak memiliki default dan harus didefinisikan. (CLI saja)

suite/skip_whitelist_selection
Jika disetel ke true, pengguna tidak akan menerima pilihan daftar putih. Hanya yang dipilih sebelumnya
yang (lihat whitelist_selection) akan dipilih. (KLI saja).

suite/lewati_test_selection
Jika disetel ke true, pengguna tidak akan diizinkan untuk membatalkan pilihan tes sebelum dijalankan: semua tes
dalam daftar putih yang dipilih akan dijalankan. (CLI saja)

pengiriman/pesan
Teks tajuk dari pop-up pengiriman, ditampilkan kepada pengguna setelah pengiriman telah
lengkap. (khusus GUI)

pengiriman/input_type
Tampilkan bidang input Teks untuk memasukkan ID aman atau alamat LP (default). Ke
simpan saja hasilnya ke disk, harus menggunakan tak satupun nilai. Untuk memvalidasi menggunakan regex,
harus regex. (khusus GUI)

pengiriman/regex
Ekspresi reguler untuk memvalidasi input di bidang pengiriman (mis. email, secure_id)
jika input_type adalah regex. (khusus GUI). RegExpValidator, default .*

kiriman/input_placeholder
Teks sementara untuk dimasukkan ke dalam kolom input, digunakan untuk memandu pengguna. Launchpad E-mail
Alamat (default) atau Aman ID (15 or 18 karakter). (khusus GUI)

pengajuan/id_aman
Secure_id yang telah dikonfigurasikan sebelumnya untuk mengisi bidang teks.

kiriman/ok_btn_text
Label untuk tombol "Kirim". Kirim Hasil (default) atau Save Hasil. (GUI
saja)

pengiriman/batalkan_peringatan
Tunjukkan kepada pengguna jika dia ingin keluar tanpa menyimpan laporan. kamu tentang
untuk keluar dari uji coba ini tanpa menyimpan laporan hasil Anda. Apakah Anda ingin menyimpan
laporan? (khusus GUI)

penyerahan/kirim_ke_hexr
Boolean, tambahkan header tambahan untuk juga mengirim hasilnya ke HEXR (berfungsi dengan
transportasi sertifikasi)

eksportir/xml_export_path
Lokasi untuk menyimpan file pengiriman XML, jika disetel ke string kosong akan terbuka
dialog penyimpanan file. Bawaan: /tmp/submission.xml (khusus GUI)

transportasi/kirim_ke
Titik akhir transportasi. Default untuk . Mendukung pengiriman ke LP (default,
nilai landasan peluncuran), sertifikasi, atau lokal (simpan ke disk)

transport/kirim_url
URL untuk mengirimkan hasil. Ini memungkinkan untuk mengunggah ke situs web yang berbeda, misalnya
itu dapat mengunggah langsung ke hexr, atau ke situs pementasan. Digunakan hanya dengan
sertifikasi kirim_ke nilai.

transport/config_nama file
Nama file konfigurasi khusus yang akan dimuat. File konfigurasi terutama digunakan untuk mendefinisikan
variabel lingkungan. (CLI saja)

transport/dont_suppress_output
Jika disetel, sumber daya, pekerjaan lokal, dan lampiran akan ditampilkan ke layar, ini
menghasilkan banyak teks dan terutama untuk debugging. (CLI saja)

KOTAK CEK / KOTAK POLOS PELUNCUR TUTORIAL

Dokumen ini memberikan penjelasan mengapa peluncur diperlukan, apa yang dapat Anda capai
dengan mereka, dan membahas beberapa contoh untuk lebih menggambarkan kemampuan mereka. Untuk sebuah
referensi terperinci tentang pengaturan mana yang didukung oleh peluncur, dan sintaks khusus untuk
file peluncur, lihat /profil.

Warisan kotak centang laku kontrol
Di masa lalu, perilaku Kotak centang dikendalikan oleh tiga mekanisme.

Pertama, fungsi kotak centang dapat ditambah dengan menambahkan plugin. Misalnya,
kemampuan untuk mengirimkan ke situs web sertifikasi ditambahkan oleh paket sertifikasi kotak centang
menggunakan plugin. Plugin yang disertakan oleh sertifikasi kotak centang dan yang menambahkan perilaku baru
ke kotak centang dasar adalah:

/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 menambahkan cara untuk meminta pengguna untuk mengirimkan data spesifik, menghasilkan xml
laporan, dan fungsi lainnya.

Selanjutnya, perilaku plugin dapat dikonfigurasi atau dikontrol menggunakan konfigurasi
file, yang "berjenjang". File konfigurasi dapat menyertakan yang lain dan itu pada gilirannya
termasuk orang lain.

Ini adalah contoh file konfigurasi utama project-qt.ini khusus proyek. Ini yang pertama
file dibaca ketika klien khusus proyek diluncurkan. Beberapa pengaturan disingkat:

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

[kotak centang/plugin/info_lingkungan]
repositori = deb http://.*\(arsip\|keamanan\).ubuntu.com/ubuntu presisi-keamanan
router = banyak
server_iperf = 10.20.30.40
sumber_daftar = / Etc / apt / sources.list
wpa_n_psk = kata sandi
wpa_n_ssid = titik akses

[kotak centang/plugin/user_interface]
title = Pengujian Sistem proyek saya

Perhatikan baris include, ini menginstruksikannya untuk memuat file konfigurasi untuk
checkbox-project-base-qt dan checkbox-project-base. Kotak centang-proyek-basis-qt memuat
konfigurasi untuk sertifikasi kotak centang dan proyek kotak centang. Pengaturan mengalir sehingga
opsi konfigurasi di dekat bagian atas menimpa yang di dekat bagian bawah.

Akhirnya, "biner" yang digunakan untuk memanggil kotak centang adalah skrip shell yang menentukan di mana menemukan
kotak centang hal-hal yang perlu dijalankan: Anda dapat menentukan direktori berbagi, data tertentu
direktori, arahkan ke file konfigurasi dan tentukan beberapa variabel lingkungan yang Anda
mungkin perlu selama pengujian. Berikut ini contoh untuk kotak centang-proyek-qt:

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

# Kenyamanan untuk mendefinisikan direktori PYTHONPATH.
if [ "$CHECKBOX_SHARE" != "/usr/share/checkbox" ]; kemudian
ekspor PYTHONPATH="$CHECKBOX_SHARE:$PYTHONPATH"
fi

python3 $CHECKBOX_SHARE/jalankan "$@" $CHECKBOX_PROJECT_SHARE/configs/$(nama dasar $0).ini

Di sini Anda dapat melihat bahwa itu mendefinisikan beberapa lokasi dan bagian penting adalah python3 terakhir
baris, di mana ia akan mencari dan menggunakan file konfigurasi .ini yang diperlukan yang kita lihat sebelumnya.

Organisasi hierarkis ini sangat kuat tetapi juga sulit untuk ditangani, dan
juga memiliki beberapa keterbatasan. Bagian dari pekerjaan yang kami lakukan dengan kotak centang adalah mengintegrasikan semua
plugin khusus proyek ke batang kotak centang, dengan cara ini semua kode inti ada di satu tempat,
dan varian khusus proyek hanya menyediakan pekerjaan, daftar putih, data, dan konfigurasi,
tanpa menambahkan perilaku baru.

New kotak biasa laku kontrol
Tidak seperti kotak centang, inti plainbox bersifat monolitik, dan tidak memiliki konsep plugin. Ini
membuatnya lebih mudah untuk dipahami dan dikerjakan. Inti plainbox memiliki implementasi untuk semua
fungsi dalam paket kotak centang lama, jadi tidak diperlukan tambahan untuk menggunakan fitur
seperti pengajuan sertifikasi atau pembuatan laporan.

Apa yang kami sebut plainbox adalah perpustakaan yang mengimplementasikan semua fungsi, seperti yang dapat dilihat
di sini.

Plainbox menyediakan alat untuk membantu pengembang pengujian menulis dan mengemas pengujian. Ini adalah
disampaikan dalam "penyedia", yang merupakan entitas yang dirancang untuk merangkum deskripsi pengujian,
skrip khusus untuk pengujian, daftar putih, dan berbagai macam data. Mereka dirancang untuk memungkinkan
tim untuk menulis dan memberikan tes khusus mereka tanpa terlalu khawatir tentang
kode plainbox yang mendasarinya.

Untuk mendapatkan informasi tentang cara menulis tes dan penyedia, lihat Tutorial Penyedia

Namun, ketika benar-benar menggunakan tes ini untuk memverifikasi sistem nyata, kami ingin memberikan
sesuatu yang lebih mudah dan lebih dekat dengan pengalaman pengguna kotak centang. Kami membuat dua klien,
checkbox-gui dan checkbox-cli, yang memiliki beberapa perilaku hardcode, dan kami juga memulai
menciptakan klien lain yang didasarkan pada ini tetapi tujuan tertentu. Contohnya,
kami memiliki versi kotak centang untuk pengujian SRU, versi lain untuk sertifikasi server, dan seterusnya.

Tapi kemudian kami menyadari bahwa banyak kode yang diduplikasi dan perilakunya umum
kecuali beberapa perubahan. Jadi kami datang dengan konsep "peluncur", yaitu
agak mirip dengan file konfigurasi kotak centang dan peluncur skrip shell.

Idenya adalah bahwa checkbox-gui dan checkbox-cli memiliki beberapa perilaku yang sangat mendasar, karena mereka
adalah klien yang dikirimkan secara default dengan ubuntu. Mereka dapat menunjukkan semua yang tersedia
daftar putih, tampilkan pesan selamat datang yang telah ditentukan, dan pada akhirnya akan membiarkan pengguna melihat
html laporkan dan kirimkan ke launchpad menggunakan alamat email mereka, mirip dengan versi
kotak centang yang dikirimkan bersama Ubuntu.

Alih-alih menggunakan sakelar baris perintah yang rumit, peluncur memungkinkan Anda untuk mengonfigurasi beberapa
perilaku opsional untuk menyesuaikan pengalaman pengujian Anda. Peluncur berisi pengaturan, dan
mirip dengan skrip Shell, tetapi penerjemahnya akan berupa kotak centang-gui atau
kotak centang-peluncur.

Berikut adalah beberapa contoh yang dapat dilakukan dengan peluncur.

Sebagai kejutan, kotak centang-cli itu sendiri adalah peluncur:

#!/usr/bin/env kotak-peluncur
[Selamat datang]
teks = Selamat datang di Pengujian Sistem!
Kotak centang menyediakan tes untuk mengonfirmasi bahwa sistem Anda berfungsi dengan benar.
Setelah Anda selesai menjalankan tes, Anda dapat melihat laporan ringkasan untuk
sistem anda.
Peringatan: Beberapa tes dapat menyebabkan sistem Anda membeku atau menjadi
tidak responsif. Harap simpan semua pekerjaan Anda dan tutup semua pekerjaan lainnya
aplikasi sebelum memulai proses pengujian.

[rangkaian]
daftar putih_filter = ^default$
daftar putih_pilihan = ^default$
skip_whitelist_selection = Benar

[mengangkut]
submit_to = landasan peluncuran

Anda dapat melihat di sini kami menyesuaikan beberapa opsi: ini menunjukkan pesan selamat datang, secara otomatis
memilih daftar putih default, dan akan mengirimkan ke launchpad setelah selesai.

Contoh peluncur grafis adalah klien sertifikasi kanonik.

#!/usr/bin/checkbox-gui

[Selamat datang]
judul = "Sertifikasi Sistem"
teks = " Selamat datang di Sertifikasi Sistem! Aplikasi ini akan
mengumpulkan informasi dari sistem Anda. Kemudian Anda akan diminta tes manual untuk
mengkonfirmasi bahwa sistem bekerja dengan benar. Akhirnya, Anda akan diminta
ID Aman komputer untuk mengirimkan informasi ke sertifikasi
basis data. Untuk mempelajari cara membuat atau menemukan ID Aman,
silakan lihat di sini: sertifikasi.canonical.com "

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

[pengajuan]
input_type = "regex"
input_placeholder = "ID Aman (15 atau 18 karakter)"
ok_btn_text = "Kirim Hasil"
submit_to_hexr = "benar"

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

[mengangkut]
submit_to = "sertifikasi"

Peluncur grafis sedikit lebih rumit, tetapi pada dasarnya mirip, apa itu
memungkinkan Anda untuk menentukan beberapa parameter untuk menyesuaikan pengalaman pengujian Anda.

Peluncur mode teks yang sangat sederhana adalah koleksi kanonik-hw yang hanya menjalankan dasar
pengujian informasi perangkat keras dan mengunggahnya ke database perangkat keras:

[Selamat datang]
judul = Mengumpulkan informasi perangkat keras
teks = Mengumpulkan informasi perangkat keras. Anda mungkin dimintai kata sandi.
Proses ini akan memakan waktu sekitar 30 detik dan Anda akan diberikan
dengan URL tempat Anda dapat mengonfirmasi dan mendaftarkan perangkat keras Anda
pengajuan.

[rangkaian]
whitelist_filter = ^hwkirim$
whitelist_selection = ^hwkirim$
skip_whitelist_selection = Benar
skip_test_selection = Benar

[pengajuan]
# Secure_id palsu memastikan kami tidak menanyakannya
# Itu selalu dapat diganti dalam file .conf.
id_aman = 000

[mengangkut]
submit_to = sertifikasi
kirim_url = https://hardware-server.example.com/

Akhirnya, canonical-driver-test-suite menyediakan peluncur mode grafis dan teks,
yang secara fungsional setara:

#!/usr/bin/checkbox-gui

[Selamat datang]
title = "Ruang Tes Pengemudi Kanonik"
teks = " Selamat datang di Canonical Driver Test Suite.

Program ini berisi pengujian otomatis dan manual untuk membantu Anda menemukan
masalah yang akan muncul saat menjalankan driver perangkat Anda di Ubuntu.

Aplikasi ini akan memandu pengguna melalui tes ini dalam a
pesanan yang telah ditentukan dan secara otomatis mengumpulkan kedua informasi sistem sebagai
serta hasil tes. Ini juga akan meminta pengguna untuk memasukkan saat manual
pengujian diperlukan.

Waktu berjalan untuk tes ditentukan oleh tes mana yang Anda putuskan untuk
menjalankan. Pengguna akan memiliki kesempatan untuk menyesuaikan uji coba ke
mengakomodasi pengemudi dan jumlah waktu yang tersedia untuk pengujian.

Untuk memulai, cukup klik tombol Lanjutkan di bawah dan ikuti layar
instruksi. "

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

[pengajuan]
ok_btn_text = "Simpan Hasil"
input_type = "tidak ada"

[eksportir]
xml_ekspor_jalur = ""

[mengangkut]
submit_to = "lokal"

Modus teks:

#!/usr/bin/env kotak-peluncur
[Selamat datang]
teks = Selamat datang di Canonical Driver Test Suite
Program ini berisi pengujian otomatis dan manual untuk membantu Anda menemukan
masalah yang akan muncul saat menjalankan driver perangkat Anda di Ubuntu.
Aplikasi ini akan memandu pengguna melalui tes ini dalam a
pesanan yang telah ditentukan dan secara otomatis mengumpulkan kedua informasi sistem sebagai
serta hasil tes. Ini juga akan meminta pengguna untuk memasukkan saat manual
pengujian diperlukan.
Waktu berjalan untuk tes ditentukan oleh tes mana yang Anda putuskan untuk
menjalankan. Pengguna akan memiliki kesempatan untuk menyesuaikan uji coba ke
mengakomodasi pengemudi dan jumlah waktu yang tersedia untuk pengujian.
Untuk memulai, cukup klik tombol Lanjutkan di bawah dan ikuti layar
petunjuk.

[rangkaian]
# Daftar putih ditampilkan di layar pemilihan suite
daftar putih_filter = ^ihv-.*
# Whitelist_selection adalah wajib jadi kami menyetelnya ke nilai palsu jadi
# tidak ada daftar putih yang dipilih sebelumnya.
whitelist_selection = palsu

KOTAK CEK RELEASE PROSES

Halaman ini menjelaskan langkah-langkah yang diperlukan untuk merilis versi Kotak Centang dan Kotak Centang
Sertifikasi ke PPA stabil milik tim Sertifikasi Perangkat Keras, secara teratur
dasar. Di seluruh dokumen ini, istilah 'Kotak Centang' digunakan sebagai istilah umum untuk mencakup
semua versi Kotak Centang yang dimiliki oleh tim Sertifikasi Perangkat Keras, saat ini Kotak Centang
itu sendiri dan ekstensi Sertifikasi Kotak Centang.

Ringkasan
Saat ini proses berjalan pada irama dua mingguan, dengan rilis baru dari Kotak Centang setiap
dua minggu. Ini mencakup sepuluh hari kerja, dan tugas-tugas yang dilakukan pada setiap hari atau kelompok
hari dijelaskan di bawah ini:

· Hari 1-4: Waktu yang diperbolehkan untuk perubahan baru untuk dimasukkan ke dalam trunk.

· Hari 5: Perubahan digabungkan dari batang lp: kotak centang dan lp: sertifikasi kotak centang untuk
cabang rilis masing-masing. Log perubahan untuk keduanya adalah terbentur pada titik ini dan
revisi ditandai. Pada tahap ini mungkin juga perlu menyalin paket 'fwts'
dari FWTS Stabil PPA <https://launchpad.net/~firmware-testing-team/+archive/ppa-
fwts-stabil> ke kotak centang Lepaskan pengujian PPA <https://launchpad.net/~checkbox-
dev/+arsip/pengujian>.

· Hari 6-9: Pengujian dilakukan oleh manajer rilis untuk Sertifikasi Perangkat Keras
tim, dan perwakilan dari tim CE QA (pelanggan utama untuk Kotak Centang dalam
Resmi)

· Hari 9: Rapat rilis diadakan antara manajer rilis untuk Perangkat Keras
Tim sertifikasi dan perwakilan tim QA CE. Potensi masalah dengan
rilis diidentifikasi dan rencana dibuat untuk mengatasinya.

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

Launchpad Cabang
Proses rilis membutuhkan cabang terpisah di Launchpad yang berisi semi-beku
versi kode yang ada di trunk pada hari ke 5 proses. Ini agar pembangunan
dapat melanjutkan di bagasi tanpa membahayakan stabilitas versi yang akan dirilis
Kotak centang. Hubungan antara semua cabang yang terlibat dalam proses adalah seperti yang ditunjukkan di bawah ini:

· lp: kotak centang/rilis <- lp: kotak centang

· lp:checkbox-sertifikasi/rilis <- lp: sertifikasi kotak centang

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

Audit tonggak sejarah bug
Sebelum membuat kandidat rilis, manajer rilis harus meninjau daftar bug
tonggak untuk rilis berikutnya dari Kotak Centang. Mereka harus mengunjungi kotak centang tonggak
<https://launchpad.net/checkbox/+milestonesmilestones> dan temukan tonggak bersejarah dengan
tanggal rilis.

· Untuk bug yang disetel ke Sedang Berlangsung dengan cabang yang terkait - berhubungan dengan cabang
pemilik untuk melihat apakah penggabungan dapat diselesaikan sebelum batas waktu.

· Untuk bug yang berada dalam status tidak tertutup lainnya (kecuali Memperbaiki berkomitmen) - pencapaian ulang
mereka ke tonggak berikutnya.

Pemotongan itu melepaskan
Untuk memotong rilis, kita harus menggabungkan perubahan dari trunk ke rilis
cabang, komit dengan pesan yang sesuai dan perbarui changelog di bagasi sehingga
perubahan masa depan pergi di bawah versi yang benar. Untuk setiap kombinasi cabang yang ditunjukkan di atas,
lakukan hal berikut (contoh menggunakan lp: kotak centang dan lp: kotak centang/rilis):

cabang bzr lp: kotak centang/rilis kotak centang-rilis
bzr cabang lp: kotak centang kotak centang-batang
rilis kotak centang cd
current_stable=`head -n1 $(temukan . -nama 'changelog') | grep -oP '(?<=\().*(?=\))'`
bzr gabungkan lp: kotak centang

pada titik ini jika tidak ada perubahan (selain satu untuk debian/changelog) bergabung maka kita lakukan
tidak melakukan rilis paket yang dimaksud. Dalam prakteknya hal ini sering terjadi dengan
sertifikasi kotak centang tapi tidak pernah dengan kotak centang:

bzr commit -m "Digabungkan dalam perubahan dari rev$(bzr revno -r tag:$current_stable lp:checkbox) ke rev$(bzr revno lp:checkbox) dari lp:checkbox"
bzr push lp: kotak centang/rilis
cd `temukan . -nama 'debian'`; cd ..
tag bzr `head -n1 debian/changelog | grep -oP '(?<=\().*(?=\))'`
dch -r (menyimpan changelog yang dimodifikasi)
dch -i -U 'Penambahan log perubahan'
komitmen
bzr push lp: kotak centang

Langkah terakhir dalam proses ini adalah melakukan pembangunan paket-paket di
ppa: kotak centang-dev/pengujian PPA. Untuk melakukan ini, kita perlu pergi ke halaman resep untuk
kotak centang dan / atau sertifikasi kotak centang melepaskan cabang.

· pengujian kotak centang resep <https://code.launchpad.net/~checkbox-dev/+recipe/checkbox-
pengujian>

· kotak centang-sertifikasi-pengujian resep <https://code.launchpad.net/~checkbox-
dev/+resep/checkbox-certification-testing>

Grafik Membangun Sekarang pilihan harus tersedia di halaman. Klik untuk memulai membangun.

Penyalinan firmware uji Rangkaian untuk itu pengujian PPA
Alat Firmware Test Suite adalah alat uji untuk firmware sistem yang secara alami sangat
digunakan oleh Kotak centang. Untuk memastikan versi terbaru yang berisi perbaikan dan baru
tes/fitur yang dibutuhkan oleh Kotak centang tersedia dan juga tidak merusak apa pun
Kotak centang, kita perlu melepaskannya bersama Kotak centang. Setelah memotong rilis jika
Tim Pengujian Firmware telah memberi tahu bahwa versi baru telah tersedia dan versi ini
harus digunakan untuk sertifikasi, kita perlu menyalinnya ke PPA Pengujian. Untuk melakukan ini kita
harus pergi ke Copy paket melihat of itu firmware uji Rangkaian (Stabil) PPA
<https://launchpad.net/~firmware-testing-team/+archive/ppa-fwts-stable/+copy-packages> dan
pilih paket 'fwts' untuk semua rilis kembali ke Precise. Kita perlu mengatur
'PPA Tujuan' sebagai 'Pengujian Rilis Kotak Centang [~checkbox-dev/testing]' dan 'Salin
pilihan' ke 'Salin binari yang ada', lalu klik 'Salin paket'. Langkah ini kemudian
perlu diulang tetapi setel bidang 'PPA Tujuan' ke 'PPA untuk Pengembang Kotak Centang
[~kotak centang-dev/ppa]'.

Selanjutnya Lepaskan of kotak centang email
Sehingga setiap orang memiliki kesempatan untuk melakukan pengujian apa pun yang diperlukan secara tepat waktu
cara, setelah pembuatan PPA selesai, email harus dikirim ke yang berikut:
Daftar surat:

· [email dilindungi] <sertifikasi-perangkat keras-
[email dilindungi]>

· [email dilindungi] <[email dilindungi]>

Isinya biasanya seperti ini:

Perihal: Rilis Selanjutnya dari Kotak Centang (18/11/2013)

Hai,

Rilis Checkbox berikutnya tersedia di
https://code.launchpad.net/~checkbox-dev/+archive/testing PPA.
Silakan mengujinya pada kenyamanan Anda. Kotak centang didasarkan pada revisi 2484 dari
lp:kotak centang dan Sertifikasi Kotak Centang didasarkan pada revisi 586 dari
lp: sertifikasi kotak centang.

Terima kasih,

Jika satu atau yang lain dari Sertifikasi Kotak Centang dan Kotak Centang belum diperbarui, maka
tidak perlu menyebutkan paket itu

pengujian itu melepaskan
Sekarang rilis telah dipotong, pengujian harus dilakukan sebelum pertemuan rilis.
Dari sudut pandang tim sertifikasi, yang perlu diuji adalah
kotak centang-sertifikasi-klien dan kotak centang-sertifikasi-server yang menjadi dasar untuk
CE QAs OEM versi khusus dari Kotak Centang. Server sertifikasi kotak centang diuji di
CI loop klien sertifikasi Kotak centang perlu diuji secara manual.

Lepaskan Pertemuan
Pada hari Kamis sebelum perilisan dilakukan, diadakan pertemuan antara perwakilan dari
tim Sertifikasi dan perwakilan dari Komersial Teknik QA tim. Itu
pertemuan diadakan pada 7:30 UTC seperti yang ditunjukkan pada ini kalender mengundang
<https://www.google.com/calendar/hosted/canonical.com/event?action=TEMPLATE&tmeid=Y3QxcWVla3ViMTRvMXByOHZlOTFvc283Y2NfMjAxMzA4MjlUMDczMDAwWiBicmVuZGFuLmRvbmVnYW5AY2Fub25pY2FsLmNvbQ&tmsrc=brendan.donegan%40canonical.com>.
Agenda rapat dicantumkan dalam undangan.

Penerbitan itu melepaskan
Untuk mempublikasikan rilis, kita hanya perlu menyalin sejumlah paket dari kotak centang
Lepaskan pengujian PPA <https://launchpad.net/~checkbox-dev/+archive/testing> ke Perangkat keras
Sertifikasi Publik PPA <https://launchpad.net/~hardware-certification/+archive/public>.
Untuk melakukan ini, kita pergi ke Copy paket melihat of itu kotak centang Lepaskan pengujian PPA
<https://launchpad.net/~checkbox-dev/+archive/testing/+copy-packages> dan pilih semua
versi dari daftar paket berikut: kotak centang, sertifikasi kotak centang, fwts. Membuat
pastikan bidang 'PPA Tujuan' disetel ke 'PPA Publik untuk Sertifikasi Perangkat Keras
[~sertifikasi perangkat keras/publik]' dan bidang 'Opsi penyalinan' disetel ke 'Salin
biner yang ada', lalu klik 'Salin Paket'.

Setelah itu selesai, email pengumuman harus dikirim ke
[email dilindungi] <[email dilindungi]>.
Sebuah template untuk pengumuman di termasuk di bawah ini:

Hai,

Rilis baru kotak centang telah diunggah ke Perangkat Keras
Sertifikasi PPA Publik
(https://launchpad.net/~hardware-certification/+archive/public). NS
rilis didasarkan pada revisi 2294 dari lp: kotak centang

Terima kasih,

Harap lampirkan bagian terbaru dari changelog sebagai catatan rilis

· indeks gen

· indeks mod

· Cari

Gunakan checkbox-cli online menggunakan layanan onworks.net