预定义命令行操作
- 更新时间2025-08-27
- 阅读时长10分钟
用于LabVIEW的命令行接口支持以下操作:
- MassCompile―批量编译指定目录中的文件。
- ExecuteBuildSpec―使用指定生成规范中的设置生成应用程序或库,并返回输出文件的路径。
- RunVI―使用预定义连线板接口运行VI,并返回输出或错误信息。
- CloseLabVIEW―关闭LabVIEW,无提示。
- CreateComparisonReport―生成两个指定VI的VI比较报告。
- (VI Analyzer工具包)RunVIAnalyzer―在LabVIEW VI Analyzer工具包中运行指定的VI Analyzer任务,并将测试报告保存到指定位置。
- (Unit Test Framework工具包)RunUnitTests―在LabVIEW Unit Test Framework工具包中对指定文件运行测试,并将JUnit文件保存到指定位置。
也可在LabVIEW中创建自定义操作。
MassCompile
批量编译指定目录中的文件。
下表列出了该操作可用的参数。必需参数以粗体显示。
如需在用于LabVIEW的CLI运行该操作,请使用以下语法执行命令:
LabVIEWCLI -OperationName MassCompile -DirectoryToCompile <文件目录> -MassCompileLogFile <日志文件路径> -AppendToMassCompileLog <true或false> -NumOfVIsToCache <要缓存的VI数> -ReloadLVSBs <true或false>
例如,LabVIEWCLI -OperationName MassCompile -DirectoryToCompile "C:\temp" -MassCompileLogFile "C:\temp\log.txt" -AppendToMassCompileLog true -NumOfVIsToCache 0 -ReloadLVSBs false
ExecuteBuildSpec
使用指定生成规范中的设定生成应用程序或库,并返回输出文件的路径。
下表列出了该操作可用的参数。必需参数以粗体显示。
| 参数 | 说明 | 默认 |
|---|---|---|
| −ProjectPath | 包含程序生成规范的LabVIEW项目(.lvproj)文件的路径。 | — |
| −TargetName | 包含程序生成规范的终端。 | 我的电脑 |
| −BuildSpecName | 在项目浏览器窗口中程序生成规范下显示的名称。 | 空字符串 - 用于LabVIEW的CLI将生成指定终端下的所有程序生成规范。 |
如需在用于LabVIEW的CLI运行该操作,请使用以下语法执行命令:
LabVIEWCLI -OperationName ExecuteBuildSpec -ProjectPath <项目路径> -TargetName <终端名称> -BuildSpecName <程序生成规范名称>
例如,LabVIEWCLI -OperationName ExecuteBuildSpec -ProjectPath "C:\temp\test.lvproj" -TargetName "My Computer" -BuildSpecName "My DLL"
RunVI
使用以下连线板接口运行VI,并返回输出或错误信息。
| 接线端 | 数据类型 | 说明 |
|---|---|---|
|
|
|
VI的命令行参数。 |
|
|
|
VI返回的用于LabVIEW的CLI退出代码。 |
|
|
|
要包含在用于LabVIEW的CLI控制台或日志文件中的输出或错误信息。 |
下表列出了该操作可用的参数。必需参数以粗体显示。
| 参数 | 说明 | 默认 |
|---|---|---|
| −VIPath | 要在LabVIEW中运行的VI的路径。如果VI的连线板与预定义的接口不匹配,则用于LabVIEW的CLI返回错误。 | — |
| <VI的命令行参数> | VI输入数组的元素。用空格分隔元素。 | — |
如需在用于LabVIEW的CLI运行该操作,请使用以下语法执行命令:
LabVIEWCLI -OperationName RunVI -VIPath <VI路径> <数组的第一个元素> <数组的第二个元素>...
例如,LabVIEWCLI -OperationName RunVI -VIPath "C:\Users\inlabview.APAC\Documents\DemoProject\RunVI.vi" 101 202
CloseLabVIEW
关闭LabVIEW,无提示。
该操作没有任何参数。
如需在用于LabVIEW的CLI运行该操作,请执行以下命令:
LabVIEWCLI -OperationName CloseLabVIEW
CreateComparisonReport
比较两个指定的VI并输出包含比较操作结果的HTML、XML、Word或文本报告。
| 参数 | 说明 | 默认 |
|---|---|---|
| −vi1 | 正在比较的第一个VI的名称或路径。 | — |
| −vi2 | 正在比较的第二个VI的名称或路径。 | — |
| −reportType | 输出报告的所需文件类型。该参数支持下列值:
如未指定此参数,则会根据-reportPath提供的值推断报告格式。 | HTMLSingleFile |
| −reportPath | 输出报告的名称或路径。 | — |
| −o | 覆盖指定报告目录中的现有报告和支持文件(如有)。 | — |
| −c | 如指定报告路径不存在,则为其创建一个新目录。 | — |
| −nofp | 从比较报告中排除前面板差异。 | — |
| −nofppos | 从比较报告中排除前面板位置差异。 | — |
| −nobd | 从比较报告中排除程序框图差异。 | — |
| −nobdcosm | 从比较报告中排除程序框图的外观差异。 | — |
| −noattr | 从比较报告中排除VI属性差异。 | — |
| -d | 比较不含依赖关系的指定VI。 | — |
如需在用于LabVIEW的CLI运行该操作,请使用以下语法执行命令:
LabVIEWCLI -OperationName CreateComparisonReport -vi1 <第一个VI的名称或路径> -vi2 <第二个VI的名称或路径> -reportType <报告的文件类型> -reportPath <输出报告的名称或路径>
例如,LabVIEWCLI -OperationName CreateComparisonReport -vi1 "firstVI.vi" -vi2 "secondVI.vi" -reportType "HTMLSingleFile" -reportPath "report.html"
RunVIAnalyzer
LabVIEW VI Analyzer工具包中运行指定的VI分析器任务,并将测试报告保存到指定位置。
下表列出了该操作可用的参数。必需参数以粗体显示。
| 参数 | 说明 | 默认 |
|---|---|---|
| −ConfigPath | 包含分析时要使用的VI分析器任务设置的配置文件路径。可使用通过VI Analyzer或VI Analyzer VI保存的配置文件。此外,也可指定要分析的VI、文件夹或LLB。如果指定配置文件以外的文件,则VI将对该文件运行所有VI分析器测试。 | — |
| −ReportPath | 报告文件的路径。 | — |
| −ConfigPassword | 配置文件的密码(如有)。 | 空字符串 |
| −ReportSaveType | 报告或结果文件的格式。该参数的值必须是以下值之一:
|
ASCII |
| −ResultsPath | 报告文件的路径。如路径为空字符串,LabVIEW将忽略该参数。 注: 该参数区分大小写。 |
— |
如需在用于LabVIEW的CLI运行该操作,请使用以下语法执行命令:
LabVIEWCLI -OperationName RunVIAnalyzer -ConfigPath <配置文件路径> -ReportPath <报告路径> -ReportSaveType <报告文件类型> -ConfigPassword <配置文件密码>
例如,LabVIEWCLI -OperationName RunVIAnalyzer -ConfigPath "C:\temp\test.viancfg" -ReportPath "C:\temp\output.html" -ReportSaveType "HTML" -ConfigPassword "abc"
RunUnitTests
在LabVIEW Unit Test Framework工具包中对指定文件运行测试,并将JUnit文件保存到指定位置。
下表列出了该操作可用的参数。必需参数以粗体显示。
| 参数 | 说明 | 默认 |
|---|---|---|
| −ProjectPath | 项目文件路径。 | — |
| −JUnitReportPath | 输出JUnit文件的路径。 | — |
如需在用于LabVIEW的CLI运行该操作,请使用以下语法执行命令:
LabVIEWCLI -OperationName RunUnitTests -ProjectPath <项目文件路径> -JUnitReportPath <输出JUnit文件的路径>
例如,LabVIEWCLI -OperationName RunUnitTests -ProjectPath "C:\temp\test.lvproj" -JUnitReportPath "C:\temp\test.xml"
相关内容
- 使用LabVIEW命令行界面比较VI
可使用LabVIEW命令行界面(CLI)通过编程比较两个VI并生成比较报告,列出两个文件之间的差异。