用于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

批量编译指定目录中的文件。

下表列出了该操作可用的参数。必需参数以粗体显示。

注: 缓存VI可大幅减少批量编译的执行时间,因为编译顶层VI时LabVIEW无需加载已缓存的VI。但是,缓存VI可消耗更多的系统内存。如果批量编译的文件夹中包含不同子文件夹中的同名文件和不属于库的VI,则VI缓存可能会导致交叉链接

如需在用于LabVIEW的CLI运行该操作,请使用以下语法执行命令:

LabVIEWCLI -OperationName MassCompile -DirectoryToCompile <文件目录> -MassCompileLogFile <日志文件路径> -AppendToMassCompileLog <truefalse> -NumOfVIsToCache <要缓存的VI数> -ReloadLVSBs <truefalse>

例如,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,无提示。

注: 如果在运行该操作时VI是打开的,则任何未保存的更改都将丢失。运行该操作前,请确保保存所有更改。

该操作没有任何参数。

如需在用于LabVIEW的CLI运行该操作,请执行以下命令:

LabVIEWCLI -OperationName CloseLabVIEW

CreateComparisonReport

比较两个指定的VI并输出包含比较操作结果的HTML、XML、Word或文本报告。

下表列出了该操作可用的参数。必需参数以粗体显示。
参数说明默认
−vi1正在比较的第一个VI的名称或路径。
−vi2正在比较的第二个VI的名称或路径。
−reportType输出报告的所需文件类型。该参数支持下列值:
  • HTML-生成带有外部图像和样式文件的HTML格式报告。
  • HTMLSingleFile-生成带有嵌入式图像和样式定义的HTML格式报告。
  • MicrosoftWord-生成Microsoft Word格式的报告。
    注: 要在您的计算机上使用此选项,必须安装Microsoft Word。
  • PlainText-生成纯文本格式的报告。
  • XML-生成带有外部图像的XML格式报告。

如未指定此参数,则会根据-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
  • HTML
  • RSL文件
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文件保存到指定位置。

注: 要运行此操作,必须使用JKI VI Package Manager(VIPM)软件安装UTF 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"