本主题说明如何指定控制报告、任务分配、许可等选项的设置。设置可用于在整个团队中共享首选项,以及将不同的设置应用于不同的项目和测试运行。

章节目录:

关于设置

设置可以控制报告、Parasoft DTP、错误作者等配置。您可能想要创建一个包含设置的文件来:

指定和存储设置

有两种方法可以指定设置:

设置可以存储在 Parasoft DTP 上(可以自动应用到连接的 C/C++test 安装程序)或本地文件中(可以通过命令行指定)。  有关如何存储和应用设置的详细信息,请参阅 C/C++test 配置概述。 

其他信息

可用设置

报告设置

设置目的
build.id=[id]

指定用于标记结果的构建标识符。可以针对每个构建唯一标记,也可以标记在指定的构建期间执行的多个测试会话。构建 ID 的最大长度为 128 个字符。

默认为  ${dtp_project}-${time:yyyy-MM-dd}。例如,对于 ATM 项目,报告中包含的构建 ID 可能类似于:ATM-2017-07-07。 

以下配置指定了自定义构建 ID,该 ID 由项目名称和通过环境变量 BUILD 传递的构建编号组成:

build.id=${dtp_project}-${env_var:BUILD}

例如 ABC 项目和 CI 服务器上的构建编号 114 可以解析为 ABC-114

report.active_rules=true|false

控制报告是否包含为测试启用的规则列表。

默认:false

report.archive=true|false

启用在指定报告位置中生成额外压缩包(.zip)的功能。该 ZIP 文件包含生成的用于构建报告的所有文件。 

此选项可以为任何报告格式生成一个压缩包(例如,HTML、PDF、SARIF 等)。 

通过生成压缩包,还可以执行报告的自定义转换,因为所有元素都会生成到指定目标文件夹。

默认:false

report.associations=true|false

指定报告是否显示与测试相关联的需求、缺陷、任务和特征请求。

默认:false

report.authors_details=true|false

确定报告是否包含分配给每个团队成员的任务数量及类型的概述。 

默认:true

report.contexts_details=true|false

确定报告是否包含测试期间检查或执行文件的概述。

默认:false

report.custom.extension

report.custom.xsl.file

为自定义格式指定 XSL 文件的位置和扩展名。同 report.format=custom 一起使用

有关详细信息和示例,请参阅配置报告设置

report.developer_errors=true|false

确定管理员报告是否包含团队成员任务的细节。

默认:false

report.developer_reports=true|false

确定系统是否为所有团队成员生成详细报告(除了管理者的总结报告)。 

默认:true

report.dtp.publish.src=off|min|full

指定是否将被测源代码发布到 DTP 服务器。  

如果设置为 off,则源代码不会发布到 DTP。

如果设置为 min,则发布源代码中最小的一部分(在大多数情况下,发布没有引用源码控制的源代码,例如自动生成的代码)。

如果设置为 full,指定范围内的所有源代码都将发布到 DTP。

默认值:full(启用report.dtp.publish选项时的默认值。)

report.format=[html|html_ut_details|pdf|sarif|sarif-azure|sast-gitlab|sast-gitlab-v14|sate|cppunit|xunit|custom]

指定报告格式。要为单次运行生成不同格式的多个报告,可输入逗号分隔的列表。如果启用了“Automation”许可证功能,除了指定的报告格式之外,还会生成和保存 XML 报告。例如:

report.format=html,pdf,sarif

默认:html

report.mail.attachments=true|false

指定报告是否作为附件发送。所有组件都作为附件被包含在内;必须将所有附件都保存到磁盘才能查看带有图像的 HTML 报告。

默认:false

report.mail.cc=[email_addresses]指定发送管理者综合报告的邮件地址。该设置后必须有一列以分号分隔的电子邮件地址。此设置通常用于向管理者或架构师发送报告。如果此类报告没有自动发送(例如,团队没有使用支持的源码控制系统),该设置还可以用于向团队成员发送综合报告。
report.mail.compact=trends|links

指定通过电子邮件发送简洁报告或链接而非完整报告。 

如果使用 trends,电子邮件将包含概述表和其他简洁数据,不会包含详细数据。

如果使用 links,电子邮件仅包含报告的链接(可在 DTP 服务器上查看)。

report.mail.domain=[domain]指定用于发送报告的邮箱域名。
report.mail.enabled=true|false

指定报告是否发送给团队成员和 cc 设置指定的其他收件人。 

请记住,每个处理项目代码的开发人员都会收到一份自动发送的报告,其中仅包含与其工作相关的错误/结果。

默认:false

report.mail.exclude=[email_addresses]指定不希望接收报告的邮箱地址。此设置用于防止自动发送报告给参与代码工作但不应接收报告的人。
report.mail.exclude.developers=true|false

指定报告是否应该发送给 report.mail.cc 属性中未明确列出邮箱的任何团队成员。此设置用于防止将报告发送给特定的团队成员。

默认:false

report.mail.format=html|ascii

指定邮件格式。

默认:html

report.mail.from=[email_address OR user_name_of_the_same_domain]

指定发送邮件的 "from" 行。

默认:<global_user_name>

report.mail.include=[email_addresses]指定您希望接收个人报告的团队成员的邮箱地址。该设置后必须有一列以分号分隔的电子邮件地址。如果没有自动发送此类报告(例如,团队未使用支持的源码控制系统),则通常使用此设置将个人报告发送给团队成员。该设置将覆盖 'exclude' 列表中指定的团队成员。 
report.mail.on.error.only=true|false

指定是否仅在生成任务或发生致命异常时才将报告发送给管理者。团队成员邮箱不受此设置影响;个人邮件只发送给负责相关任务的团队成员。

默认:false

report.mail.server=[server]指定用于发送报告的邮箱服务器。
report.mail.port=[port]

指定邮件服务器主机的端口号。

默认:25

report.mail.security=[SL| STARTTLS| NONE]指定所需的安全性。可用设置为 SSL、STARTTLS、NONE。SSL在 Visual Studio 中不可用。
report.mail.subject=My New Subject

指定发送邮件的主题行。主题行默认为 ${tool_name} Report - ${config_name}。例如,如果您想要将主题行更改为“Report for Project A”,您可以使用

report.mail.subject=Report for Project A

默认:${tool_name} Report - ${config_name}

report.mail.time_delay=[server]

指定发送电子邮件报告的时间延迟(避免批量电子邮件限制)。

默认:0

report.mail.unknown=[email_address OR user_name_of_the_same_domain]指定将错误分配给“未知人员”时应将报告发送给谁。
report.mail.username=[username] report.mail.password=[password] report.mail.realm=[realm]

为 SMTP 服务器身份验证指定设置。

realm 仅对使用 SASL 域进行身份验证的服务器是必需的。

report.metrics_details=true|false

指定是否生成带指标汇总信息(以及适用情况下各个类和方法的详细数据)的 XML 报告。只有在运行启用了指标的测试配置时才会生成此报告。HTML 和 PDF 报告中将显示指标详细信息。

默认:true

report.ref.report.file=[path]指定将在分析期间创建参考报告文件的位置的路径。请参阅配置任务报告首选项
report.additional.report.dir=[directory]指定将为当前执行的测试配置生成附加 C/C++test Standard 兼容 XML 报告文件的目录路径。附加的 XML 报告文件可包含静态分析、指标、单元测试和行覆盖率结果,具体取决于执行的测试配置。此设置仅在命令行模式(CLI)下可用。
report.rules=[url_path_to_rules_directory]

此设置指定包含静态分析规则 HTML 文件目录的路径。根据该路径,HTML 报告中会添加规则文档链接。
规则 HTML 文件由工具提供,也可通过点击测试配置的静态选项卡中的打印文件按钮生成。

要在 GUI 中应用此设置,需要在 .properties 文件中进行定义,然后在报告并发布窗口的选项文件字段中提供该文件的路径。更多详细信息,请参阅生成报告

例如:

report.rules=file:///C:/Temp/Burt/parasoft/xtest/gendoc/
report.rules=../gendoc/
report.rules=file:///<TOOL_INSTALL>/rules/docs/

默认:none

report.scontrol=off|min|full

指定报告中是否包含来自源码控制的其他信息以及包含多少信息。

如果设置为 off,报告中将不会包含源码控制的信息。

如果设置为 min,报告将包含有关资源库、文件路径以及修订的信息。

如果设置为 full,报告将包含有关资源库、文件路径、修订以及任务修订和注释的信息。

默认值:off

report.setup.problems=top|bottom|hidden

指定报告是否包含关于设置问题的部分。 

top - 在报告顶部添加“设置问题”部分。该值为默认值。 

hidden - 不会添加“设置问题”部分。

bottom - 在报告底部添加“设置问题”部分。 

默认:bottom

report.suppressed_msgs=true|false

指定报告是否包含被抑制的消息。

默认:false

report.test_params=true|false

指定报告是否包含测试参数细节。

默认:false


report.xml.param{n}.key=[id]

此设置指定一个添加到 xml 报告根元素中的自定义参数 Id。要求该 Id 具有唯一性。必须为要添加的自定义参数指定 report.xml.param{n}.keyreport.xml.param{n}.value

例如,以下配置指定,一个具有给定键和值的属性将被添加到 xml 报告的根元素中:

report.xml.param1.key=customId

report.xml.param1.value=12345

report.xml.param{n}.value=[value]

此设置指定一个添加到 xml 报告根元素中的自定义参数值。必须为要添加的自定义参数指定 report.xml.param{n}.keyreport.xml.param{n}.value

例如,以下配置指定,一个具有给定键和值的属性将被添加到 xml 报告的根元素中:

report.xml.param1.key=customId

report.xml.param1.value=12345

report.ue_coverage_details_htmls=[coverage_type]

指定测试的 HTML 报告是否链接到另一个包含带有逐行覆盖率详细信息注释的源代码的报告。 

可为 [coverage_type] 使用以下值:

LC - 行覆盖率
SC - 语句覆盖率
BCC - 代码块覆盖率
DC - 判定覆盖率
SCC - 简单条件覆盖率
MCDC - MC/DC 覆盖率

session.tag=[name]

指定用于标记这些结果的会话标签。该值用于将概要结果上传到 DTP。 

标签是在分析过程中检查模块的标识符。不同模块的报告应该用不同的标签标记。

默认:${config_name}

tasks.source.control.details=true|false
此设置指定报告中是否包含来自源码控制中的附加信息,如修订和注释。


Parasoft DTP 设置

设置目的
dtp.enabled=true|false

指定当前 C/C++test 安装程序是否连接到 DTP。

dtp.url=[url]指定 DTP 服务器的 URL。 

如果 DTP 部署到主机服务器根目录以外的位置,则该 URL 应包括上下文路径(主机名的相对路径)。如果您的组织使用反向代理,则可能会是这种情况。有关反向代理服务器配置和上下文路径配置的更多信息,请参阅 DTP 文档。

示例:dtp.url=https://ada.mycompany.com:8443

包括上下文路径的示例:dtp.url=https://aurelia.mycompany.com:8443/contextPath

dtp.user=[username]指定用于 DTP 服务器身份验证的用户名。
dtp.password=[password]指示用于 DTP 服务器身份验证的密码。我们强烈建议您使用经过编码的密码,以确保身份验证成功并提高安全级别;请参阅创建编码密码

report.dtp.publish=true|false

启用或禁用向 DTP 服务器报告结果的功能。
dtp.project=[project_name]指定要与这些结果链接的 DTP 项目的名称。
dtp.additional.settings=[KEY1\=VALUE1\nKEY2\=VALUE2...]指定向 DTP 报告结果的高级设置。
dtp.autoconfig=true|false

启用使用存储在 DTP 服务器上的 C/C++test 设置自动配置的功能。 该设置不适用于 GUI,在导入过程中会被忽略(有关该过程的更多信息,请参阅 cli Options 页面的“-settings”或“-property”)。

许可证设置

更多注意事项和示例,请参阅在本地文件或 DTP 项目中设置许可证

设置目的
parasoft.eula.accepted=true|false

指定接受 Parasoft 最终用户许可协议(EULA)的条款。

默认:false

cpptest.license.use_network=true|false

启用或禁用检索网络许可证功能。

示例:cpptest.license.use_network=true

默认:true

(info) 默认情况下,C/C++test 将尝试从配置为主 DTP 服务器的 DTP 上的许可证服务器检索许可证;请参阅 Parasoft DTP 设置。如果要配置其他许可证服务器,则启用 license.network.use.specified.server 选项。

cpptest.license.local.password=[password]指定您希望 C/C++test 使用的本地密码。 
cpptest.license.local.expiration=[expiration]

指定本地许可证的有效日期。

默认:0

cpptest.license.network.edition=[edition_name]

指定将从许可证服务器检索的网络许可证的类型。此设置要求 cpptest.license.use_network 设置为 true

可接受的版本名称:

  • desktop_edition:该许可证针对桌面端使用进行了优化。
  • desktop_compliance_edition:该许可证针对桌面端使用进行了优化,并配置为符合相应的编码标准。
  • server_edition:该许可证针对在服务器命令行模式下的高性能使用配置。
  • server_compliance_edition: 该许可证针对在服务器命令行模式下的高性能使用配置,并符合相应的编码标准。
  • custom_edition: 需要指定可用功能列表的自定义许可证。使用 cpptest.license.custom_edition_features 指定功能列表。

默认:custom_edition

示例:

以下配置将启用针对桌面端使用优化的许可证。
cpptest.license.use_network=true
cpptest.license.network.edition=deskop_edition

cpptest.license.custom_edition_features=[feature name]

指定要在自定义版 C/C++test 许可证中启用的功能。可以使用逗号分隔的列表来指定多个功能。

可接受的功能名称:

  • Assembly Coverage
  • Automation
  • AUTOSAR Rules
  • Code Dependency Export
  • Static Analysis
  • Coverage
  • Coverage Advisor
  • CWE Rules
  • Desktop Command Line
  • DISA STIG Rules
  • DTP Publish
  • Embedded Support
  • 流分析
  • HIC++ Rules
  • JSF Rules
  • MISRA C 2012 Rules
  • MISRA Rules
  • OWASP Rules
  • Requirements Traceability
  • Rule Wizard
  • Runtime Error Detection
  • Security Rules
  • SEI CERT C Rules
  • SEI CERT C++ Rules
  • Unit Test
cpptest.license.wait.for.tokens.time=[以分钟为单位的时间]

指定在当前许可证不可使用时,C/C++test 将等待许可证的时间。 

例如,要将 C++test 许可证令牌获取的等待时间设置为 3 分钟,则使用 cpptest.license.wait.for.tokens.time=3。

默认:0

cpptest.license.autoconf.timeout=[seconds]

指定 C/C++test 将等待许可证通过许可证服务器自动配置的最大秒数。

默认:20

license.network.use.specified.server=true|false

启用或禁用从自定义许可证服务器(独立服务器或部署在 DTP 服务器的另一个实例上的服务器)获取许可证的功能,该服务器通过 license.network.url 选项指定。

示例:license.network.use.specified.server=true

默认:false

license.network.url=[url]

指定用于获取许可证的许可证服务器(独立服务器或部署在 DTP 服务器的另一个实例上的服务器)的 URL。此选项要求将 license.network.use.specified.server 选项设置为 true

如果 DTP 部署到主机服务器根目录以外的位置,则该 URL 应包括上下文路径(主机名的相对路径)。如果您的组织使用反向代理,则可能会是这种情况。独立许可证服务器不支持上下文路径。有关反向代理服务器配置和上下文路径配置的更多信息,请参阅 DTP 文档。独立许可证服务器不支持上下文路径。

示例:license.network.url=https://jade.mycompany.com:8443

包括上下文路径的示例:license.network.url=https://aurelia.mycompany.com:8443/contextPath

license.network.auth.enabled=true|false

启用或禁用使用 license.network.url 选项指定的许可证服务器的身份验证。

此选项要求将 license.network.use.specified.server 选项设置为 true

license.network.user=[username]

指定使用 license.network.url 选项指定的许可证服务器的身份验证用户名。此选项要求将 license.network.use.specified.serverlicense.network.auth.enabled 选项设置为 true

示例:license.network.user=JohnSnow

license.network.password=[password]

指定使用 license.network.url 选项指定的许可证服务器的身份验证密码。此选项要求将 license.network.use.specified.serverlicense.network.auth.enabled 选项设置为 true,并且已配置 license.network.user。我们强烈建议您使用经过编码的密码,以确保身份验证成功并提高安全级别;请参阅创建编码密码

示例:license.network.password=Wic2019!

OpenID Connect 设置

设置目的
oidc.enabled=true|false

启用或禁用通过 OpenID Connect 进行用户身份验证。

默认为 false

oidc.issuer.uri=[uri]指定 DTP 注册的 OpenID Connect 服务器的 URI。
oidc.client.id=[id]指定在 OpenID Connect 服务器注册的 ID。
oidc.client.secret=[password]指定在 OpenID Connect 服务器提供的密码。
oidc.cli.mode=devicecode|certificate

指定用于在 OpenID Connect 服务器上验证用户身份的方法。

如果设置为 devicecode,将在 OpenID Connect 服务器上使用设备代码进行身份验证

如果设置为 certificate,将在 OpenID Connect 服务器上使用证书进行身份验证。

默认:devicecode

oidc.devicecode.token.file

指定包含用户身份验证信息的自定义令牌文件的路径。

例如:

oidc.devicecode.token.file=C:\\parasoft\\token

oidc.keystore=[path]

指定存储了用于在 OpenID Connect 服务器上验证用户的证书的密钥库文件路径。

oidc.keystore.password=[password]指定存储了自签名客户端证书的密钥库文件的密码。我们强烈建议您使用经过编码的密码,以确保身份验证成功并提高安全级别;请参阅创建编码密码
oidc.keystore.alias=[alias]

指定要用于在 OpenID Connect 服务器上进行身份验证的别名。如果您的密钥库文件包含多个条目,您可能需要配置此设置。

示例:oidc.keystore.alias=grs

oidc.callback.host=localhost | 127.0.0.1

此设置指定在 IDE 中配置的与 OpenID Connect 服务器通信的本地回调主机。

(info) 这是与 IDE 相关的设置,不适用于命令行。

默认为 localhost

oidc.callback.port=0 | [port number]

此设置指定在 IDE 中配置的与 OpenID Connect 服务器通信的回调端口号。

(info) 这是与 IDE 相关的设置,不适用于命令行。

0:该端口自动配置。

默认为 0

oidc.callback.timeout=[seconds]

此设置指定在 IDE 中使用 C/C++test 时,在身份验证页面上提供用户凭据以通过 OpenID Connect 在 DTP 上进行身份验证所允许的最长时间。

(info) 这是与 IDE 相关的设置,不适用于命令行。

默认为 60。


技术支持设置

设置目的
techsupport.auto_creation=true|false

指定在发生测试问题时是否自动整理压缩包。

默认:false

techsupport.send_email=true|false

指定是否将准备好的压缩包发送给 Parasoft 技术支持。如果启用,应确保通过 GUI 或报告设置中的选项指定电子邮件设置。

默认:false  

techsupport.archive_location=[directory]指定压缩包的存储位置。
techsupport.verbose=true|false

指定压缩包中是否包含详细日志。请注意,如果日志系统存在自定义配置,则不能启用该功能。

  • 详细日志存储在位于用户主目录临时位置(在 Windows 上为 <drive>:\Documents and Settings\<user>\Local Settings\Temp\parasoft\xtest)的 xtest.log 文件中。

  • 详细日志记录状态在不同会话之间保持不变(在应用程序启动时恢复)。

  • 该日志文件是一个滚动文件:它不会超过指定大小,并且每次达到最大大小时,都将创建一个备份。

默认:false

techsupport.verbose.scontrol=true|false

指定详细日志是否包含源码控制命令的输出。请注意,输出可以包含源代码的片段。  

默认:false

techsupport.item.general=true|false

指定是否包含常规应用程序日志。

默认:false

techsupport.item.environment=true|false

指定是否在压缩包中包含环境变量、JVM 系统属性、平台详细信息和其他属性(如内存等)。

默认:false

techsupport.advanced=true|false

指定是否发送高级选项。

默认:false

techsupport.advanced.options=[option]

指定技术团队要求您输入的任何高级选项。

默认:false

techsupport.dtp.engine=true|false

指定是否发送分析期间生成的附加数据。

默认:false

作者/范围设置

设置目的
authors.mapping{n}=[from_user, to_user]

指定特定的作者映射。

例如:

authors.mapping1=baduser,gooduser
authors.mapping2=brokenuser,fixeduser 
authors.mapping3=olduser,newuser 

authors.user{n}=[username, email, full_name]

指定具体的作者姓名和电子邮件。

例如:

authors.user1=dan,[email protected],Dan Stowe
authors.user2=jim,[email protected],Jim White 

authors.ignore.case=true|false

指定是否忽略作者名大小写。如果设置为 true,David 和 david 将视为同一个用户。如果设置为 false,David 和 david 将视为两个单独的用户。

默认:false

scope.sourcecontrol=true|false

指定 C++test 是否根据支持的源码控制系统的数据推算代码作者。如果要使用 GUI 中指定的值,则不需要此设置。

默认:false

scope.local=true|false

指定 C++test 是否基于本地用户推算代码作者。如果要使用 GUI 中指定的值,则不需要此设置。

默认:true

scope.recommended.computation=first|random指定 C/C++test 如何为每个团队成员选择推荐任务——可以随机选择 n 个任务(默认),也可以选择报告的前 n 个任务(n 是 C/C++test 根据配置每天向每个团队成员显示的最大任务数)
scope.xmlmap=true|false

指定是否根据定义了如何为特定文件或文件集分配任务的 XML 文件进行任务分配(可以在 GUI 中指定这些映射,然后将其保存在 XML 文件中)。

默认:true

scope.xmlmap.file=[file]指定定义了如何为特定文件或文件集分配任务的 XML 文件的名称。

源码控制设置

配置多个相同类型的资源库需要在定义了每个资源库的设置中添加一个索引(从 1 到 n)。例如: 

scontrol.rep1.svn.url= svn://buildmachine.foobar.com/home/svn
scontrol.rep1.svn.login=admin
scontrol.rep1.svn.password=1qa2ws

scontrol.rep2.svn.url= svn://tests.mycompany.com/projects/svn
scontrol.rep2.svn.login=lead
scontrol.rep2.svn.password=8ik9ol
 

Git 资源库定义属性

属性说明
scontrol.rep.type=gitGit 资源库类型标识符。
scontrol.git.exec=Git 可执行路径。如果未设置,则将假定 git 位于该路径上。
scontrol.rep.git.branch=源码控制模块将使用的分支名称。该属性可以留空,留空时使用当前检出的分支。
scontrol.rep.git.url=远程资源库 URL(例如,git://hostname/repo.git)。
scontrol.rep.git.workspace= 包含本地 git 资源库的目录。

Perforce 资源库定义属性

属性说明
scontrol.perforce.exec=外部客户端可执行文件的路径(p4)。
scontrol.rep.type=perforcePerforce 资源库类型标识符。 
scontrol.rep.perforce.host=Perforce 服务器主机。 
scontrol.rep.perforce.port=Perforce 服务器端口。默认端口为 1666。
scontrol.rep.perforce.login=Perforce 用户名。 
scontrol.rep.perforce.password=密码。 
scontrol.rep.perforce.client=P4CLIENT 环境变量或等效项中指定的客户端工作空间名称。该工作空间的根目录应该配置为本地路径(以便可以下载文件)。 

Subversion 资源库定义属性

属性说明
scontrol.rep.type=svnSubversion 资源库类型标识符。 
scontrol.rep.svn.url=Subversion URL 指定协议、服务器名称、端口号和启动资源库路径(例如,svn://buildmachine.foobar.com/home/svn)。 
scontrol.rep.svn.login=登录名。 
scontrol.rep.svn.password =密码(未编码)。 
scontrol.svn.exec=外部客户端可执行文件的路径(svn)。

Microsoft Team Foundation Server 资源库定义属性 

属性说明
scontrol.rep.type=tfsTFS 资源库类型标识符。 
scontrol.tfs.sdk.path

解压的 TFS SDK 根目录的路径。这对于在您的计算机上运行 TFS 支持而言是必需的。

Example: scontrol.tfs.sdk.path=C:\Users\user\parasoft\libraries\TFS-SDK-14.134.0 

注意:要求 TFS SDK 14.134 版本。

scontrol.rep.tfs.url=TFS 资源库 URL(如:http://localhost:8080/tfs)。
scontrol.rep.tfs.login =TFS 用户名。确保您提供的用户名与在机器上配置 TFS 资源库时使用的用户名相同。
scontrol.rep.tfs.password=TFS 密码。

用于创建或导入项目的设置

用于创建或导入项目的选项仅在创建或导入项目时有效。它们在随后的运行中被忽略。

用于创建基于 BDF 的项目的设置

选项说明

bdf.import.location=[WORKSPACE|BDF_LOC|<path>]

可以指定外部位置,也可以使用关键字 WORKSPACE。如果使用 WORKSPACE,项目将在工作空间目录的子目录中创建。

如果使用 BDF_LOC 并创建一个项目,那么该项目将在与 bdf 文件相同的位置创建。如果创建多个项目,这些项目将在 bdf 文件位置的子目录中创建。这些子目录将使用相应的项目名称命名。

如果指定了外部路径,项目将在指定位置创建。

WORKSPACE 为默认值。

有关可用项目创建选项及其影响的详细信息,请参阅使用 C++test 项目

bdf.import.pathvar.enabled=[true|false]

指定路径变量是否应在将在新项目中创建的链接文件夹中使用。默认为 false。

bdf.import.pathvar.name=<name>

指定路径变量的名称(如果使用路径变量,则以 bdf.import.pathvar.enabled 属性为准)。默认路径变量名为 DEVEL_ROOT_DIR

bdf.import.pathvar.value=<path>

指定路径变量的值(如果使用路径变量,则以 bdf.import.pathvar.enabled 属性为准)。默认值为所有链接文件夹的公共根目录。

bdf.import.compiler.family=<compiler_family>

指定将使用的编译器系列(例如,vc_6_0、vc_7_0、vc_7_1、vc_8_0、gcc_8-64、gcc_9、gcc_9-64、ghs_4_0)。对于自定义编译器,您需要使用自定义编译器系列标识符,即包含 gui.properties、c.psrc 和 cpp.psrc 文件的目录的名称。如果未指定该属性,将使用默认值。

bdf.import.c.compiler.exec=<exec>

指定将在创建的项目中使用的 C 编译器的可执行文件。

bdf.import.cpp.compiler.exec=<exec>

指定将在创建的项目中使用的 C++ 编译器的可执行文件。

bdf.import.linker.exec=<exec>

指定将在创建的项目中使用的链接器的可执行文件。

bdf.import.project.<proj_name>=dir1;dir2;dir3

指定要为项目 prj_name 链接的文件夹集。这些文件夹应以文件夹路径的值列表形式指定,用分号分隔。

导入 Green Hills.gpj 项目的设置

设置目的
gpj.import.location=WORKSPACE|ORIG|<path>

指定导入项目的位置。

如果使用 WORKSPACE,项目将在工作空间中创建。

如果使用 ORIG,项目将在 .gpj 项目位置创建。

如果指定了外部路径,项目将在指定位置创建。

默认值为 WORKSPACE

gpj.import.linked=true|false

指定是否将 .gpj 项目源文件夹链接到创建的 Eclipse 项目中。

默认值为 true

gpj.import.subdirs=true|false

适用于 gpj.import.location=<path> 的情况

指定将项目导入子目录或直接导入指定位置。

如果要将项目导入在指定的外部位置创建的子目录中,则使用 true。

如果只导入一个项目并且希望将该项目直接导入指定的外部位置,则使用 false。

默认值为 true(为导入外部位置的每个项目创建子文件夹)。

gpj.import.pathvar.enabled=true|false

指定创建链接目录时是否应使用路径变量(如果上述选项设置为 true)。

默认值为 false

gpj.import.pathvar.name=<name>

指定路径变量名。除非指定了指向不同位置的路径变量名(例如,DEVEL_ROOT_DIR),否则使用默认值。

如果在 Eclipse 工作空间中已经定义了具有指定名称的项目,并且该名称指向的位置与在 gpj.import.pathvar.location 属性中传递的值不同,则不会使用路径变量,而是使用完整路径。同样,如果未指定 gpjimport.pathvar.name 属性,那么 gpjimport.pathvar.name 的默认值始终为 DEVEL_ROOT_DIR。如果此属性使用某个 <name> 指定,那么该 <name> 将用作路径变量名。

默认值为 DEVEL_ROOT_DIR

gpj.import.pathvar.value=<path>

指定路径变量值。默认情况下,C++test 会为所有链接文件夹计算公共根目录。

gpj.import.compiler.family=name

指定编译器系列(编译器 ID)

gpj.import.c.compiler.exec=name指定 C 编译器可执行文件
gpj.import.cpp.compiler.exec=name

指定 C++ 编译器可执行文件

gpj.import.linker.exec=name指定链接器可执行文件

用于导入 IAR Embedded Workbench .ewp 项目的设置

设置目的
ewp.import.location=WORKSPACE|EWP_LOC|<path>

指定导入项目的位置。

如果使用 WORKSPACE,项目将在工作空间中创建。

如果使用 EWP_LOC,将在 .ewp 项目位置创建项目。

如果指定了外部路径,项目将在指定位置创建。

默认值为 WORKSPACE

ewp.import.config=<name>

指定应使用哪个 .ewp 项目配置。如果在导入的项目中找不到指定的配置,将使用默认配置。

配置名称可以通过两种方式传递:<project_name> - <configuration_name> 或 <configuration_name>。如果导入了多个项目,则应该只输入 <configuration_name>。

这会指示向导在所有项目中搜索该配置。默认值为 .ewp 中的默认值。

ewp.import.linked=true|false

指定是否将 .project 源文件夹链接到创建的 Eclipse 项目。

默认:true

ewp.import.subdirs=true|false

指定将项目导入子目录或直接导入指定位置。适用于使用 ewp.import.location=<path> 的情况。

设置为 true,项目将导入到在指定的外部位置创建的子目录中。默认。

设置为 false,单个项目将直接导入指定的外部位置。

ewp.import.pathvar.enabled=true|false

设置为 true,在创建链接目录时使用路径变量。

默认值为 false

ewp.import.pathvar.name=name

指定路径变量名。除非指定了指向不同位置的路径变量名,否则使用默认名称 DEVEL_ROOT_DIR

ewp.import.pathvar.value=<path>指定路径变量值。默认情况下,C++test 会为所有链接文件夹计算公共根目录。

用于导入 Microsoft Visual Studio 6.0 .dsp 项目的设置

设置
目的
dsp.import.location=WORKSPACE|DSP_LOC|<path>

指定导入项目的位置。

如果使用 WORKSPACE,项目将在工作空间中创建。

如果使用 DSP_LOC,将在 .dsp 项目位置创建项目。

如果指定了外部路径,项目将在指定位置创建。

默认值为 WORKSPACE

dsp.import.linked=true|false

指定是否将 .dsp 项目源文件夹链接到创建的 Eclipse 项目中。

默认值为 true

dsp.import.subdirs=true|false

适用于 dsp.import.location=<path> 的情况

指定将项目导入子目录或直接导入指定位置。

如果要将项目导入在指定的外部位置创建的子目录中,则使用 true。如果只导入一个项目并且希望将该项目直接导入指定的外部位置,则使用 false。

默认值为 true(为导入外部位置的每个项目创建子文件夹)。

dsp.import.pathvar.enabled=true|false

指定创建链接目录时是否应使用路径变量(如果上述选项设置为 true)。

默认值为 false

dsp.import.pathvar.name=<name>

指定路径变量名。除非指定了指向不同位置的路径变量名(例如,DEVEL_ROOT_DIR),否则使用默认值。

如果在 Eclipse 工作空间中已经定义了具有指定名称的项目,并且该名称指向的位置与在 dsp.import.pathvar.location 属性中传递的值不同,则不会使用路径变量,而是使用完整路径。同样,如果未指定 dsp.import.pathvar.name 属性,那么 dsp.import.pathvar.name 的默认值始终为 DEVEL_ROOT_DIR。如果此属性使用某个 <name> 指定,那么该 <name> 将用作路径变量名。

默认值为 DEVEL_ROOT_DIR

dsp.import.pathvar.location=<loc>

指定 path 变量指向的位置。默认情况下,将使用自动生成的位置。此位置是所有链接目录的公共根位置。如果无法找到公共位置(例如,.dsp 项目位于多个驱动器上)或无法使用指定的位置,则不会使用路径变量,而是使用完整路径。

例如,假设您拥有以下路径:

path1: c:\a\b\c\proj1

path2: c:\a\b\proj2

公共根位置将是 c:\a\b

该默认值自动生成。

dsp.import.config=<name>

指定应使用哪个 .dsp 项目配置。如果在导入的项目中找不到指定的配置,将使用默认配置。

配置名称可以通过两种方式传递:<project_name> - <configuration_name><configuration_name>。如果导入了多个项目,则应该只输入 <configuration_name>。这会指示向导在所有项目中搜索该配置。

默认值为 .dsp 中的默认值。

例如,如果在导入的项目中应该链接文件夹 C:\temp\sources,并且我们已经将路径变量 DEVEL_ROOT_DIR 值定义为 C:\temp,那么该文件夹将被链接为 DEVEL_ROOT_DIR/sources,并且 DEVEL_ROOT_DIR 路径变量将在工作空间中创建。如果不能使用该变量(例如,变量的值指向另一个不包含 C:\temp\sources 文件夹的文件夹,变量已定义并且具有不同的值,或者变量具有无效的值),那么 C:\temp\sources 文件夹将使用完整路径 C:\temp\sources 进行链接。

用于导入 Keil uVision 项目的设置

设置
目的
uv.import.location=WORKSPACE|ORIG|<path>

指定导入项目的位置。

如果使用 WORKSPACE,项目将在工作空间中创建。

如果使用 ORIG,项目将在原始项目文件位置创建。

如果指定了外部路径,项目将在指定位置创建。

默认值为 WORKSPACE

uv.import.linked=true|false

指定是否将 uVision 项目源文件夹链接到创建的 Eclipse 项目中。

默认值为 true

uv.import.subdirs=true|false

适用于 uv.import.location=<path> 的情况

指定将项目导入子目录或直接导入指定位置。

如果要将项目导入在指定的外部位置创建的子目录中,则使用 true

如果只导入一个项目并且希望将该项目直接导入指定的外部位置,则使用 false

默认值为 true(为导入外部位置的每个项目创建子文件夹)。

uv.import.pathvar.enabled=true|false

指定创建链接目录时是否应使用路径变量(如果上述选项设置为 true)。

默认值为 false

uv.import.pathvar.name=<name>

指定路径变量名。除非指定了指向不同位置的路径变量名(例如,DEVEL_ROOT_DIR),否则使用默认值。

如果在 Eclipse 工作空间中已经定义了具有指定名称的项目,并且该名称指向的位置与在 uv.import.pathvar.location 属性中传递的值不同,则不会使用路径变量,而是使用完整路径。同样,如果未指定 uv.import.pathvar.name 属性,那么 uv.import.pathvar.name 的默认值始终为 DEVEL_ROOT_DIR。如果此属性使用某个 <name> 指定,那么该 <name> 将用作路径变量名。

默认值为 DEVEL_ROOT_DIR。

uv.import.pathvar.value=<path>指定路径变量值。默认情况下,C++test 会为所有链接文件夹计算公共根目录。
uv.import.config=<name>指定要使用的构建配置的名称。

用于导入 Renesas High-performance Embedded 项目的设置

设置
目的
hew.import.location=WORKSPACE|ORIG|<path>

指定导入项目的位置。

如果使用 WORKSPACE,项目将在工作空间中创建。

如果使用 ORIG,项目将在原始项目文件位置创建。

如果指定了外部路径,项目将在指定位置创建。

默认值为 WORKSPACE

hew.import.linked=true|false

指定是否将 HEW 项目源文件夹链接到创建的 Eclipse 项目中。

默认值为 true

hew.import.subdirs=true|false

适用于 hew.import.location=<path> 的情况

指定将项目导入子目录或直接导入指定位置。

如果要将项目导入在指定的外部位置创建的子目录中,则使用 true

如果只导入一个项目并且希望将该项目直接导入指定的外部位置,则使用 false

默认值为 true(为导入外部位置的每个项目创建子文件夹)。

hew.import.pathvar.enabled=true|false

指定创建链接目录时是否应使用路径变量(如果上述选项设置为 true)。

默认值为 false

hew.import.pathvar.name=<name>

指定路径变量名。除非指定了指向不同位置的路径变量名(例如,DEVEL_ROOT_DIR),否则使用默认值。

如果在 Eclipse 工作空间中已经定义了具有指定名称的项目,并且该名称指向的位置与在 hew.import.pathvar.location 属性中传递的值不同,则不会使用路径变量,而是使用完整路径。同样,如果未指定 hew.import.pathvar.name 属性,那么 hew.import.pathvar.name 的默认值始终为 DEVEL_ROOT_DIR。如果此属性使用某个 <name> 指定,那么该 <name> 将用作路径变量名。

默认值为 DEVEL_ROOT_DIR

hew.import.pathvar.value=<path>指定路径变量值。默认情况下,C++test 会为所有链接文件夹计算公共根目录。
hew.import.config=<name>指定要使用的构建配置的名称。

杂项设置

设置目的
console.verbosity.level=low|normal|high

为控制台视图指定详细级别。可选设置有:

low:配置控制台视图以显示错误和有关当前步骤名称和状态的基本信息(完成、失败、最新)。

normal:同时还显示命令行以及测试和分析期间报告的问题。

high:同时还显示警告。

默认:low

tasks.clear=true|false

在 cli 模式下启动时清除现有任务。这可以防止花费过多的时间“加载已有的结果”。 

默认:true

cpptest.custom.rules.dir=[directory]

指示用户自定义规则保存的位置。

cpptest.custom.configs.dir=[directory]

指示用户自定义规则测试配置保存的位置。

custom.compilers.dir=[directory]重写自定义编译器目录设置(Parasoft> 配置> 自定义编译器)并使用定义的目录搜索自定义编译器。
exec.env=[env1; env2; ...]指定描述执行测试会话环境的标签列表。标签可以描述操作系统(录入,Windows、Linux)、体系结构(例如,x86、x86_64)、浏览器等。这些标签描述了一个完整的测试会话;还可以通过服务 API 在测试套件、测试或测试用例级添加更多的环境细节。
issue.tracking.tags=[value]

指定自定义问题跟踪标签。多个标签可以用逗号分隔。例如:

issue.tracking.tags=@custom,@pr ,@fr

更多详细信息,请参阅将测试与开发工件相关联

parallel.mode=Manual|Auto|Disabled

指定激活以下哪种模式: 

  • Auto:允许 C/C++test 控制并行处理设置。
  • Manual:允许手动配置并行处理设置以满足您的特定需求。
  • Disabled:将 C/C++test 配置为仅使用一个可用的 CPU。

有关此选项和其他并行处理选项的详细信息,请参阅配置并行处理

默认: Auto

parallel.max_threads=<number>

指定可同时执行的并行线程的最大数量。  并行线程的实际数量取决于 CPU 数量、可用的内存和许可证设置。

默认:[available_processors]

parallel.free_memory_limit=[percentage]

指定低内存条件下应保持空闲的内存量(以应用程序可用内存总量的百分比表示)。这样可以确保有其他进程可以使用的空闲内存。

默认:25

parallel.no_memory_limit=true|false

指示不对 Parasoft Test 使用的内存施加任何限制(超出现有系统限制)。 

默认:false

cpptest.fail.setup.problems=true|false

启用或禁用返回 0x40 退出码的功能,该退出码表示进程失败时报告了设置问题;详细信息请参阅命令行退出代码

默认:false

cpptest.advanced.settings.file=[path]指定高级设置文件的路径;请参阅配置高级选项

usage.reporting.enabled=true|false

启用或禁用收集匿名使用信息并发送给 Parasoft 的功能。更多信息,请阅读我们的隐私声明:https://www.parasoft.com/privacy-policy

默认:false

在设置文件中使用变量

有关可在报告、电子邮件、Parasoft DTP 和许可证设置中使用的变量的信息,请参阅常规变量

示例

示例 1

# Report settings
report.developer_errors=true 
report.developer_reports=true 
report.format=html
session.tag=<project name>
 
# Mail settings:
report.mail.enabled=true
report.mail.cc=<[email protected];[email protected]> 
report.mail.server=mail.company.com
report.mail.domain=company.com
report.mail.subject=<Static Analysis results on Project X> 
report.mail.attachments=true

示例 2

# Parasoft DTP settings   
dtp.enabled==true
dtp.url=https://server1.mycompany.com:8443
dtp.user=smith
dtp.password=?1q2W3e4R5t6Y7u8I9o!  

# Mail settings
report.mail.enabled=true
report.mail.server=mail.mycompany.com   
report.mail.domain=mycompany.com   
report.mail.cc=project_manager   
report.mail.subject=Coding Standards   

示例 3

# REPORTS
 
#Determines whether reports are emailed to developers and to the additional recipients specified with the cc setting.
#Remember that if the team is using CVS for source control and each developer's email address matches his or her CVS username + the mail domain, each developer that worked on project code will automatically be sent a report that contains only the errors/results related to his or her work.

report.mail.enabled=true
 
#Exclude developers emails (true/false) 
report.mail.exclude.developers=false
 
# Append developers errors to manager emails (true/false) 
report.developer_errors=true
 
# Send reports to developers (true|false) 
report.developer_reports=true
 
# Append suppressed messages (true|false) 
report.suppressed_msgs=false
 
#Determines where to mail complete test reports.
#This setting is typically used to send reports to managers or architects.
#It can also be used to send reports to developers if developer reports
#are not sent automatically (for example, because the team is not using CVS). 
[email protected]; ${env_var:USERNAME} @domain.com
 
# mail target for unknown developer errors 
[email protected]
 
#Specifies the mail server used to send reports. 
report.mail.server=mail_server.domain.com
 
#Specifies the mail domain used to send reports. 
report.mail.domain=domain.com
 
#Specify mali from 
report.mail.from=nightly
 
#Specifies any email addresses you do not want to receive reports.
#This setting is used to prevent from automatically sending reports to someone that worked on the code, but should not be receiving reports. This setting is only applicable if the team is using CVS for source control and developer reports are being sent automatically.
report.mail.exclude=developer1;developer2
 
# Specifies the subject line of the emails sent.
report.mail.subject= ${tool_name} Report - ${config_name}
 
# Report test params include (true|false) 
report.test_params=true
 
# SCOPE
 
#code authorship based on CVS 
scope.sourcecontrol=true
 
#code authorship based on author tag 
scope.author=false
 
#code authorship based on local user 
scope.local=false
 
# LICENSE

#network license retrieved from DTP
dtp.enabled=true
dtp.url=https://onya.mycompany.com:8443
dtp.user=user1
dtp.password=mypassword
cpptest.license.use_network=true
 
# SOURCE CONTROL
 
scontrol.rep1.type=cvs
scontrol.rep1.cvs.root=:pserver:developer@cvs_server.domain.com:/home/cvs/scontrol.rep1.cvs.pass=mypassword