README

一套通过安装程序轻松配置的质量保证工具。

QA 工具旨在为您提供符合 Ibuildings 标准的合理基础构建设置。它们不是为了解决每个用例而设计的。如果您需要一个更复杂的设置，您可以使用生成的配置作为基础，并手动配置。

官方完整文档可在我们的GitHub 页面上找到。

要求

目前，QA 工具要求您的项目在 Git 版本控制下。此外，它要求您拥有一个带有 Dash shell（sh）、Ant（ant）以及常见的 find、tr 和 xargs 工具的 Linuxy 环境。在您的 PATH 中。安装 Ant 后，QA 工具应在您的 Linux 或 macOS 机器上运行。

安装

推荐通过我们的安装程序安装 QA 工具。

php -r "copy('https://raw.githubusercontent.com/ibuildingsnl/qa-tools/master/installer.php', 'qa-tools-setup.php');"
php -r "if (hash_file('SHA384', 'qa-tools-setup.php') === '2f83e895f1fda9e44334f452e9abedfde9152ba1aa95d1ea411eef0d1c96086e8d8c68909ffeaa3ec7d72de420c85287') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('qa-tools-setup.php'); } echo PHP_EOL;"
php qa-tools-setup.php
php -r "unlink('qa-tools-setup.php');"

如果您愿意，可以使用 qa-tool-setup.php 的 --install-dir 选项来指定 QA 工具应安装的位置。例如，php qa-tools-setup.php --install-dir=/usr/local/bin。建议您将 QA 工具下载到项目目录或您的 PATH 中的某个位置。

可以通过指定 --version 选项安装特定版本：php qa-tools-setup.php --version=3.0.0-alpha2。当安装 QA 工具的不稳定版本时，这很有用。

要查看安装程序的选项，请运行 php qa-tools-setup.php --help。

在此处了解为什么我们将 QA 工具作为 Phar 发布。

用法

Usage:
  command [options] [arguments]

Available commands:
  configure             Configure the Ibuildings QA Tools
  self-update           Updates Ibuildings QA Tools to the latest version
  help                  Displays help for a command
  list                  Lists commands

configure 子命令将启动一个交互式问卷，帮助您快速配置各种 QA 工具以满足项目的测试需求。它将记住您的答案，因此您可以轻松重新配置工具。

升级

QA Tools Phar 可分发软件可以通过类似于 Composer 的方式自我更新。以下命令将检查 QA Tools 的 [Releases][github-qa-releases] 页面以查找最新稳定版本，并替换您的可执行 Phar

$ ./qa-tools.phar self-update

贡献

• 贡献指南
• 开发
  • 配置过程
  • 任务开发
  • 工具开发
  • 编写系统测试
• Phar
• 发布流程
• 报告错误
• 通用语言