Project and File Management

R2026b

Manage projects and files for version control workflows

Manage a Polyspace^® Platform project and its associated files to improve sharing, reuse, and integration with version control systems. For instance, you can organize your graphical tests in named collections called test suites, or create a workspace to group and manage related projects.

Modularize your Polyspace Platform project by saving components such as configurations and graphical tests in separate files that are linked to the project by reference. You can submit your Polyspace Platform project file to version control along with its sources and component files, or you can submit only the sources and project component files and use the Polyspace Python^® API to create projects on demand from their component parts.

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

Polyspace Options

expand all

Sources, Includes, and Tests

`Include paths (-I)`	Specify paths to folders containing include files
`Application source folders`	Add source folders to Polyspace Platform project (Since R2024a)
`Application source files`	Add source files to Polyspace Platform project
`Stub source folders`	Add stub source folders to Polyspace Platform project (Since R2026a)
`Stub source files`	Add stub source files to Polyspace Platform project (Since R2026a)
`Polyspace xUnit test folders`	Add Polyspace xUnit test folders to Polyspace Platform project (Since R2024a)
`Polyspace xUnit test files`	Add Polyspace xUnit test files to Polyspace Platform project (Since R2024a)
`External test folders`	Add external test folders to Polyspace Platform project (Since R2024a)
`External test files`	Add external test files to Polyspace Platform project (Since R2024a)

Environment Variables

Project variables Define environment variables for use as shorthands in Polyspace Platform project (Since R2024a)

Generated Files

Artifacts directory Specify folder for storing project artifacts such as generated test code and build information (Since R2025a)

Tools

Polyspace Platform Settings	Settings for Polyspace Platform user interface (Since R2023b)
Test Case	Author graphical tests in the Polyspace Platform user interface (Since R2023b)

Topics

Modularize Projects

Modularize Project by Using External Configurations, Test References, and External Stub Files
Separate your Polyspace Platform project into multiple files to improve sharing and version control workflows.
Import and Export Graphical Tests
Import or export copies of a graphical test.
Modularize Existing Project by Using Polyspace Python API
Use Python scripts to modularize existing projects by converting configurations and graphical tests to files referenced by the project.
Create Project Dynamically by Using Polyspace Python API
Use Python scripts to dynamically generate projects from sources, configurations, and tests.

Organize Projects and Tests

Manage Related Projects in Polyspace Platform User Interface Using Workspaces
Create workspace from open projects, add projects to workspace, save workspace.
Organize Graphical Tests in Polyspace Platform Project Using Test Suites
Create test suites, move tests into suites, and run an individual test suite.

Update Projects and Tests

Update Projects in Polyspace Platform User Interface
Update source files in Polyspace Platform projects.
Update Tests in Polyspace Platform User Interface
Update one or more tabular test steps to account for source code changes, including function remapping and type definition updates.

Work with Files in Version Control

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.
Submit Polyspace Files to Version Control
Learn which Polyspace files to submit to version control systems.
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.
Artifacts and Results Generated by Polyspace Platform Projects
Learn about the files Polyspace generates when you build a project or run static analysis or tests.