Ranorex Studio第1课 - 入门

在本课中，您将对录音机有更深入的了解。第一次录制将捕获一组用户操作（鼠标点击，击键），同时使用与Ranorex Studio一起交付的工具KeePass进行工作。KeePass是一个广泛可用且易于使用的开源密码管理器。

使用Ranorex创建第一个测试的最简单方法是记录手动执行的测试场景。记录的操作如鼠标点击或键盘操作是构建稳健测试用例的基础。在本课中，您将了解到：

• 准备记录用户操作
• 被测系统：KeePass密码安全
• 录制测试
• 分析记录的步骤
• 执行测试

如果您想了解关于GUI测试的更多信息，请随时阅读我们测试wiki中的相应章节。

Screencast屏幕 录像“Ranorex测试自动化快速入门”简要介绍了Ranorex录像机。您可以点击http://youtu.be/0S_YC7uwI-s#t=1m8s直接跳转到视频中的指定位置 。

准备记录用户操作

在开始录制之前，您需要确保您的被测系统（SUT）已准备好从手动测试执行开始。此外，请考虑以下几点，以避免事后清理录音和存储库过多的工作。

• 如果不是测试用例本身的一部分，请不要在测试中运行多个应用程序实例。
• 默认情况下，鼠标移动不被记录。出于这个原因，请在菜单导航等情况下点击鼠标。

被测系统：KeePass密码安全 

注意 在 第5课中  阅读有关如何激活鼠标移动记录的更多信息 - Ranorex记录器- 记录器热键。

如概述部分所述，本教程使用开源工具KeePass演示Ranorex功能，以自动执行应用程序以构建测试框架。KeePass是一个功能强大且易于使用的工具，用于管理密码和其他私人信息。有关KeePass的更多信息，请查看以下URL：http : //keepass.info。

开源工具KeePass

自3.3版以来，KeePass随Ranorex Studio一起提供，并附带示例数据库文件。

注意： 打开这个数据库文件的密码是'rx'。

在Ranorex Studio的开始屏幕上，您会看到一个'Sample'按钮，其中还包含一个样本测试套件项目，该项目处理KeePass应用程序中的一些测试案例。您可以仔细看看第4课：Ranorex测试套件 - 测试套件的一般结构及其测试用例。

录制测试

在下一节中，您将创建一个新的Ranorex测试解决方案并记录向KeePass添加条目的过程。

启动Ranorex Studio并打开空的录音文件。

通过选择开始>程序> Ranorex> Ranorex Studio打开Ranorex Studio。点击' New Test Solution ... '按钮创建一个空白的测试套件项目。

Ranorex Studio Start Page - 创建一个新的测试解决方案

在类别框中选择C＃并在模板框中选择Ranorex C＃Test Suite项目。接下来为新的测试套件项目指定一个名称和一个位置。

注意 由于可能的性能和安全影响，项目不应驻留在网络驱动器上（Ranorex本身也不应安装在网络驱动器上）。建议使用版本控制系统（VCS）。

点击“创建”按钮，打开一个新的测试套件项目。

指定编程语言和项目名称

新的Ranorex测试套件包含一个使用空记录的测试案例

在测试套件视图中，该模板已经包含一个使用空记录的测试用例。为了开始录制，只需在测试套件视图中双击录制，即可打开'Recording1'。

空记录

开始记录KeePass应用程序的测试。

注意 建议将KeePass应用程序文件夹从Ranorex安装文件夹（<Ranorex安装文件夹> \ Samples \ Desktop \ KeePass Sample \ KeePassTestSuite \ KeePass）中的示例目录复制到项目文件夹中，因为默认情况下，您没有写入权限保存由KeePass处理的数据库所需的程序文件夹。

您可以通过在“项目”视图中右键单击项目并从上下文菜单中选择“在资源管理器中打开文件夹”来打开项目文件夹

在资源管理器中打开项目文件夹，将示例应用程序复制到项目文件夹

点击“记录”按钮以启动。记录仪可帮助您准备被测应用程序。选择'桌面'作为技术，然后点击'添加应用程序'将KeePass添加到被测应用程序列表中。

选择一种技术来记录你的测试

Ranorex自动启动指定的应用程序

点击'记录'为了记录测试。KeePass应用程序打开并且Ranorex录像机开始运行。

记录KeePass应用程序的操作

注意 您会注意到将鼠标移到UI元素上时会显示一个红色边框，指示自动执行哪个元素。红色边框将在录制过程中为您提供帮助。您可以在 记录器设置对话框中 启用/禁用此功能 。

输入默认密码。

• 点击“主密码”复选框旁边的文本框

• 输入默认密码（'rx'）

KeePass登录对话框

KeePass应用程序

打开“添加新条目”表单。

• 点击主工具栏上的'编辑'
• 点击“添加条目”菜单项

具有子菜单“编辑”的KeePass应用程序（选择菜单项“添加条目”）

向KeePass应用程序添加一个新条目。

• 点击'标题'文本框并输入'WordPressDemo'
• 点击图标按钮（用钥匙符号）
  • 选择任何图标（例如第二个图标）
  • 点击'关闭'
• 点击'用户名'文本框并输入'admin'
• 点击'密码'文本框
• 再次点击鼠标右键
• 选择“全选”
• 输入'demo123'
• 对“重复”文本框重复相同操作
• 点击'URL'文本框并输入  http://bitly.com/wp_demo
• 点击右侧的“过期”按钮（观看标志）
  • 选择'1年'菜单项

• 点击'确定'按钮

KeePass表格添加密码输入

用于选择图标的KeePass表单

KeePass过期子菜单

验证结果

在添加一个新的密码输入后，一个新的行被添加到持有最近输入的项目的KeePass网格中。单击“录制”工具栏中的“验证”按钮，检查条目是否出现在网格中。将鼠标指针移动到网格（即第一个单元格）并稍等片刻，直到突出显示底层UI元素。 

KeePass窗体带有突出显示框以进行验证

在验证的第一步中，您可以选择要验证的UI元素。验证是否选择了正确的元素，然后单击“下一步”按钮。在第二步中，显示给定UI元素检查的所有可用属性。只需点击“确定”按钮以接受预先选择的“文本”属性。

选择要验证的UI元素

选择要验证的属性

删除添加项目并关闭应用程序。

为了完成录制方案，请在数据网格中选择添加的项目，然后按下键盘上的“DEL”按钮将其从列表中删除。

最后按下工具栏上的保存按钮，然后通过点击关闭按钮关闭应用程序。

屏幕截图显示工具栏中的保存按钮

按记录器工具栏中的“停止”按钮停止记录。

分析记录的步骤

记录器为您在应用程序上执行的每项操作创建单个步骤。这些步骤在动作表中表示。另外，每个操作项目都连接到代表在记录期间使用的UI元素（文本框，单选按钮，按钮等）的储存库项目。

录制的步骤显示在动作表中

您可以在 第5课Ranorex Recorder  -  其他编辑选项中 了解有关Ranorex Recorder中不同操作类型的更多信息 。

执行测试

为了执行记录的测试，您需要切换回Ranorex测试套件文件。只需点击'运行'，就可以在您的第一次记录测试中执行测试套件。

在执行过程中，Ranorex模拟所有的用户操作（鼠标移动和键盘事件），以便以与测试人员成功完成相同的方式测试应用程序。

点击“运行”按钮开始测试

报告

执行测试后，Ranorex Studio会自动打开生成的测试报告文件（* .rxlog），显示测试运行是否成功。

测试运行成功

测试运行失败

为了强制执行上图所示的错误，只需修改记录验证步骤中使用的期望值（例如'Typo3Demo'而不是'WordPressDemo'）。

通过更改验证步骤的预期值来强制执行错误

现在测试自动化可执行文件也可在您的项目文件夹中使用。要运行测试套件而不启动Ranorex Studio，只需双击可执行文件即可。

注意 为了在外部机器上运行测试套件项目，它需要在目标机器的相同目录中具有可执行文件（* .EXE）以及测试套件文件（* .RXTST）。如果您的Ranorex Studio解决方案包含多个项目，则需要确保库（* .DLL）文件也是同一目录的一部分。总之，最好将完整的输出文件夹（例如'bin / debug'）复制到目标机器。

位于项目的构建文件夹中的'MyFirstTestProject.exe'

默认情况下，报告文件也在同一目录内生成。有关更改报告文件夹的更多信息，请参见第4课：Ranorex测试套件 - 测试套件设置。

请阅读第4课Ranorex Test Suite - 在没有Ranorex Studio的情况下运行测试的命令行或独立测试套件运行器运行测试套件的其他方法。