Robot Framework 3.1.2 完整安装与实战教程

本文还有配套的精品资源，点击获取

简介：Robot Framework 是一个开源自动化测试框架，它以关键字驱动的方式，为各种不同的测试需求提供了一种通用的解决方案。本教程将带你从零开始，深入学习 Robot Framework 3.1.2 版本的安装、使用和最佳实践。你将了解如何创建测试套件、定义变量、使用断言、生成报告和日志，以及如何扩展 Robot Framework 以满足特定领域的测试需求。通过动手实践，你将掌握 Robot Framework 的核心概念和实用技巧，为你的自动化测试之旅奠定坚实的基础。

1. Robot Framework 简介

Robot Framework 是一款基于 Python 的开源自动化测试框架，广泛应用于软件测试领域。它采用关键词驱动的测试方法，通过编写易于理解的测试用例来实现自动化测试。Robot Framework 具有以下特点：

• 简单易用： 测试用例采用自然语言风格编写，无需复杂的编程知识。
• 平台无关： 支持跨平台运行，可在 Windows、Linux 和 macOS 系统上使用。
• 扩展性强： 提供丰富的扩展机制，可自定义关键字库、监听器和报告器。

2. Robot Framework 安装与配置

2.1 系统环境准备

2.1.1 操作系统要求

Robot Framework 对操作系统没有特殊要求，支持主流的 Windows、Linux 和 macOS 系统。

2.1.2 Python 环境安装

Robot Framework 依赖 Python 环境，因此需要先安装 Python。推荐安装 Python 3.7 或更高版本。

Windows 系统：

1. 下载 Python 安装程序：https://www.python.org/downloads/
2. 运行安装程序，选择“Install Now”
3. 勾选“Add Python 3.x to PATH”选项
4. 完成安装

Linux 系统：

1. 使用包管理器安装 Python：

sudo apt-get install python3

1. 验证 Python 版本：

python3 --version

macOS 系统：

1. 使用 Homebrew 安装 Python：

brew install python

1. 验证 Python 版本：

python3 --version

2.2 Robot Framework 安装

2.2.1 pip 安装方式

pip 是 Python 的包管理工具，可以通过 pip 安装 Robot Framework：

pip install robotframework

2.2.2 源码安装方式

也可以从源代码安装 Robot Framework：

1. 克隆 Robot Framework 仓库：

git clone https://github.com/robotframework/robotframework.git

1. 进入仓库目录：

cd robotframework

1. 安装 Robot Framework：

python setup.py install

2.3 Robot Framework 配置

2.3.1 IDE 配置

推荐使用 PyCharm 或 Visual Studio Code 等 IDE 来编写 Robot Framework 测试用例。

PyCharm 配置：

1. 打开 PyCharm，点击“File”->“Settings”
2. 在“Project Interpreter”下，选择 Python 解释器并安装 Robot Framework
3. 在“Tools”->“External Tools”下，添加 Robot Framework 运行器

Visual Studio Code 配置：

1. 安装 Robot Framework 扩展：https://marketplace.visualstudio.com/items?itemName=vsciot-vscode.vscode-robotframework
2. 在“Settings”->“Extensions”下，启用 Robot Framework 扩展
3. 在“Terminal”中，输入 robot --version 验证是否安装成功

2.3.2 命令行配置

也可以通过命令行配置 Robot Framework：

1. 打开命令行终端
2. 输入 robot --version 验证是否安装成功
3. 输入 robot --help 查看命令行选项
4. 使用 --output 选项指定报告输出路径
5. 使用 --listener 选项添加监听器

3. Robot Framework 测试用例编写

Robot Framework 的测试用例编写是测试自动化过程的核心部分。它允许用户创建可重复、可维护的测试用例，以验证应用程序或系统的行为。本章将介绍测试用例结构、编写和管理。

3.1 测试用例结构

3.1.1 测试用例关键字

测试用例关键字是测试用例中执行特定操作的原子单元。它们可以是内置关键字（由 Robot Framework 提供）或自有关键字（由用户创建）。内置关键字涵盖了各种操作，例如导航、输入、验证和断言。

3.1.2 测试用例变量

测试用例变量用于存储数据和信息，以便在测试用例中重用。它们可以是标量变量（单个值）、列表变量（值集合）或字典变量（键值对集合）。变量可以提高测试用例的可读性和可维护性。

3.2 测试用例编写

3.2.1 内置关键字

Robot Framework 提供了丰富的内置关键字，涵盖了测试自动化中常见的操作。这些关键字包括：

• 导航关键字： 用于在应用程序或系统中导航，例如 Open Browser 和 Click Link 。
• 输入关键字： 用于向应用程序或系统输入数据，例如 Input Text 和 Set Checkbox 。
• 验证关键字： 用于验证应用程序或系统的行为，例如 Should Be Equal 和 Verify Element Present 。
• 断言关键字： 用于对测试结果进行断言，例如 Assert True 和 Fail If Equal 。

3.2.2 自有关键字

除了内置关键字，用户还可以创建自己的关键字，称为自有关键字。自有关键字可以封装重复的任务或复杂的操作，从而提高测试用例的可重用性和可维护性。

自有关键字使用 Python 编写，并遵循 Robot Framework 的关键字语法。它们可以接受参数，并返回结果。

def my_custom_keyword(arg1, arg2):
    """
    My custom keyword documentation.

    :param arg1: First argument.
    :param arg2: Second argument.
    :return: Result of the keyword.
    """
    # Keyword implementation
    return arg1 + arg2

3.3 测试用例管理

3.3.1 测试用例组织

Robot Framework 允许用户将测试用例组织成测试套件和测试文件。测试套件是测试用例的集合，而测试文件是单个测试用例的容器。

测试用例组织有助于管理大型测试项目，并使测试用例易于维护和执行。

3.3.2 测试用例执行

Robot Framework 提供了多种执行测试用例的方法：

• 命令行： 使用 robot 命令行工具执行测试用例。
• IDE： 使用 Robot Framework IDE，它提供了一个图形用户界面来创建和执行测试用例。
• 外部工具： 使用第三方工具，例如 Jenkins 或 Azure DevOps，将 Robot Framework 集成到持续集成和持续交付管道中。

4. Robot Framework 变量使用

4.1 变量类型

Robot Framework 中提供了多种变量类型，以满足不同测试场景的需求。主要包括以下三种类型：

4.1.1 标量变量

标量变量是最基本的变量类型，用于存储单个值。值可以是字符串、整数、浮点数、布尔值或 None。标量变量以美元符号 ($) 开头，例如：

${name} = "John Doe"
${age} = 30
${is_active} = True

4.1.2 列表变量

列表变量用于存储多个值，这些值可以是任何类型。列表变量以 @ 符号开头，例如：

@names = ["John Doe", "Jane Doe", "Peter Parker"]
@ages = [30, 25, 20]
@is_active = [True, False, True]

4.1.3 字典变量

字典变量用于存储键值对，其中键是字符串，值可以是任何类型。字典变量以 & 符号开头，例如：

&person = {"name": "John Doe", "age": 30, "is_active": True}
&fruits = {"apple": "red", "banana": "yellow", "orange": "orange"}

4.2 变量作用域

Robot Framework 中的变量具有作用域的概念，即变量只能在特定的范围内使用。有两种主要的作用域：

4.2.1 全局变量

全局变量在测试用例文件或资源文件中定义，可以在整个测试用例执行过程中使用。全局变量以大写字母开头，例如：

GLOBAL_VAR = "This is a global variable"

4.2.2 局部变量

局部变量在测试用例或关键字中定义，只能在该测试用例或关键字内部使用。局部变量以小写字母开头，例如：

local_var = "This is a local variable"

4.3 变量操作

Robot Framework 提供了多种操作变量的方法，包括赋值、引用和比较。

4.3.1 变量赋值

变量赋值用于将值存储到变量中。赋值操作符为 = . 例如：

${name} = "John Doe"
@names = ["John Doe", "Jane Doe", "Peter Parker"]
&person = {"name": "John Doe", "age": 30, "is_active": True}

4.3.2 变量引用

变量引用用于获取变量的值。变量引用符号为 $ 、 @ 或 & ，具体取决于变量类型。例如：

Log ${name}
Log @names[0]
Log &person["name"]

4.3.3 变量比较

变量比较用于比较两个变量的值是否相等。比较操作符包括 == （相等）、 != （不等）、 < （小于）、 > （大于）、 <= （小于或等于）、 >= （大于或等于）。例如：

If ${name} == "John Doe":
    Log "The name is John Doe"
Else:
    Log "The name is not John Doe"

5. Robot Framework 断言使用

断言是测试用例中必不可少的组成部分，用于验证测试执行的结果是否符合预期。Robot Framework 提供了丰富的断言类型，支持对各种数据类型和条件进行验证。

5.1 断言类型

Robot Framework 中的断言类型主要分为以下三类：

5.1.1 相等断言

相等断言用于验证两个值是否相等。常用的相等断言有：

• Should Be Equal : 验证两个值完全相等。
• Should Be Equal As Strings : 验证两个值作为字符串相等，忽略大小写和空格差异。
• Should Be Equal As Integers : 验证两个值作为整数相等。
• Should Be Equal As Floats : 验证两个值作为浮点数相等，允许一定误差范围。

5.1.2 不等断言

不等断言用于验证两个值是否不相等。常用的不等断言有：

• Should Not Be Equal : 验证两个值不相等。
• Should Not Be Equal As Strings : 验证两个值作为字符串不相等，忽略大小写和空格差异。
• Should Not Be Equal As Integers : 验证两个值作为整数不相等。
• Should Not Be Equal As Floats : 验证两个值作为浮点数不相等，允许一定误差范围。

5.1.3 真假断言

真假断言用于验证一个值是否为真或假。常用的真假断言有：

• Should Be True : 验证一个值（通常为布尔值）为真。
• Should Be False : 验证一个值（通常为布尔值）为假。

5.2 断言使用

5.2.1 内置断言

Robot Framework 提供了丰富的内置断言，可以满足大多数测试需求。内置断言的语法一般为：

Should Be <expected> <actual>

其中：

• <expected> : 预期值
• <actual> : 实际值

例如，以下代码使用 Should Be Equal 断言验证两个字符串相等：

Should Be Equal  ${expected}  ${actual}

5.2.2 自有断言

除了内置断言，还可以创建自己的断言来满足特定需求。自有断言的创建方法如下：

def MyAssert(expected, actual):
    if expected != actual:
        raise AssertionError("Expected {} but was {}".format(expected, actual))

然后可以在测试用例中使用自有断言：

MyAssert  ${expected}  ${actual}

5.3 断言失败处理

5.3.1 错误信息输出

当断言失败时，Robot Framework 会输出详细的错误信息，包括：

• 断言类型
• 预期值
• 实际值
• 失败原因

5.3.2 异常处理

断言失败时，Robot Framework 会抛出 AssertionError 异常。可以通过 try...except 块捕获此异常并进行自定义处理。例如：

try:
    Should Be Equal  ${expected}  ${actual}
except AssertionError as e:
    print("Assertion failed: {}".format(e))

6. Robot Framework 报告与日志生成

6.1 报告生成

6.1.1 HTML 报告

Robot Framework 提供了生成 HTML 报告的功能，该报告可以帮助用户直观地查看测试执行结果。

生成 HTML 报告

要生成 HTML 报告，需要在命令行中使用 --report 选项。例如：

robot --report my_report.html test_cases.robot

生成的 HTML 报告将包含以下信息：

• 测试用例执行结果
• 测试用例执行时间
• 测试用例执行日志
• 测试用例执行统计信息

6.1.2 XML 报告

除了 HTML 报告外，Robot Framework 还支持生成 XML 报告。XML 报告可以方便地与其他工具集成，例如持续集成系统。

生成 XML 报告

要生成 XML 报告，需要在命令行中使用 --output 选项。例如：

robot --output my_report.xml test_cases.robot

生成的 XML 报告将包含以下信息：

• 测试用例执行结果
• 测试用例执行时间
• 测试用例执行日志
• 测试用例执行统计信息

6.2 日志生成

6.2.1 控制台日志

Robot Framework 默认会在控制台中输出测试执行日志。这些日志包含了测试执行的详细信息，例如：

• 测试用例执行步骤
• 测试用例执行结果
• 测试用例执行时间

6.2.2 文件日志

除了控制台日志外，Robot Framework 还支持将日志输出到文件中。

输出日志到文件

要将日志输出到文件中，需要在命令行中使用 --log 选项。例如：

robot --log my_log.txt test_cases.robot

6.3 报告与日志分析

6.3.1 报告解读

HTML 报告和 XML 报告提供了直观的方式来查看测试执行结果。用户可以快速了解测试用例执行情况，以及是否存在失败的测试用例。

6.3.2 日志排查

控制台日志和文件日志提供了详细的测试执行信息。用户可以通过分析日志来排查测试失败的原因，并找出测试执行过程中遇到的问题。

7. Robot Framework 扩展性介绍

Robot Framework 作为一个开源的自动化测试框架，提供了丰富的扩展机制，允许用户根据自己的需求进行扩展和定制。这些扩展性主要体现在以下几个方面：

7.1 关键字库扩展

关键字库是 Robot Framework 的核心组件，它提供了各种可重用的操作，用于执行测试用例中的步骤。Robot Framework 提供了丰富的内置关键字库，涵盖了各种常用的测试操作，如 Web 浏览器操作、数据库操作、文件操作等。

7.1.1 内置关键字库

Robot Framework 内置了大量的关键字库，涵盖了广泛的测试场景。这些内置关键字库包括：

• SeleniumLibrary：用于 Web 浏览器操作
• DatabaseLibrary：用于数据库操作
• OperatingSystem：用于操作系统操作
• Collections：用于集合操作
• DateTime：用于日期和时间操作

7.1.2 自有关键字库

除了内置关键字库，用户还可以创建自己的关键字库，以满足特定测试需求。自有关键字库可以封装常用的测试步骤，提高测试用例的可重用性和可维护性。

创建自有关键字库的步骤如下：

1. 创建一个 Python 模块，并定义关键字函数。
2. 在 Robot Framework 测试用例中导入该模块。
3. 使用关键字函数来执行测试步骤。

# my_keywords.py
def login(username, password):
    # 登录操作代码

# test_case.robot
*** Settings ***
Library           my_keywords

*** Test Cases ***
Login
    Login            username    password

7.2 监听器扩展

监听器是一种扩展机制，允许用户在测试执行过程中截取事件并进行处理。Robot Framework 提供了内置监听器，用于记录测试执行信息、生成报告和日志等。

7.2.1 内置监听器

Robot Framework 内置了几个监听器，包括：

• TestListener：记录测试执行信息
• ReportListener：生成 HTML 报告
• LogListener：生成控制台日志

7.2.2 自有监听器

用户还可以创建自己的监听器，以满足特定需求，例如：

• 记录自定义事件
• 修改测试执行行为
• 生成自定义报告

创建自有监听器的步骤如下：

1. 创建一个 Python 类，并实现 start_suite 、 end_suite 、 start_test 、 end_test 等方法。
2. 在 Robot Framework 测试用例中导入该类。
3. 使用 --listener 参数指定自有监听器。

# my_listener.py
from robot.api import logger

class MyListener:
    def start_suite(self, name, attrs):
        logger.info(f"Suite {name} started")

# test_case.robot
*** Settings ***
Listener           my_listener

*** Test Cases ***
Login
    Login            username    password

7.3 报告器扩展

报告器是一种扩展机制，允许用户生成自定义测试报告。Robot Framework 提供了内置报告器，用于生成 HTML 报告和 XML 报告。

7.3.1 内置报告器

Robot Framework 内置了两个报告器：

• HTML 报告器：生成交互式 HTML 报告
• XML 报告器：生成 XML 格式的报告

7.3.2 自有报告器

用户还可以创建自己的报告器，以满足特定需求，例如：

• 生成自定义格式的报告
• 集成其他报告工具

创建自有报告器的步骤如下：

1. 创建一个 Python 类，并实现 generate_report 方法。
2. 在 Robot Framework 测试用例中导入该类。
3. 使用 --report 参数指定自有报告器。

# my_reporter.py
from robot.api import logger

class MyReporter:
    def generate_report(self, output):
        # 生成自定义报告代码

# test_case.robot
*** Settings ***
Report           my_reporter

*** Test Cases ***
Login
    Login            username    password

本文还有配套的精品资源，点击获取

简介：Robot Framework 是一个开源自动化测试框架，它以关键字驱动的方式，为各种不同的测试需求提供了一种通用的解决方案。本教程将带你从零开始，深入学习 Robot Framework 3.1.2 版本的安装、使用和最佳实践。你将了解如何创建测试套件、定义变量、使用断言、生成报告和日志，以及如何扩展 Robot Framework 以满足特定领域的测试需求。通过动手实践，你将掌握 Robot Framework 的核心概念和实用技巧，为你的自动化测试之旅奠定坚实的基础。

本文还有配套的精品资源，点击获取