Projects view

The Projects View offers a file browser for your projects, including external folders that are not physically part of your project. This can be useful for including external IP in your projects.

The Projects View also offers a lot of custom Sigasi functionality, such as library mapping, version setting, and project settings.

Buttons in the projects view

• Create a new file
• Create a new folder
• Refresh
• Collapse all folders in the projects view
• More Actions
  • Follow Cursor: links the projects view with the editor
  • Hide Excluded Files: toggles whether excluded files should be hidden
  • Configure Excluded Files: opens settings to configure file exclusions

Excluding files

Files can be excluded from showing up in the Projects View. By default, project configuration files like .project, .library-mapping.xml, and .settings are filtered. The filtering can be customized through the following settings, accessible through the Configure Excluded Files button under More Actions:

• The sigasi.projectsView.exclude setting specifies a list of glob patterns to match files that will be excluded.
• The sigasi.projectsView.excludeNonHdlFiles setting ensures only HDL files are shown.
• The sigasi.projectsView.inheritGlobalExclude setting determines whether the global exclusion filter from VS Code should also be applied.

Filtering can be toggled through the Hide Excluded Files toggle button under More Actions.

Sigasi Projects in the Projects View

To accommodate new Sigasi Projects (preview) concepts, the Projects View represents such projects differently. The structure of the captured project is visualized in two different forms: as a filesystem centric Design perspective and as a logical Targets perspective.

The Design perspective allows navigating the structure of all directories that contribute to the project. The captured information from the build script might refer to files from various locations on disk or configured include paths, or rely on files that are located on shared drives. All the directories are accessible in the Design folder.

The Targets perspective reveals the logical structure of the project. For each defined target, a folder represents the libraries and their associated files. The files are rendered in the order of compilation wherever possible. This view will also reveal if some files are mentioned in the build scripts but are missing on disk.

You can open source files in the Targets perspective from the Code Lens at the top of the file.