Allure 1命令行详解：掌握report generate与open核心指令

【免费下载链接】allure1Allure 1 isn't supported any more, please consider using Allure 2 https://github.com/allure-framework/allure2 instead项目地址: https://gitcode.com/gh_mirrors/al/allure1

Allure 1是一款强大的测试报告生成工具，虽然目前已不再支持，建议升级到Allure 2版本，但对于仍在使用Allure 1的用户，熟练掌握其命令行操作依然至关重要。本文将详细介绍Allure 1命令行工具的核心指令，特别是report generate和report open，帮助新手用户快速上手。

Allure 1命令行工具概述

Allure 1的命令行工具位于项目的allure-commandline/src/scripts/目录下，提供了allure（Linux/Mac）和allure.bat（Windows）两种可执行文件。通过这些命令，用户可以方便地生成、查看和管理测试报告。

核心命令结构

Allure 1命令行工具的基本结构如下：

allure [command] [options]

其中，report generate和report open是最常用的两个核心命令，分别用于生成测试报告和在浏览器中打开报告。

一键安装Allure 1

要使用Allure 1命令行工具，首先需要获取项目源码。通过以下命令克隆仓库：

git clone https://gitcode.com/gh_mirrors/al/allure1

克隆完成后，进入项目目录并构建：

cd allure1 ./mvnw clean install

构建成功后，命令行工具将位于allure-commandline/target/allure-commandline-1.4.23.HOTFIX1/bin/目录下，你可以将该目录添加到系统环境变量中，以便在任何位置使用allure命令。

掌握report generate：生成专业测试报告

report generate命令用于从测试结果数据生成Allure测试报告。该命令的核心功能在allure-commandline/src/main/java/ru/yandex/qatools/allure/command/ReportGenerate.java文件中实现。

基本用法

allure report generate [options] <results-directory>

其中，<results-directory>是存放测试结果数据的目录，通常包含一系列XML文件和附件。

常用选项

• -o, --output <directory>：指定报告输出目录，默认为allure-report
• -v, --verbose：启用详细日志输出
• -c, --clean：生成报告前清理输出目录

示例

allure report generate -o my-report ./target/allure-results

上述命令将从./target/allure-results目录读取测试结果，生成报告并输出到my-report目录。

使用report open：快速查看测试报告

生成报告后，使用report open命令可以快速在默认浏览器中打开报告。该命令的实现位于allure-commandline/src/main/java/ru/yandex/qatools/allure/command/ReportOpen.java文件。

基本用法

allure report open [options] [report-directory]

其中，[report-directory]是报告所在目录，默认为allure-report。

常用选项

• -p, --port <port>：指定HTTP服务器端口，默认为随机端口
• -h, --host <host>：指定HTTP服务器主机，默认为localhost

示例

allure report open -p 8080 my-report

上述命令将在8080端口启动HTTP服务器，并在浏览器中打开my-report目录下的测试报告。

高级技巧：结合使用generate和open

在实际使用中，通常需要先生成报告再打开查看。可以将两个命令结合使用：

allure report generate -o my-report ./target/allure-results && allure report open my-report

这条命令将先生成报告到my-report目录，然后自动打开该报告。

常见问题解决

报告生成失败

如果报告生成失败，首先检查测试结果目录是否存在且包含有效的测试数据。可以使用-v选项查看详细日志，定位问题原因：

allure report generate -v ./target/allure-results

无法打开报告

如果报告生成成功但无法打开，可能是端口被占用。可以尝试指定其他端口：

allure report open -p 8081 my-report

或者直接查看报告目录下的index.html文件，手动在浏览器中打开。

总结

Allure 1命令行工具的report generate和report open命令是生成和查看测试报告的核心功能。通过本文的介绍，相信你已经掌握了这两个命令的基本用法和高级技巧。虽然Allure 1已不再支持，但这些命令的使用思路对于学习Allure 2也有很大帮助。建议尽快升级到Allure 2，以获得更好的功能和支持。

Allure 1的命令行实现代码主要集中在allure-commandline/src/main/java/ru/yandex/qatools/allure/command/目录下，感兴趣的用户可以查看源码深入了解其工作原理。

【免费下载链接】allure1Allure 1 isn't supported any more, please consider using Allure 2 https://github.com/allure-framework/allure2 instead项目地址: https://gitcode.com/gh_mirrors/al/allure1