Build and Test Automation

R2026b

Build and run tests using a previously prepared Polyspace^® Platform project

Prepare a Polyspace Platform project in the user interface, then build and run tests programmatically:

polyspace-test -build myproject.psprjx -results-dir results
polyspace-test -run myproject.psprjx -results-dir results

For CI server workflows, see Build and Test Automation on Servers.

System Commands

expand all

Compare and Merge Projects

polyspace-project -diff, polyspace-project -merge (System Command) Compare and merge Polyspace Platform projects, workspaces, configurations and tests before submission to source control

Build and Run Tests

`polyspace-test -build`	(System Command) Build sources and tests in a Polyspace Platform project
`polyspace-test -run`	(System Command) Run tests in a Polyspace Platform project
`polyspace-test -monitor`	(System Command) Monitor execution of C/C++ xUnit tests and retrieve test and code profiling results

Generate Tests

`polyspace-test -generate-tests`	(System Command) Generate C/C++ unit tests automatically in a Polyspace Platform project
`polyspace-test -create-testgen-config`	(System Command) Create a default configuration file for automatic test generation in a Polyspace Platform project

Report, Convert, or Merge Results

`polyspace-test -report`	(System Command) Generate reports from test or code profiling results
`polyspace-test -convert`	(System Command) Convert test or code profiling results to standard Polyspace Test format
`polyspace-test -merge`	(System Command) Create a single test or code profiling result set from multiple result sets

Configure Execution Targets

`polyspace-test -manage-host-compiler`	(System Command) List or select host compilers for Polyspace Platform project build
`polyspace-test -manage-target-package`	(System Command) Register, list, configure or otherwise manage target packages for test execution or code profiling on targets
`polyspace-test -check-target-package`	(System Command) Check connection to target before test execution

Manage Add-ons

polyspace-test -manage-addon (System Command) Install or list add-ons for use with Polyspace Test

Miscellaneous

`polyspace-test -generate`	(System Command) Generate test registration function from a set of Polyspace Test C/C++ test files
`polyspace-test -version`	(System Command) Display Polyspace Test version

Topics

Source Control of Polyspace Platform Projects

Create Easily Shareable Projects for Version Control
Create projects that are easy to share and submit to version control by using relative paths, variables, and a modular project structure.
Compare and Merge Polyspace Platform Projects and Configurations Before Submission to Source Control
Compare Polyspace Platform projects (.psprjx files) with version in repository, and resolve conflicts in sources, configurations, or tests in project.

Build and Test Automation

Automate C/C++ Test Execution Using Polyspace Platform Projects
Build and run C/C++ tests in a project on a continuous integration (CI) server, upload results to Polyspace Access™ web server.
Automate C/C++ Code Profiling Using Polyspace Platform Projects
Calculate metrics such as code coverage, execution time, and memory use on a continuous integration (CI) server.

Testing on Targets

Automate C/C++ Test Execution on Targets Using Polyspace Platform Projects
Build and run tests on a custom target board programmatically using the command line interface, for instance, on a continuous integration server.
Automate C/C++ Code Profiling on Targets Using Polyspace Platform Projects
Calculate metrics such as code coverage or execution time on a custom target board using the command line interface.