Workspace (.slcw)

Workspace description files can be located anywhere on disk, either inside or outside an SDK. The location of the workspace description file is the root directory for the workspace, and all workspace-relative paths are resolved from this location. A workspace description file shall have the .slcw extension.

Properties

label

Required: Yes
Type: String

Human-readable string defining the name of the workspace.

description

Required: No
Type: String

Textual description of the workspace, meant to provide an end user with information about its functionality. Used for search and in user interfaces. The description is typically not more than a few sentences.

quality

Required: No
Type: String

The quality level of the workspace.

The following quality levels are available:

Quality	Description
production	Production Ready
evaluation	Evaluation
experimental	Experimental
deprecated	Deprecated
internal	Internal

GUI tools are expected to use the human-readable description when referring to project qualities.

project

Required: Yes
Type: List

List of references to projects making up the workspace. The sort order of this list encodes the build order of dependent projects, and the include order of exported include paths.

Key	Required	Type	Description
path	Yes	String	Path to .slcp file. Relative to the workspace or absolute.
id	Yes	String	Unique ID of the project in the context of this workspace. Used in post-build files and in the import section of projects.
output	No	String	Output directory for the generated project.

post_build

Required: No
Type: Object

Properties for post-build steps to be performed for this workspace. The workspace may reference an SDK template profile (A), or an existing, specific post-build file (B). When generating a workspace referencing an SDK template profile, the .slcw file shall be rewritten to point to the path of the resolved post-build file.

Key	Required	Type	Description
profile	A	String	The ID of the post-build profile to use from the SDK as a template for this workspace. If the requested profile doesn't exist in the SDK, an error is raised.
path	B	String	Path to post-build file.