matlab.project.Project

Project object

Description

The matlab.project.Project object represents the currently loaded project. Use the project object to programmatically manipulate the project, interact with source control, and find file dependencies.

Creation

To create a matlab.project.Project object, use the currentProject function to get the currently open project. For example:

proj = currentProject;

If no project is currently open, use the openProject function to load an existing project. For example:

proj = openProject("C:/workSpace/project1/");

To create and open a blank project and get the project object, use the matlab.project.createProject function. For example:

proj = matlab.project.createProject;

Properties

Name — Project name

string scalar

Project name, specified as a string scalar.

Description — Project description

string scalar

Project description, specified as a string scalar.

RootFolder — Path of project root folder

string scalar

Path of project root folder, specified as a string scalar.

TopLevel — Project top-level status

Read-only: logical

This property is read-only.

Top-level status, stored as a logical 1 (true) if the project is a top-level project.

ReadOnly — Project permission status

Read-only: logical

This property is read-only.

Project permission status, stored as a logical 1 (true) if the project has limited permissions when using add, remove, and create object functions. A referenced project status is always read-only to prevent modification.

DefinitionFilesType — Project definition file types

array of DefinitionFilesType objects

Project definition file types, specified as an array of DefinitionFilesType objects. Use matlab.project.convertDefinitionFiles to change the current project definition file type programmatically.

RepositoryLocation — Project repository location

Read-only: string scalar

This property is read-only.

Project repository location, stored as a string scalar.

SourceControlIntegration — Source control integration type

Read-only: string scalar

This property is read-only.

Source control integration type, stored as a string scalar.

Example: "Git"

Files — Paths of project files

array of ProjectFile objects

Paths of project files, specified as an array of ProjectFile objects. This property changes when you add or remove project files. You can use addFile, addFolderIncludingChildFiles, or removeFile to add or remove project files.

Shortcuts — Shortcut files

array of Shortcut objects

Shortcut files for project, specified as an array of Shortcut objects. This property changes when you add or remove shortcut files. You can use addShortcut and removeShortcut to create or remove shortcut files programmatically.

Categories — Label categories

array of Category objects

Label categories for project, specified as an array of Category objects. This property changes when you create or remove label categories. You can use createCategory and removeCategory to create and remove label categories programmatically.

Dependencies — Graph of dependencies between project files

digraph object

Graph of dependencies between project files, specified as a digraph object.

StartupFiles — Project startup files

string array

Project startup files, specified as a string array. This property changes when you add or remove startup files. You can use addStartupFile and removeStartupFile to add or remove startup files programmatically.

ShutdownFiles — Project shutdown files

string array

Project shutdown files, specified as a string array. This property changes when you add or remove shutdown files. You can use addShutdownFile and removeShutdownFile to add or remove shutdown files programmatically.

ProjectPath — Project path folders

array of PathFolder objects

Project path folders that are added to the MATLAB^® path, specified as an array of PathFolder objects.

ProjectReferences — Paths of referenced projects

array of ProjectReference objects

Paths of referenced projects, specified as an array of ProjectReference objects. This property changes when you add or remove reference projects. You can use addReference and removeReference to add or remove reference projects programmatically.

ProjectStartupFolder — Project startup folder

string scalar

Path of the project startup folder, specified as a string scalar.

SimulinkCacheFolder — Path of Simulink cache folder

string scalar

Path of Simulink^® cache folder, specified as a string scalar.

SimulinkCodeGenFolder — Path of Simulink Coder code generation folder

string scalar

Path of Simulink Coder™ code generation folder, specified as a string scalar.

DependencyCacheFile — Path of dependency analysis cache file

string scalar

Path of dependency analysis cache file, specified as a string scalar.

Object Functions

Create and Export Projects

currentProject	Get current project
openProject	Load an existing project
isLoaded	Determine if project is loaded
reload	Reload project
close	Close project
export	Export project to archive
matlab.project.createProject	Create blank project
matlab.project.convertDefinitionFiles	Change definition file type of project
matlab.project.deleteProject	Stop folder management and delete project definition files
matlab.project.loadProject	Load project
matlab.project.rootProject	Get root project

Set Up Projects

addFile	Add files or folders to project
addFolderIncludingChildFiles	Add folders and child files to project
removeFile	Remove file or folder from project
addPath	Add folder to project path
removePath	Remove folder from project path
addReference	Add referenced project to project
listAllProjectReferences	List all projects in reference hierarchy of current project
listShutdownIssues	List all issues that occur when project closes
listStartupIssues	List all issues that occur when project opens
removeReference	Remove project reference
addStartupFile	Add startup file to project
addShutdownFile	Add shutdown file to project
removeStartupFile	Remove file from project startup files
removeShutdownFile	Remove file from project shutdown files
addShortcut	Add shortcut to project
removeShortcut	Remove shortcut from project

Manage Project Files

addLabel	Attach label to project files
createLabel	Create project label
removeLabel	Remove label from project
findLabel	Get project file label
createCategory	Create category of project labels
findCategory	Find project category of labels
removeCategory	Remove project category of labels
findFiles	Find project files by category or label name
listModifiedFiles	List modified files in project
listRequiredFiles	Get files required by specified project files
listImpactedFiles	Get files impacted by changes to specified project files
listAllProjectReferences	List all projects in reference hierarchy of current project
refreshSourceControl	Update source control status of project files
runChecks	Run all project checks
updateDependencies	Update project dependencies
matlab.project.isUnderProjectRoot	Determine whether file or folder is under project root folder
matlab.project.isFileInProject	Determine whether file or folder belongs to project

Examples

Open Times Table App Example Project

Download the Times Table App project by clicking the button. The example project is under Git source control.

Alternatively, run the following command:

openExample("matlab/TimesTableProjectExample")

Create Project Object

Open the Times Table App project and use the currentProject function to create a project object that you can manipulate programmatically.

openExample("matlab/TimesTableProjectExample")
proj = currentProject

proj = 

  Project with properties:

                        Name: "Times Table App"
                 Description: "This example project contains the source code and tests for a simple educational app. ↵↵Use the project shortcuts to get started with this project."
                  RootFolder: "C:\Workspace\Projects\TimesTableApp"
                    TopLevel: 1
                    ReadOnly: 0
         DefinitionFilesType: FixedPathMultiFile
    SourceControlIntegration: "Git"
          RepositoryLocation: "C:Workspace\Projects\repositories\TimesTableApp"
                       Files: [1×13 matlab.project.ProjectFile]
                   Shortcuts: [1×4 matlab.project.Shortcut]
                  Categories: [1×3 matlab.project.Category]
                Dependencies: [1×1 digraph]
                StartupFiles: [1×0 string]
               ShutdownFiles: [1×0 string]
                 ProjectPath: [1×2 matlab.project.PathFolder]
           ProjectReferences: [1×0 matlab.project.ProjectReference]
         SimulinkCacheFolder: ""
        ProjectStartupFolder: "C:\Workspace\Projects\TimesTableApp"
       SimulinkCodeGenFolder: ""
         DependencyCacheFile: ""

Find Project Commands

Open the Times Table App project and create a project object.

openExample("matlab/TimesTableProjectExample")
proj = currentProject;

Find the functions that you can execute on the project object.

methods(proj)

Methods for class matlab.project.Project:

addFile                          findFiles                       removeLabel
addFolderIncludingChildFiles     isLoaded                        removePath
addLabel                         istAllProjectReferences         removeReference
addPath                          listImpactedFiles               removeShortcut
addReference                     listModifiedFiles               removeShutdownFile
addShortcut                      listRequiredFiles               removeStartupFile
addShutdownFile                  listShutdownIssues              runChecks
addStartupFile                   listStartupIssues               updateDependencies
close                            refreshSourceControl
createCategory                   reload
export                           removeCategory
findCategory                     removeFile

Methods of matlab.project.Project inherited from handle.                      

Examine Project Properties

Get a project object, and examine its properties.

Open the Times Table App project. Use currentProject to create a project object from the currently loaded project.

openExample("matlab/TimesTableProjectExample")
proj = currentProject;

Examine the project files.

files = proj.Files

files = 

  1×13 ProjectFile array with properties:

    Path
    Revision
    SourceControlStatus
    Labels

Examine the labels of the 13th file.

proj.Files(13).Labels

ans = 

  Label with properties:

            File: "C:\Workspace\Projects\TimesTableApp\utilities\runTheseTests.m"
        DataType: "none"
            Data: []
            Name: "Design"
    CategoryName: "Classification"

Get a particular file by name.

myfile = findFiles(proj,"source/timesTableGame.m",OutputFormat="ProjectFile")

myfile = 

  ProjectFile with properties:

                   Path: "C:\Workspace\Projects\TimesTableApp\source\timesTableGame.m"
               Revision: "a089d00d667d39be7940fcdcac18a9ca7a3c6840"
    SourceControlStatus: Unmodified
                 Labels: [1×1 matlab.project.Label]

Find out what you can do with the file.

methods(myfile)

Methods for class matlab.project.ProjectFile:

addLabel     findLabel    removeLabel  

Methods of matlab.project.ProjectFile inherited from handle.

Version History

Introduced in R2019a