使用 IBM Rational Test RealTime 和 Microsoft Visual Studio Plug-In

文档选项 未显示需要 JavaScript 的文档选项

级别： 初级

Fiona Foster (ffoster@ca.ibm.com)IBM

2005 年 4 月 01 日

在本文中，Fiona Foster 讨论了如何安装并使用 Microsoft Visual Studio 插件程序 Test RealTime。文章中包含的内容还有一般的提示和故障处理指导。

IBM® Rational Test RealTime 产品（仅可安装在 Microsoft Windows® 上） 包含了与 Microsoft® Visual Studio® 的集成。为了使集成可以正常工作，必须将 Visual Studio 和 Test RealTime 安装在同一工作站上.

在将这两个产品一起使用之前，必须依照以下步骤安装插件：

打开 Windows 开始（Start） 菜单（Menu），点选Programs > Rational Software > Test RealTime > Tools > Install Rational Test RealTime add-in for Microsoft Visual Studio 6.0

注意：必须为每个用户都安装插件。而且，用户必须至少运行一次 Visual Studio，并且在插件安装时不能运行程序。

当插件安装完成时，您会看到如下对话框出现，如下图 1 所示：

如果已经安装过早期版本的插件程序，参见下面的故障处理部分来确保在新版本安装之前已经将老版本卸载。

核对系统配置

在安装集成之前，需要核对一些内容来避免编译错误。

核对注册表键。

1. 通过点选 Start > Run > Regedit打开注册表
2. 定位到：
   HKEY_CURRENT_USER/Software/Microsoft/DevStudio/BuildSystem/Components/Platforms/Win32(x86)/Directories
3. 双击 Path Dirs 键，并且确保没有列出以下内容：
   C:\Program Files\Rational\Test RealTime\targets\cvisual6\cmd

核实环境变量

1. 点选  Start > Settings > Control Panel > System > Advanced > Environment Variables ，确保没有设置环境变量 ATLTGT 
2. 如果列出了 ATLTGT 项，请点选该项并点击 Delete按钮

使集成生效

1. 打开 Visual Studio 并打开你想要测试的工程。
2. 点击 Tools > Rational Test RealTime Options 并检验对话框（下图 3 所示）。注意到所有的控制项都是灰的，这是由于插件未生效造成的。
3. 点击 Enable 按钮使插件生效。现在该按钮显示为 Disable，并且控制项不再是变灰的。

1. 在使插件生效之后，您要通过设置在 Visual Studio 工程中用到的适当选项为 RunTime Analysis 设置具体的选项。

   • Levels
   • Functions
   • Calls
   • Blocks
   • Conditions
   • Instrumentation Mode
   • Ternary
   • Dump
   • Trace
   • Memory Profiling
   • Performance Profiling

2. 在设置完这些选项后，点击 Apply 按钮，然后点击 OK 按钮。

回页首

使用插件 build Visual Studio 工程

现已使插件生效并且设置了所有选项，您可以准备 build 和编译 Visual Studio Project 。

Build 工程

1. 如果工程还没有打开，请点击 File > Open 打开工程 
2. 点击 Build > Build <project_name>（ 此处 <project_name > 是该工程的名称）build 该工程
3. 在 build 的同时，您会看到类似以下 build 步骤的内容：

				myfirstVCDlg.cppTestRT attolccp - INFO: C++ Calls coverage not supported yetTestRT attolccp - INFO: C++ Conditions coverage types not supported yetMicrosoft (R) 32-bit C/C++ Optimizing Compiler Version 12.00.8804 for 80x86Copyright (C) Microsoft Corp 1984-1998. All rights reserved.cl _atc9521.cpp-nologo-MDd-W3-Gm-GX-ZI-Od-DWIN32-D_DEBUG-D_WINDOWS-D_MBCS-D_AFXDLL-FdDebug/-FD-GZ_atc9521.cppLinking...myfirstVC.exe - 0 error(s), 0 warning(s)	
					

注意： 看到文件处在测试中的唯一途径是将每个文件由“cl”“编译”两次（第一次将文件预处理，然后将测试文件编译）。依据的标志是以“_atc”为前缀的文件已经编译过。这些就是测试的文件。

	  myfirstVCDlg.cppTestRT attolccp - INFO: C++ Calls coverage
 
            not supported yetTestRT attolccp - INFO: C++ Conditions coverage 

            types not supported yet 
	  

运行工程

为了生成 Test RealTime 报告，必须先运行工程。

1. 请点击 Build > Execute <project_name> （此处 <project_name > 是工程的名称）运行应用程序
2. 停止应用程序

查看结果

有 2 种方法可以查看到结果。

从 Visual Studio 内部：

1. 点击 Tools > Rational Test RealTime Viewer
2. Visual Studio 将自动运行并载入所有报告

通过命令行方式：

1. 您要察看以下这些同工程所在路径相同的文件，这些文件依赖于在 Build 中所选择的运行时（runtime）特征：
   • .tio, .fdc  code coverage report files
   • .tsf, .tdf   runtime tracing report files
   • .tsf, .tpf   memory profiling report files
   • .tsf, .tqf   performance profiling report files
2. 在 build 并运行 Test RealTime 可执行程序后，就生成了一个跟踪文件 atlout.spt （存储文件）  
3. 通过打开 DOS 窗口，将路径改为工程所在位置，同时键入 atlsplit atlout.spt 将跟踪文件拆分
4. 在将跟踪文件拆分之后会看到以下内容： Splitting 'atlout.spt' traces file...
Traces file successfully split.
5. 在命令行方式下，通过键入 studio *.fdc *.tsf *.tpf *.tqf *.tio 将由拆分而生成的文件--coverage （*.fdc）、 trace （*.tsf）、 memory profiling （*.tpf） 和 performance profiling （*.tqf）装配起来
6. Test RealTime GUI 则运行并显示结果
7. 您也可以使用 Test RealTime GUI：点选 File > Browse Reports 并选择包含 *.fdc *.tsf *.tpf *.tqf 文件的路径。

回页首

一般故障处理

当处理故障时，首先要做的事情是退出 Visual Studio，然后移除或者重新安装插件程序。

重新安装 Test RealTime

1. 退出 Visual Studio。
2. 卸载插件程序：打开 Windows 开始（Start） 菜单（Menu），点选 Programs > Rational Software > Test RealTime > Tools > Install Rational Test RealTime add-in for Microsoft Visual Studio 6.0
3. 现清理注册表：点选 Start > Run 并键入 regedit
4. 定位到：
   
   HKEY_CURRENT_USER/Software/Microsoft/DevStudio/BuildSystem/Components/Platforms/Win32(x86)/Directories
5. 双击 Path Dirs 并移除所有包含“Test RealTime”的路径
6. 定位到下面所示的（注册表）键并删除该键：
   
   HKEY_CURRENT_USER\Software\Rational Software\Test RealTime
7. 现点选 Start > Programs > Rational Software > Test RealTime->Tools > Install Rational Test RealTime add-in for Microsoft Visual Studio 6.0重新安装插件程序

要点： （在安装时）不能运行 Visual Studio。 需要为每个用户都安装插件程序。

用户疑问

问题： 当试图 build 时，在 Build 步骤中显示出以下内容。我该做什么？

	  Compiling...Error 3: Test RealTime not properly installedError executing cl.exe. 
	  

解决方案 1： 这可能表示在安装或配置插件程序时 TDP 中的 cl.exe 正在运行，这意味着 TDP 中的 cl.exe 不能找到用于测试的选项。确保 TDP 目录不在路径中。

当这些错误出现时，还有许多需要检查的东西。一种可能的原因是 Microsoft Visual Studio 的 Test RealTime 插件程序未安装。

解决方案 2：如果插件程序正确安装，请核对以下键值：

				  HKEY_CURRENT_USER\Software\Microsoft\DevStudio\6.0\Build System\Components\Platforms\Win32 (x86)\Directories 
				  

此时，找到 Path Dirs 键 （以及其他键）：

Path Dirs = <something >，此处应当出现 TestRT Coverage 目标程序包的路径。

HKEY_CURRENT_USER\Software\Rational Software\Test RealTime\<version>\Coverage

Restore Path = <your initial path >，此处 <version > 对应了安装的 Test RealTime 版本。

解决方案 3：确定没有设置环境变量 ATLTGT 。

点选  Start > Settings > Control Panel > System > Advanced > Environment Variables

如果  ATLTGT 已列出，选择该项并点击 Delete 按钮。

要了解更多信息，请参看以下解决方案：

http://www-1.ibm.com/support/docview.wss?rs=945&context=SSSHUF&q1=graphical&uid=swg21132129&loc=en_CA&cs=utf-8&lang=en+en

http://www-1.ibm.com/support/docview.wss?rs=945&context=SSSHUF&q1=cl.exe&q2=visual+studio&uid=swg21131539&loc=en_CA&cs=utf-8&lang=en

问题： 成功运行应用程序之后，在查看 Test RealTime GUI 中的结果时，没有显示出图形信息。为什么？

解决方案： 在运行工程之后，将生成 atlout.spt 文件（与工程文件存储在同一路径）。该文件需要通过在 Dos 窗口中运行以下命令来将其拆分：

			atlsplit atlout.spt 
			

在成功拆分之后，您会见到类似下面的内容：

		   Splitting 'atlout.spt' traces file...
Traces file successfully split.
		   

现在您将可以查看结果，并且有两种方式可以完成查看操作：

• 通过命令行方式
• 通过 Test RealTime GUI （File > Browse Reports）

通过 GUI

在查看报告时，您必须打开相应的静态文件（.tsf）或者跟踪文件（ .tdf），这些依赖于您为工程所选的覆盖类型。

以下是对应文件格式的清单：

• .tio, .fdc   code coverage report files
• .tsf, .tdf   runtime tracing report files
• .tsf, .tpf   memory profiling report files
• .tsf, .tqf   performance profiling report files

在 Visual Studio 中打开报告文件时，确定动态和静态文件也是打开的。例如：

1. 点选  Files > Browse Reports > Add purifylt.tpf
2. 点选  Files > Browse Reports > Add .tpf  （或者 .tqf、 .tdp 其他应用于工程的文件，该工程中可能包含一些或所有以上文件）。

   注意： .tsf 文件可能会放在不同的目录中。

3. 点击  Open

一旦  .tsf 静态或者动态文件一起打开，图形信息就会显示出来。

通过命令行方式

注意： 确定当前路径是工程所在路径。

1. 对于 Memory Profiling，键入 studio <your_file>.tpf *.tsf
2. 对于 Performance Profiling，键入 studio <your_file>.tqf *.tsf
3. 对于 Runtime Trace，键入 studio <your_file>.tdf *.tsf
4. 对于 Code Coverage，键入 studio <your_file>.tio *.fdc

   注意： 除非在拆分中有不同的规定，Coverage 报告被命名为 attolcov.tio。

5. 对所有运行时分析组件，键入 studio *.tsf *.fdc <your_file>.tpf <your_file>.tqf <your_file>.tdf <your_file>.tio

要了解更多信息，请参看外部网站上的以下解决方案：

http://www.ibm.com/support/docview.wss?rs=945&context=SSSHUF&q1=graphical&uid=swg21130549&loc=en_CA&cs=utf-8&lang=en+en

参考资料

• 您可以参阅本文在 developerWorks 全球站点上的 英文原文。
  
  
• 同作者和其他读者在 论坛 中分享您关于本文的疑问和见解。
  
  
• 在 Developer Bookstore  的 Rational 区购买打折书。
  
  
• 在 developerWorks  寻找更多关于 IBM Rational Test RealTime 的资料。
  
  
• 了解更多关于 Visual Studio  的信息：
  
  
• 了解更多关于 Test RealTime product  的信息：
  

关于作者

		2000 年 7 月 Fiona 受雇于 IBM Rational 来支持 Rational Rose RealTime 产品。在过去的两年半的时间里，她通过撰写技术文章和白皮书来支持 Test RealTime ，并且为 Test RealTime 产品进行培训。

对本文的评价

太差！ (1) 需提高 (2) 一般；尚可 (3) 好文章 (4) 真棒！(5) 建议？

回页首