在此列示了可在命令行中使用的命令。除非另有说明,否则,命令可同时与 Rhapsody.exe 和 RhapsodyCL.exe 配合使用。
通常,下列类型的命令不能与 RhapsodyCL 配合使用:图命令、配置管理命令和用于运行宏的命令。
如果尝试将不受支持的命令与 RhapsodyCL 配合使用,那么 RhapsodyCL 的行为将取决于是否设置了 -verbose switch:
注: 对处于源控制下的项目进行更改时,在运行
RhapsodyCL 之前检出该项目。
-cmd=addtomodel <file location> <withdescendants|withoutdescendants>
从指定的文件位置添加到当前模型。缺省值是 <withoutdescendants>。
-cmd=arccheckout <file name> <label/revision> <locked|unlocked> <recursive|nonrecursive>
(不能与 RhapsodyCL.exe 配合使用)
从归档中检出文件。
如果不想指定 <label/revision>,请使用 NULL。
-cmd=buildwithdep
构建组件及其所有依赖项。
-cmd=checkin <unit name> <label/revision> <locked|unlocked> <recursive|nonrecursive> <description>
(不能与 RhapsodyCL.exe 配合使用)
将单元检入归档。如果不想指定 <label/revision>,请使用 NULL。
例如,-cmd=checkin p1.sbs
NULL locked recursive "my description"
-cmd=checkmodel
启动“检查模型”操作。
在发出此命令前设置当前配置。
-cmd=checkout <unit name> <label/revision> <locked|unlocked> <recursive|nonrecursive>
(不能与 RhapsodyCL.exe 配合使用)
从归档中检出单元。如果不想指定 <label/revision>,请使用 NULL。
-cmd=close <NoSave>
关闭打开的 Rational Rhapsody 模型。缺省情况下,Rational Rhapsody 在关闭前将自动保存对模型所作的更改。如果不想让产品在关闭时保存所作的更改,请使用 NoSave 参数。
-cmd=closediagram <diagram type><diagram
name>
(不能与 RhapsodyCL.exe 配合使用)
关闭指定的图。
第一个参数指定图的类型。此参数可以使用下列其中一个值:omd、ucd、msc、collaboration 和 component。
第二个参数是模型中图的名称。
Connecttoarc <archive location>
(不能与 RhapsodyCL.exe 配合使用)
连接至归档。<archive location> 包括完整路径。
-cmd=creatediagram <diagram type><diagram
name>
(不能与 RhapsodyCL.exe 配合使用)
创建图。
第一个参数指定图的类型。此参数可以使用下列其中一个值:omd、ucd、msc、collaboration 和 component。
第二个参数是模型中图的名称。
-cmd=exit
关闭该项目并退出 Rational Rhapsody。
-cmd=forceroundtrip
执行往返,而不管文件的时间戳记。
-cmd=generate <component> <configuration>
对指定的组件和配置生成代码。
<component> 和 <configuration> 是可选参数。如果未指定,那么将使用活动组件和配置。与 GUI 中的生成选项一样,这将仅对修改元素生成代码。要重新生成所有代码,请使用 -regenerate 命令。
例如,-cmd=generate EXE Acme
如果要对多个组件生成代码或对给定组件的多个配置生成代码,则必须对每个组件/配置组合重复 generate 命令,例如:
-cmd=generate
compA cfg1 -cmd=generate compA cfg2 -cmd=generate compB cfg1
如果要对嵌套组件生成代码,请使用语法 outerComponent::innerComponent,例如:
-cmd=generate def::abc DefaultConfig
注: 如果要使用“定制代码生成”或要对 INTEGRITY 操作系统生成代码,请不要将此命令与
RhapsodyCL.exe 配合使用。改为将此命令与
Rhapsody.exe 配合使用。
-cmd=genwithdep
生成组件及其所有依赖项。
-cmd=GetCommandResult
发送运行至标准输出(或通过套接字方式的相关套接字)的最后一个命令的结果。
此命令仅可与 RhapsodyCL 配合使用。
注: If
如果要以套接字方式使用 RhapsodyCL,并在单行中发送多个命令后发送 GetCommandResult 命令,那么必须通过套接字每次读取单个命令的一个结果。
-cmd=gmr
执行
generate/make/run。
-cmd=import
根据当前配置中存储的反向工程设置来导入类。此命令与在 Rational Rhapsody 中选择的作用相同。
-cmd=make
使用当前配置构建应用程序。
make 是异步命令且必须是脚本中包含的所有命令中的最后一个命令。
因为 exit 是同步命令,所以不能将 exit(用于关闭项目并退出 Rational Rhapsody)跟在 make 命令后面;执行此操作将导致过早终止 make 命令。
如果计划在执行 make 命令之后运行应用程序,请使用 -syncmake 而不是 -make。在运行任何其他命令前将等待 make 命令完成。
-cmd=new <project location> <project
name>
在指定位置创建项目并对其分配指定名称。
-cmd=open <project name>
打开指定的项目。(RhapsodyCL.exe 仅可打开项目。Rhapsody.exe
-cmd=opendiagram <diagram type><diagram
name>
(不能与 RhapsodyCL.exe 配合使用)
打开指定的图。
第一个参数指定图的类型。此参数可以使用下列其中一个值:omd、ucd、msc、collaboration 和 component。
第二个参数是模型中图的名称。
-cmd=populatediagram <diagram type><diagram
name>
(不能与 RhapsodyCL.exe 配合使用)
填充指定的图。
第一个参数指定图的类型。此参数可以使用下列其中一个值:omd、ucd、msc、collaboration 和 component。
第二个参数是模型中图的名称。
-cmd=printcurrentdiagram
(不能与 RhapsodyCL.exe 配合使用)
打印打开的图。
-cmd=regenerate <component> <configuration>
如果已修改模型元素,那么对指定的组件和配置生成代码。
<component> 和 <configuration> 是可选参数。如果未指定,那么将使用活动组件和配置。
如果要对多个组件生成代码或对给定组件的多个配置生成代码,则必须对每个 component/configuration 组合重复 regenerate 命令,例如:
-cmd=regenerate compA cfg1
-cmd=regenerate compA cfg2 -cmd=regenerate compB cfg1
如果要对嵌套组件重新生成代码,请使用语法 outerComponent::innerComponent,例如:
-cmd=regenerate def::abc DefaultConfig
注: 如果要使用“定制代码生成”或要对 INTEGRITY 操作系统生成代码,请不要将此命令与
RhapsodyCL.exe 配合使用。改为将此命令与
Rhapsody.exe 配合使用。
-cmd=report <format> <name
+ location>
生成报告。
<format> 是报告格式(RTF 或 ASCII)。会自动添加文件扩展名(对于 RTF 是.rtf;对于 ASCII 是 .txt)。
<name
+ location> 指定报告的名称和位置。这些参数是可选参数。
如果未指定名称,那么将使用缺省文件名 RhapsodyRep.rtf。
如果未指定名称,那么将使用缺省位置(项目目录)。
在发出此命令前设置当前配置。
例如,-cmd=report RTF myReport
对于 RhapsodyCL,report 命令使用 Rational Rhapsody 内部报告程序且不会抽取图。
-cmd=roundtrip
将代码更改往返至模型。
在发出此命令前设置当前配置。
-cmd=runexternalprogram
运行指定的外部程序。
(不能与 RhapsodyCL.exe 一起用于运行基于 COM 的程序。)
-cmd=save
保存打开的项目。可在进行诸如双向、反向工程之类的更改之后使用。
-cmd=saveas <project name>
将项目保存至指定位置。<project
name> 可包含路径。
-cmd=setcomponent <active component
name>
设置活动组件。
如果要将嵌套组件制作为活动组件,请使用语法 outerComponent::innerComponent,例如:
-cmd=setcomponent def::abc
-cmd=setconfiguration <active configuration
name>
设置活动配置。
例如,-cmd=setconfiguration AcmeDebug
-cmd=setlog <log file>
将正常情况下发送至输出窗口的输出重定向至指定的日志文件。如果该参数未指定路径,那么日志文件将置于 Rational Rhapsody 目录中。如果指定了日志文件,那么输出不会发送至标准输出。
-cmd=setomroot <alternative OMROOT>
将变量 OMROOT 设置为新位置。此变量指定 Rational Rhapsody 安装的根目录。
要使此命令生效,它必须是命令行中指定的第一个选项。
-cmd=syncmake
使用当前配置构建应用程序。
与 make 命令相反,在运行任何其他命令之前 syncmake 命令会一直等待 make 命令完成。如果计划在构建应用程序之后就运行它,请使用 syncmake 而不是 make。