checkbox-cli - 云端在线

程序：

您的姓名

checkbox_ng - CheckboxNG 文档

CheckboxNG 是一种硬件测试工具，可用于认证笔记本电脑、台式机和服务器
与 Ubuntu。 它是直接建立在 PlainBox 之上的 Checkbox 的新版本

复选框NG 取代 复选框（如适用）。

警告：
文档正在开发中。 有些事情是错误的、不准确的或描述的
发展目标而不是现状。

安装

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.白名单 并将结果发送到
认证网站。

要运行 SRU 测试，您需要知道您所在设备的所谓安全 ID
测试。 一旦你知道你需要做的就是运行：

$ checkbox sru $secure_id submit.xml

第二个参数 submit.xml 是仅创建的回退文件的名称
当发送数据到认证网站由于任何原因无法正常工作时。

REPORTING BUGS

要报告 Checkbox 项目的错误，您需要一个启动板帐户。 你可能会发现
说明 on 形成一种 至 创建信息图 一种 <https://help.launchpad.net/YourAccount/NewAccount>
有用。 拥有帐户后，您可以 报告 虫子 <https://bugs.launchpad.net/checkbox-
项目/+文件错误>.

在该页面上，您可以选择要在其上提交错误的项目（我们使用许多
项目来协调发布，我们更喜欢将错误与适当的相关联
复选框的一部分）。 如果您知道要使用的正确项目，只需使用它并提交错误即可。 如果
您不太了解 Checkbox 内部结构，或者有疑问，只需将其归档在基础上
“复选框”项目（您可以使用 Free Introduction 直接 链接
<https://bugs.launchpad.net/checkbox/+filebug>.) 开发团队的一名成员将
检查您的错误并将其重新分配到适当的位置。 错误号不会
当这种情况发生时改变。

“ 复选框 STACK

Checkbox Stack 是一组项目，它们共同构成了一个完整的测试
和认证解决方案。 它由以下部分组成（见下表）
额外的细节）。 所有项目都链接到 快速启动 项目 组
<https://launchpad.net/checkbox-project>.

建筑 图
[图片：架构图] [图片]

此图包含当前 Checkbox 架构的高级近似。
有三个主要的“支柱”。 在左边我们有 结束 产品及技术. 这些是实际的工具
该认证和工程师正在使用。 在右边我们有 test 市场。 这是
测试供应商和供应商的开放市场。 测试被包装在称为
提供者。 在中心，我们有三个共享组件。 那些实现了大部分
用于测试执行的框架和用户界面。 最后在左下角那里
是复选框（库）的一部分，与 HEXR 共享用于某些任务。 HEXR 是一个
认证过程中使用的范围外 Web 应用程序。 箭头表示
通信用箭头的形状显示谁呼叫谁。

如前所述，在中间列中有共享代码的三个主要组件
（由使用下面讨论的最终产品的每个人共享）。 共享代码是
由plainbox、checkbox-ng 和checkbox-gui 组成。 组件职责是
在下表中更详细地讨论。 在这里我们可以看到checkbox-gui使用了DBus
由 checkbox-ng 公开的 API，它反过来使用 checkbox-support（一个帮助库
分离出来所以与HEXR共享一些代码）和plainbox。

在右侧栏中有各种测试提供者。 复选框项目是
生产和维护一些提供者（见下表）但预计
我们的下游用户也将生产他们自己的供应商（特定于客户或
项目）。 最终，一些提供者可能来自将采用
格式。

最后在左下角，共享库，这个库包含很多解析器
各种文件格式和输出格式。 从技术上讲，这个库是一个依赖
HEXR，复选框-ng 和 的提供者。 作为增加的复杂性，需要调用库
来自python3代码和python2代码。

注意:
checkbox-ng 和 plainbox 之间的通信是双向的。 Plainbox 提供
一些基本接口和扩展点。 这些都是通过plainbox暴露出来的
（使用通用 API）但其中一些实际上是在 checkbox-ng 中实现的。

警告：
所有内部 API 都是半不稳定的。 DBus API 在实践中更稳定，但应该
不被依赖。 鼓励项目合并到 lp:checkbox where API
可以优雅地处理转换。 唯一稳定的 API 是文件格式
规范（工作定义和白灯）。 启动器规范将是
在下一个版本中稳定下来。

元件 描述
┌────────────────────────────┬──────────────────────── ────────────────────┬────────────────────────────┐
│项目│负责│类型│
├────────────────────────────┼──────────────────────── ──────────────────┼────────────────────────────┤
│下一代复选框 │ │ 应用 │
│(GUI) │ · C++/QML │ │
│ │ 用户界面 │ │
│ │ │ │
│ │ · 图形化 │ │
│ │ 启动器 │ │
│ │ 供应商，例如 │ │
│ │ 复选框认证客户端 │ │
├────────────────────────────┼──────────────────────── ──────────────────┼────────────────────────────┤
│下一代复选框 │ │ 应用 │
│(CLI) │ · python 命令行 │ │
│ │ 界面 │ │
│ │ │ │
│ │·文本用户界面│ │
│ │ │ │
│ │ · SRU 测试命令 │ │
│ │ │ │
│ │ · 附加认证API │ │
│ │ │ │
│ │ · 发送数据到 Launchpad │ │
│ │ │ │
│ │ · 发送数据到HEXR │ │
│ │ │ │
│ │ · │ │ 所需要的DBus服务
│ │ 图形界面 │ │
└────────────────────────────┴──────────────────────── ──────────────────┴────────────────────────────┘

│客户认证 │ │ 供应商 │
│提供者 │ · canonical-certification-client │ │
│ │ 可执行文件 │ │
│ │ │ │
│ │ · 客户认证│ │
│ │ 白名单 │ │
├────────────────────────────┼──────────────────────── ──────────────────┼────────────────────────────┤
│服务器认证 │ │ 供应商 │
│提供商│·服务器认证││
│ │ 白名单 │ │
│ │ │ │
│ │ · 附加服务器白名单 │ │
├────────────────────────────┼──────────────────────── ──────────────────┼────────────────────────────┤
│片上系统服务器 │ │ 供应商 │
│认证提供商│·SoC服务器认证││
│ │ 白名单 │ │
├────────────────────────────┼──────────────────────── ──────────────────┼────────────────────────────┤
│复选框提供者 │ │ 提供者 │
│ │ · 几乎所有的工作定义 │ │
│ │ │ │
│ │ · 大多数自定义“脚本” │ │
│ │ │ │
│ │ · 默认和 SRU 白名单 │ │
├────────────────────────────┼──────────────────────── ──────────────────┼────────────────────────────┤
│资源提供者 │ │ 提供者 │
│ │ · 几乎所有的资源工作 │ │
│ │ │ │
│ │ · 几乎所有资源“脚本” │ │
├────────────────────────────┼──────────────────────── ──────────────────┼────────────────────────────┤
│复选框支持 │ │ 库 │
│ │ · 各种支持代码 │ │
│ │ 供应商 │ │
│ │ │ │
│ │ · 多种文本格式的解析器 │ │
├────────────────────────────┼──────────────────────── ──────────────────┼────────────────────────────┤
│PlainBox │ │ 库与开发 │
│ │ · 几乎所有的核心逻辑 │ Toolkit │
│ │ │ │
│ │ · RFC822（工作定义）│ │
│ │ 解析器 │ │
│ │ │ │
│ │ · 配置处理 │ │
│ │ │ │
│ │ · 测试环节 │ │
│ │（暂停/恢复）│ │
│ │ │ │
│ │ · 求职者 │ │
│ │ │ │
│ │ · 值得信赖的启动器 │ │
│ │ │ │
│ │ · 依赖解析器 │ │
│ │ │ │
│ │ · 命令行处理 │ │
│ │ │ │
│ │ · XML、HTML 和 XSLX │ │
│ │ 出口商 │ │
│ │ │ │
│ │ · 还有更多... │ │
│ │ │ │
│ │ · 提供商开发工具包 │ │
│ │ │ │
│ │ · 'plainbox startprovider' │ │
│ │ │ │
│ │ · 'manage.py' 实现 │ │
└────────────────────────────┴──────────────────────── ──────────────────┴────────────────────────────┘

│Legacy Checkbox（无 │ │ Monolithic Application │
│长期维护) │ · 应用程序 │ 图书馆和数据 │
│ │ │ │
│ │ · Qt4 图形用户界面 │ │
│ │ │ │
│ │ · Gtk2 图形用户界面 │ │
│ │ │ │
│ │ · Urwid（文本）GUI │ │
│ │ │ │
│ │ · 核心 │ │
│ │ │ │
│ │ · 插件和事件/消息 │ │
│ │ 发动机 │ │
│ │ │ │
│ │ · 几乎所有功能 │ │
│ │ 实现了一个核心插件 │ │
│ │ │ │
│ │ · 数据 │ │
│ │ │ │
│ │ · 工作和白名单 │ │
└────────────────────────────┴──────────────────────── ──────────────────┴────────────────────────────┘

CHANGELOG

注意:
此更改日志仅包含更改摘要。 为了更准确的记账
开发历史请直接查看源码历史。

复选框NG 0.23 （未发行）
· Bug修复： https://launchpad.net/checkbox-ng/+milestone/0.23

复选框NG 0.22
· Bug修复： https://launchpad.net/checkbox-ng/+milestone/0.22

复选框NG 0.3
· Bug修复： https://launchpad.net/checkbox-ng/+milestone/0.3

复选框NG 0.2
· Bug修复： https://launchpad.net/checkbox-ng/+milestone/0.2

复选框NG 0.1
· 初始发行

· 支持显示配置

· 支持运行SRU测试（自动回归测试）

测试 脚本

测试“脚本”是用于帮助实施测试的小程序。

亮度测试
此脚本测试系统背光的亮度可以通过使用
/sys/class/backlight 中的内核接口。 可能有多个界面可供选择
来自，因此通过使用中规定的启发式选择要使用的正确接口
https://www.kernel.org/doc/Documentation/ABI/stable/sysfs-class-backlight. 亮度
通过更新界面的亮度文件和 actual_brightness 来操作
检查文件以查看该值是否已修改为选定的亮度。

PROFILES 配置

执行配置文件或启动器，允许指定一组预定义的配置
允许自定义欢迎屏幕、显示的白名单以及
在本地保存结果或将提交文件发送到 Launchpad 或 Certification
数据库/HEXR，以及其他一些参数。

配置文件设置是启动程序脚本的一部分，并使用 checkbox-gui 或
checkbox-launcher（在文本模式/CLI 中）作为解释键/值的shebang。

本文档提供了有关启动器功能和语法的参考。 要了解
设计和概念并查看几个示例，您可能需要阅读 教程 关于如何
创建启动器及其与旧版 Checkbox 的关系。

句法
由于 checkbox-gui 是 Qt 应用程序，因此设置必须遵循
Q设置 <http://qt-project.org/doc/qt-5/QSettings.html> 班级。

支持多行值，但必须用双引号和额外的行括起来
必须以一个空格开头，例如：

[类别]
key = "你好
世界”

·来自QML：

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

· 来自 C++：

设置->值（“类别/键”，app.tr（“default_value”））

相反，复选框启动器特定的启动器必须遵循 蟒蛇 配置解析器
<https://docs.python.org/3/library/configparser.html#supported-ini-file-structure> 语法。

此外，某些设置仅对 GUI 或 CLI 有意义，因此不被理解
另一个。 这些在下面说明。

支持 个人设置
欢迎/标题
QML 应用程序标题和欢迎屏幕标题。 默认为 系统 测试.

欢迎/短信
首屏显示欢迎信息（checkbox-gui 支持富文本
允许 HTML 样式的标记）。 默认为 欢迎 至 系统 测试。 [...]

套件/whitelist_filter
匹配白名单文件名子集的正则表达式。 在 checkbox-gui 上
默认为 .*. 对于复选框启动器，它没有默认值，并且 必须 被定义。

套件/白名单_选择
预选白名单需要匹配的模式。 Python 正则表达式。
它没有默认值和 必须 被定义。 （仅限 CLI）

套件/skip_whitelist_selection
如果设置为 true，用户将不会收到白名单的选择。 仅预选
那些（见 whitelist_selection）将被选中。 （仅限 CLI）。

套件/skip_test_selection
如果设置为 true，则不允许用户在运行之前取消选择测试：所有测试
在选定的白名单中将运行。 （仅限 CLI）

提交/留言
提交弹出窗口的标题文本，提交后显示给用户
完全的。 （仅限图形用户界面）

提交/输入类型
显示文本输入字段以输入安全 ID 或 LP 地址（默认）。 到
只需将结果保存到磁盘，必须使用 没有 价值。 要使用正则表达式进行验证，
必须 正则表达式. （仅限图形用户界面）

提交/正则表达式
用于验证提交字段中输入的正则表达式（例如电子邮件、secure_id）
如果 input_type 是正则表达式。 （仅限图形用户界面）。 RegExpValidator，默认 .*

提交/输入占位符
放置在输入字段中的临时文本，用于引导用户。 快速启动 邮箱
地址 （默认）或 安全 ID （15 or 18 字符）. （仅限图形用户界面）

提交/secure_id
预配置的secure_id 以填充文本字段。

提交/ok_btn_text
“发送”按钮的标签。 提交 成果 （默认）或 保存 成果. （图形用户界面
只有）

提交/取消警告
向用户显示他是否想在未保存报告的情况下退出。 你是关于
退出此测试运行而不保存您的结果报告。 你想保存
报告？ （仅限图形用户界面）

提交/submit_to_hexr
布尔值，添加一个额外的标头也将结果发送到 HEXR（与
认证运输）

出口商/xml_export_path
保存 XML 提交文件的位置，如果设置为空字符串将打开一个
文件保存对话框。 默认： /tmp/submission.xml （仅限图形用户界面）

运输/提交_至
传输端点。 默认为 . 支持提交给 LP（默认，
折扣值 发射台), 认证或 本地 （保存到磁盘）

传输/提交_url
将结果提交到的 URL。 这允许上传到不同的网站，例如
它可以直接上传到 hexr 或登台站点。 仅与
认证 submit_to 值。

传输/配置文件名
要加载的自定义配置文件的名称。 配置文件主要用于定义
环境变量。 （仅限 CLI）

运输/dont_suppress_output
如果设置，资源，本地作业和附件将输出到屏幕，这
生成大量文本，主要用于调试。 （仅限 CLI）

复选框/明文框 发射器 在线课程

本文档解释了为什么需要启动器，您可以实现什么
与他们，并通过几个例子来更好地描述他们的能力。 为一个
关于启动器支持哪些设置的详细参考，以及
启动文件，看看 /个人资料.

遗产 核取方块 行为 控制
过去，Checkbox 的行为由三种机制控制。

首先，可以通过添加插件来增强复选框的功能。 例如，
复选框认证包添加了提交到认证网站的能力
使用插件。 checkbox-certification 包含的插件并添加了新的行为
基本复选框是：

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

这些添加了提示用户提交特定数据的方式，生成xml
报告等功能。

接下来，可以使用配置来配置或控制插件的行为
文件，它们是“级联的”。 一个配置文件可以包含其他人，而那些人又可以
包括其他人。

这是特定于项目的 project-qt.ini 主配置文件的示例。 这是第一个
启动特定于项目的客户端时读取的文件。 一些设置被缩写：

[默认]
包括 = %(checkbox_oem_share)s/configs/checkbox-project-base-qt.ini %(checkbox_project_share)s/configs/checkbox-project-base.ini

[复选框/插件/environment_info]
存储库 = deb http://.*\(archive\|security\).ubuntu.com/ubuntu precision-security
路由器 = 多个
服务器iperf = 10.20.30.40
来源列表 = 的/ etc / apt / sources.list文件
wpa_n_psk = 密码
wpa_n_ssid = 接入点

[复选框/插件/用户界面]
标题 = 我的项目系统测试

注意包含行，这指示它加载配置文件
checkbox-project-base-qt 和 checkbox-project-base。 Checkbox-project-base-qt 加载
checkbox-certification 和 checkbox-project 的配置。 设置是级联的，因此
顶部附近的配置选项会覆盖底部附近的配置选项。

最后，用于调用复选框的“二进制”是一个 shell 脚本，它定义了在哪里找到
复选框需要运行的东西：你可以定义一个共享目录，一个特定的数据
目录，指向一个配置文件并定义一些环境变量
测试期间可能需要。 这是 checkbox-project-qt 的示例：

#!/ bin / bash
出口CHECKBOX_DATA=${CHECKBOX_DATA:-~/.复选框}
导出 CHECKBOX_SHARE=${CHECKBOX_SHARE:-/usr/share/checkbox}
导出 CHECKBOX_OPTIONS=${CHECKBOX_OPTIONS:---log-level=debug --log=$CHECKBOX_DATA/checkbox-project.log}
导出 CHECKBOX_CERTIFICATION_SHARE=${CHECKBOX_CERTIFICATION_SHARE:-/usr/share/checkbox-certification}
出口 CHECKBOX_OEM_SHARE=${CHECKBOX_PROJECT_BASE_SHARE:-/usr/share/checkbox-project-base}
导出 CHECKBOX_PROJECT_SHARE=${CHECKBOX_PROJECT_SHARE:-/usr/share/checkbox-project}

# 方便定义 PYTHONPATH 目录。
if [ "$CHECKBOX_SHARE" != "/usr/share/checkbox" ]; 然后
导出 PYTHONPATH="$CHECKBOX_SHARE:$PYTHONPATH"
fi

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

在这里你可以看到它定义了一些位置，一个重要的部分是最终的python3
行，它将定位并使用我们之前看到的所需的 .ini 配置文件。

这种等级制的组织非常强大，但也很难处理，并且
也有一定的局限性。 我们使用复选框所做的部分工作是整合所有
项目特定的插件到复选框主干，这样所有的核心代码都在一个地方，
并且特定于项目的变体仅提供作业、白名单、数据和配置，
无需添加新行为。

全新 普通盒 行为 控制
与 checkbox 不同的是，plainbox 的核心是单一的，并且没有插件的概念。 这个
使其更易于理解和使用。 普通盒核心有所有的实现
旧复选框包中的功能，因此无需添加即可使用功能
例如提交认证或生成报告。

我们所说的plainbox是实现所有功能的库，可以看出
点击此处.

Plainbox 提供工具来帮助测试开发人员编写和打包测试。 这些是
在“提供者”中交付，提供者是旨在封装测试描述的实体，
用于测试、白名单和各种数据的自定义脚本。 它们旨在允许
团队编写和交付他们的自定义测试，而不必太担心
底层的普通代码。

要获取有关如何编写测试和提供程序的信息，请参阅提供程序教程

但是，在实际使用这些测试来验证真实系统时，我们希望提供
更容易和更接近复选框的用户体验的东西。 我们创建了两个客户端，
checkbox-gui 和 checkbox-cli，它们有一些硬编码的行为，我们也开始
创建基于这些但具有特定目的的其他客户端。 例如，
我们有一个用于 SRU 测试的复选框版本，另一个用于服务器认证，等等。

但后来我们意识到很多代码是重复的，行为很常见
除了一些变化。 所以我们提出了“发射器”的概念，它们是
有点类似于复选框的配置文件和 shell 脚本启动器。

这个想法是 checkbox-gui 和 checkbox-cli 有一些非常基本的行为，因为它们
是默认情况下随 ubuntu 一起提供的客户端。 他们可以显示所有可用的
白名单，显示预定义的欢迎消息，最后会让用户看到
html 报告并使用他们的电子邮件地址将其提交到启动板，类似于版本
Ubuntu 附带的复选框。

代替使用复杂的命令行开关，启动器允许您配置一些
自定义您的测试体验的可选行为。 启动器包含设置，以及
类似于 shell 脚本，但解释器将是 checkbox-gui 或
复选框启动器。

以下是一些可以使用启动器完成的操作的示例。

令人惊讶的是，checkbox-cli 本身就是一个启动器：

#!/usr/bin/环境 复选框启动器
[欢迎]
text = 欢迎来到系统测试！
复选框提供测试以确认您的系统工作正常。
完成运行测试后，您可以查看以下内容的摘要报告
你的系统。
警告：某些测试可能会导致您的系统冻结或变成
没有反应。 请保存您的所有工作并关闭所有其他运行
在开始测试过程之前应用程序。

[套房]
whitelist_filter = ^默认$
白名单选择= ^默认$
跳过白名单选择=真

[运输]
submit_to = 启动板

您可以在此处看到我们自定义了一些选项：它会自动显示欢迎消息
选择默认白名单，并在完成后提交到启动板。

一个图形启动器示例是 canonical-certification-client。

#!/usr/bin/checkbox-gui

[欢迎]
title = "系统认证"
文字 = " 欢迎来到体系认证！ 此应用程序将
从您的系统收集信息。 然后你会被要求手动测试
确认系统工作正常。 最后，你会被要求
提交信息到认证的计算机的安全ID
数据库。 要了解如何创建或定位安全 ID，
请看这里： certification.canonical.com ”

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

[提交]
input_type = "正则表达式"
input_placeholder = "安全 ID (15 或 18 个字符)"
ok_btn_text = "提交结果"
submit_to_hexr = "真"

[出口商]
xml_export_path = "/tmp/submission.xml"

[运输]
submit_to = "认证"

图形启动器有点复杂，但本质上是相似的，它是什么
允许您定义一些参数来自定义您的测试体验。

一个非常简单的文本模式启动器是 canonical-hw-collection，它只运行基本的
硬件信息测试并上传到硬件数据库：

[欢迎]
标题 = 收集硬件信息
text = 收集硬件信息。 系统可能会提示您输入密码。
此过程大约需要 30 秒，您将获得
带有一个 URL，您可以通过该 URL 确认和注册您的硬件
提交。

[套房]
白名单过滤器 = ^hwsubmit$
白名单选择 = ^hwsubmit$
跳过白名单选择=真
skip_test_selection =真

[提交]
# 一个虚假的 secure_id 确保我们不会询问它
# 它总是可以在 .conf 文件中被覆盖。
安全 ID = 000

[运输]
submit_to = 认证
提交网址 = https://hardware-server.example.com/

最后，canonical-driver-test-suite 提供了图形和文本模式的启动器，
它们在功能上是等效的：

#!/usr/bin/checkbox-gui

[欢迎]
title = "规范驱动测试套件"
文字 = " 欢迎使用规范驱动程序测试套件。

该程序包含自动和手动测试，以帮助您发现
在 Ubuntu 上运行设备驱动程序时会出现的问题。

此应用程序将逐步引导用户完成这些测试
预先确定的顺序并自动收集系统信息作为
以及测试结果。 手动的时候也会提示用户输入
测试是必需的。

测试的运行时间取决于您决定进行哪些测试
执行。 用户将有机会自定义测试运行
适应司机和可用于测试的时间。

首先，只需单击下面的继续按钮并按照屏幕上的指示操作
指示。 ”

[套房]
whitelist_filter = "^ihv-.*"

[提交]
ok_btn_text = "保存结果"
input_type = "无"

[出口商]
xml_export_path = ""

[运输]
submit_to = "本地"

文字模式：

#!/usr/bin/环境 复选框启动器
[欢迎]
text = 欢迎使用 Canonical Driver Test Suite
该程序包含自动和手动测试，以帮助您发现
在 Ubuntu 上运行设备驱动程序时会出现的问题。
此应用程序将逐步引导用户完成这些测试
预先确定的顺序并自动收集系统信息作为
以及测试结果。 手动的时候也会提示用户输入
测试是必需的。
测试的运行时间取决于您决定进行哪些测试
执行。 用户将有机会自定义测试运行
适应司机和可用于测试的时间。
首先，只需单击下面的继续按钮并按照屏幕上的指示操作
指示。

[套房]
# 显示在套件选择屏幕中的白名单
白名单过滤器 = ^ihv-.*
# Whitelist_selection 是强制性的，因此我们将其设置为虚假值
# 没有预先选择白名单。
whitelist_selection = 虚假

复选框 RELEASE PROCESS

此页面描述了发布 Checkbox 和 Checkbox 版本的必要步骤
定期向属于硬件认证团队的稳定 PPA 进行认证
基础。 在本文档中，术语“复选框”被用作涵盖所有内容的术语
硬件认证团队拥有的所有版本的 Checkbox，目前是 Checkbox
本身和复选框认证扩展。

概述
目前，该流程每两周运行一次，每隔一周发布一次新的 Checkbox
两周。 这包括十个工作日，以及每天或一组执行的任务
天描述如下：

· 第 1-4 天：允许将新更改引入主干的时间。

· 第 5 天：从主干合并更改 lp:复选框 和 lp：复选框认证 至
他们各自的发布分支。 两者的变更日志是 被撞 此时和
修订被标记。 在此阶段，可能还需要复制包“fwts”
来自 无线传输系统 稳定 PPA <https://launchpad.net/~firmware-testing-team/+archive/ppa-
fwts-稳定> 到 复选框 发布 测试 PPA <https://launchpad.net/~checkbox-
开发/+归档/测试>.

· 第 6-9 天：测试由发布经理进行硬件认证
团队，以及 CE QA 团队的代表（Checkbox 的主要客户）
典范）

· 第 9 天：在硬件发布经理之间召开发布会议
认证团队和CE QA团队的代表。 潜在的问题
确定发布并制定解决这些问题的计划。

· 第 10 天：将 Checkbox 测试版本复制到稳定版 PPA。

快速启动 分支机构
发布过程需要 Launchpad 中包含半冻结的单独分支
流程第 5 天在主干中的代码版本。 这使得发展
可以继续在主干上，而不会危及即将发布的版本的稳定性
复选框。 流程中涉及的所有分支之间的关系如下图所示：

· lp：复选框/释放 <- lp:复选框

· lp:checkbox-认证/发布 <- lp：复选框认证

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

审计 具有里程碑意义的 虫子
在创建候选发布之前，发布经理应该检查错误列表
Checkbox 的下一个版本具有里程碑意义。 他们应该访问 核取方块 里程碑
<https://launchpad.net/checkbox/+milestonesmilestones> 并找到日期为
发布日期。

· 对于设置为 In Progress 且分支关联的错误 - 与分支联系
所有者查看合并是否可以在截止日期之前完成。

· 对于处于任何其他非关闭状态的错误（除了 固定 承诺) - 重新里程碑
他们到达以下里程碑。

分切 此 释放
为了减少发布，我们必须将主干中的更改合并到发布中
分支，使用合适的消息提交它们并更新主干中的变更日志，以便
未来的变化在正确的版本下。 对于上面显示的每个分支组合，
执行以下操作（示例使用 lp:复选框 和 lp：复选框/释放):

bzr 分支 lp:checkbox/release checkbox-release
bzr 分支 lp:checkbox checkbox-trunk
cd 复选框释放
current_stable=`head -n1 $(find .-name 'changelog') | grep -oP '(?<=\().*(?=\))'`
bzr 合并 lp：复选框

此时如果没有变化（除了一到 Debian/变更日志) 合并，然后我们做
不执行有问题的包的发布。 在实践中，这经常发生在
复选框认证 但从来没有 核取方块:

bzr commit -m "合并了从 rev$(bzr revno -r tag:$current_stable lp:checkbox) 到 rev$(bzr revno lp:checkbox) 从 lp:checkbox 的更改"
bzr push lp：复选框/释放
cd`找到。 -name 'debian'`; 光盘..
bzr 标签 `head -n1 debian/changelog | grep -oP '(?<=\().*(?=\))'`
dch -r（保存修改后的变更日志）
dch -i -U '增量更新日志'
提交
bzr push lp：复选框

该过程的最后一步是在
ppa：复选框开发/测试 PPA. 为此，我们需要转到配方页面
核取方块 和 复选框认证 发布分支。

· 复选框测试 食谱 <https://code.launchpad.net/~checkbox-dev/+recipe/checkbox-
测试>

· 复选框-认证-测试 食谱 <https://code.launchpad.net/~checkbox-
dev/+recipe/复选框-认证-测试>

建立 现在 选项应该在页面上可用。 单击它以开始构建。

复制 固件 测试 套件 至 此 测试 PPA
Firmware Test Suite 工具是一种针对系统固件的测试工具，它自然是重
由复选框使用。 确保包含修复程序和新版本的最新版本
Checkbox 所需的测试/功能可用，也不会破坏任何内容
Checkbox，我们需要将它与 Checkbox 一起发布。 切割后释放如果
固件测试团队已通知新版本可用并且此版本
应该用于认证，我们需要将其复制到测试 PPA。 为此，我们
需要去 复制 包 查看 of 此 固件 测试 套件 （稳定） PPA
<https://launchpad.net/~firmware-testing-team/+archive/ppa-fwts-stable/+copy-packages>和
为所有版本选择“fwts”包回到 Precise。 我们需要设置
'Destination PPA' 为 'Checkbox Release Testing [~checkbox-dev/testing]' 和 'Copy
选项”字段到“复制现有二进制文件”，然后单击“复制包”。 这一步然后
需要重复，但将“目标 PPA”字段设置为“复选框开发人员的 PPA”
[~checkbox-dev/ppa]'。

下一页 发布 of 复选框 e-mail
以便每个人都有机会及时执行所需的任何测试
方式，在 PPA 构建完成后，应将电子邮件发送到以下地址
邮件列表：

· [电子邮件保护] <硬件-认证-
[电子邮件保护]>

· [电子邮件保护] <[电子邮件保护]>

内容通常是这样的：

主题：复选框的下一个版本 (18/11/2013)

嗨，

Checkbox 的下一个版本可在
https://code.launchpad.net/~checkbox-dev/+archive/testing PPA.
请在您方便的时候进行测试。 复选框基于修订版 2484
lp:checkbox 和 Checkbox 认证基于修订版 586
lp：复选框认证。

谢谢，

如果 Checkbox 和 Checkbox Certification 中的一个尚未更新，则
没有必要提到那个包

测试 此 释放
现在发布已经被削减，测试应该在发布会议之前进行。
从认证团队的角度来看，需要测试的是
复选框-认证-客户端 和 复选框认证服务器 这构成了基础
CE QA OEM 特定版本的 Checkbox。 复选框认证服务器在
CI循环Checkbox认证客户端需要手动测试。

发布 会议
在发布前的星期四，一位代表之间举行了一次会议。
认证团队和代表 商业许可证 工程师 QA 球队。 该
会议在 7:30 UTC 举行，如图所示 日历 邀请
<https://www.google.com/calendar/hosted/canonical.com/event?action=TEMPLATE&tmeid=Y3QxcWVla3ViMTRvMXByOHZlOTFvc283Y2NfMjAxMzA4MjlUMDczMDAwWiBicmVuZGFuLmRvbmVnYW5AY2Fub25pY2FsLmNvbQ&tmsrc=brendan.donegan%40canonical.com>.
邀请中包含会议议程。

出版 此 释放
要发布版本，我们只需要从 复选框
发布 测试 PPA <https://launchpad.net/~checkbox-dev/+archive/testing> 到 硬件
证书 公共 PPA <https://launchpad.net/~hardware-certification/+archive/public>.
为此，我们转到 复制 包 查看 of 此 复选框 发布 测试 PPA
<https://launchpad.net/~checkbox-dev/+archive/testing/+copy-packages> 并全选
以下软件包列表的版本： 复选框， 复选框认证， 权重。 使
确保“Destination PPA”字段设置为“Public PPA for Hardware Certification”
[~hardware-certification/public]' 并且'Copy options' 字段设置为'Copy
现有二进制文件”，然后单击“复制包”。

完成后，应将通知电子邮件发送至
[电子邮件保护] <[电子邮件保护]>.
公告模板如下：

嗨，

新版本的复选框已上传到硬件
认证公共 PPA
（https://launchpad.net/~hardware-certification/+archive/public）。 这
版本基于 lp:checkbox 的修订版 2294

谢谢，

请附上更新日志的最新部分作为发行说明

· 基因指数

· 模组索引

· 搜索

使用 onworks.net 服务在线使用 checkbox-cli