TestStand API编程：从架构到实践的介绍

本文链接：https://blog.csdn.net/huyu107/article/details/147743969

TestStand API编程：从架构到实践的介绍

在自动化测试领域，NI TestStand 凭借其模块化架构和灵活性成为主流选择。而 TestStand API 作为其核心扩展接口，允许开发者通过编程方式深度定制测试流程、创建自定义工具及集成第三方应用。本文将结合官方技术文档，从架构原理、核心概念到实战应用全面解析 TestStand API 的编程要点。

一、TestStand 架构与 API 基础

1. 分层架构设计

TestStand 采用表示层与业务逻辑层分离的架构：

表示层：用户直接交互的界面（如序列编辑器、操作员界面）。
业务逻辑层：由 TestStand 引擎（Engine）驱动，负责测试流程控制、数据管理和执行调度。
通信桥梁：两层通过 TestStand API 实现交互，开发者可通过 API 调用引擎功能，扩展测试系统的灵活性。

2. API 技术底层：ActiveX/COM 架构

TestStand 引擎本质是一个 ActiveX/COM 自动化服务器，具备以下特性：

跨语言兼容性：支持 LabVIEW、C#、C++ 等多种编程语言通过 COM 接口调用。
对象模型：以面向对象方式封装测试元素（如序列文件、步骤、执行上下文），每个对象对应一个 API 类（如 SequenceFile、Execution）。
继承体系：多数类继承自 PropertyObject 基类，例如：

PropertyObject
├─ PropertyObjectFile
│  └─ SequenceFile（序列文件类，继承 Path、Save 等方法）
└─ Sequence（序列类，继承 Clone、GetNumSteps 等方法）

注：子类需通过 AsPropertyObject 方法显式转换才能访问父类方法，如 SequenceFile.AsPropertyObject.Clone()。

二、核心概念：对象、属性与关系

1. API 类与对象模型

TestStand API 定义了三类核心对象：

对象类型	代表元素	典型操作
文件与结构	`SequenceFile`（序列文件）	创建新序列、修改步骤属性、保存文件
执行上下文	`Execution`（执行）、`Thread`（线程）	控制测试流程、获取运行状态数据
基础元素	`Step`（步骤）、`Module`（模块）	添加步骤、配置适配器参数

2. 属性系统：内置属性与动态属性

内置属性（API 属性）：由类定义的固定属性，如 SequenceFile.Path、Step.AdapterKeyName，可直接通过代码访问。
动态属性（子属性）：对象实例特有的属性，需通过 PropertyObject 方法访问，例如：

// 访问步骤的动态属性“Limits.Low”
var lowLimit = step.AsPropertyObject.GetValNumber("Limits.Low", 0);

注意：动态属性需通过字符串路径（LookupString）定位，适用于运行时动态扩展场景。

3. 对象包含关系（API Containment）

TestStand 对象通过层级嵌套形成树形结构，典型关系如下：

Engine（引擎）
├─ SequenceFile（序列文件）
│  ├─ Sequence（序列）
│  │  └─ Step（步骤）
│  └─ FileGlobals（文件全局变量）
└─ Execution（执行）
   ├─ Thread（线程）
   │  └─ SequenceContext（序列上下文）
   └─ Report（报告）

导航示例：访问序列文件中名为 “MainSequence” 的步骤：

SequenceFile seqFile = engine.OpenSequenceFile("path/to/file.seq");
Step targetStep = seqFile.GetSequenceByName("MainSequence")
                         .GetStepByName("StepName", StepGroup_Main);

三、API 访问方式与实战场景

1. 两种典型编程模式

模式一：独立应用程序（创建引擎实例）
适用于开发自定义测试工具或完全独立的自动化系统。
模式二：嵌入现有 TestStand 环境（使用上下文对象）
适用于在代码模块中动态控制测试流程，通过 SequenceContext 获取当前执行状态。

2. 常见应用场景

场景 1：创建自定义属性（扩展测试数据）
场景 2：批量修改序列文件（自动化工具）

四、高级特性与最佳实践

1. 适配器 API：深度集成特定测试工具

针对不同适配器（如 LabVIEW、C# 代码模块），TestStand 提供专用 API 类。

2. 同步服务器 API：多线程协作

通过 SyncManager 创建队列、锁等同步对象，实现测试流程与外部监控程序的通信。

3. 最佳实践建议

优先使用 UI 控件 API：开发用户界面时，通过 TestStandUI 控件封装引擎交互，减少底层代码复杂度。
注意线程安全：跨线程访问引擎对象时，需通过 Marshal.ReleaseComObject 释放 COM 资源，避免内存泄漏。
测试数据持久化：SequenceFile 对象的修改会直接影响磁盘文件，而通过 RunState 或 SequenceContext 的修改仅作用于运行时，需根据需求选择合适对象。