Main Content

simulinkproject

(不推荐)打开工程并获取工程对象

不推荐使用 simulinkproject。请改用 currentProjectopenProject。有关详细信息,请参阅兼容性注意事项

说明

示例

simulinkproject 打开工程或将焦点置于该工具(如果该工具已打开)。打开该工具后,您可以创建工程或使用工程选项卡访问最近的工程。

示例

simulinkproject(projectPath) 打开 projectPath 中的工程根文件夹下的任意文件或文件夹指定的工程,并将焦点赋予该工程。

示例

proj = simulinkproject 返回一个工程对象 proj,您可以在命令行中使用该对象操作工程。在可以使用任何其他工程功能前,您需要获取工程对象。

示例

proj = simulinkproject(projectPath) 会打开 projectPath 指定的工程并返回一个工程对象。

示例

全部折叠

打开工程工具。

simulinkproject

指定 .prj 文件路径或包含您的 .SimulinkProject 文件夹和 .prj 文件的文件夹。工程随即打开,并将焦点赋予工程。

simulinkproject('C:/projects/project1/')

打开指定工程并获取工程对象,以在命令行操作工程。为避免启动脚本打开的窗口从 MATLAB® 桌面带走焦点,请使用 start_simulink 而不是 simulink 函数,并使用带输出参量的 simulinkproject 而不是 uiopen。如果使用 uiopen(myproject.prj),这将调用不带输出参量的 simulinkproject,并将焦点赋予工程。

start_simulink
proj = simulinkproject('C:/projects/project1/myproject.prj')

打开 Airframe 工程并创建工程对象以在命令行操作和浏览该工程。

openExample('simulink/AirframeProjectExample')
proj = simulinkproject
proj = 

  ProjectManager with properties:

             Name: 'Simulink Project Airframe Example'
      Information: [1x1 slproject.Information]
     Dependencies: [1x1 slproject.Dependencies]
       Categories: [1×1 slproject.Category]
            Files: [1×31 slproject.ProjectFile]
        Shortcuts: [1×7 slproject.Shortcut]
      ProjectPath: [1×7 slproject.PathFolder]
ProjectReferences: [1×0 slproject.ProjectReference]
     StartupFiles: [1×0 slproject.StartupFile]
    ShutdownFiles: [1×0 slproject.ShutdownFile]
       RootFolder: 'C:\slexamples\airframe11'

了解您可以对工程执行哪些操作。

methods(proj)
Methods for class slproject.ProjectManager:


addFile                       
addFolderIncludingChildFiles  
addPath                       
addReference                  
addShortcut                   
addShutdownFile                    
addStartupFile
close                         
createCategory                
export                        
findCategory                  
findFile                      
isLoaded                      
listModifiedFiles             
listRequiredFiles             
refreshSourceControl          
reload                        
removeCategory                
removeFile                    
removePath                    
removeReference               
removeShortcut
removeShutdownFile
RemoveStartupFile   

在使用 simulinkproject 函数获取工程对象后,可以检查工程属性。

检查工程文件。

files = proj.Files
files = 

  1x31 ProjectFile array with properties:

    Path
    Labels
    Revision
    SourceControlStatus

使用索引访问此列表中的文件。以下命令将获取第 14 个文件。每个文件都具有描述其路径、连接的标签和源代码管理信息的属性。

proj.Files(15)
ans = 

  ProjectFile with properties:

      Path: 'C:\slexamples\airframe24\models\DigitalControl.slx'
                 Labels: [1x1 slproject.Label]
               Revision: '2'
    SourceControlStatus: Unmodified

检查文件的标签。

proj.Files(15).Labels
ans = 

  Label with properties:

File: 'C:\slexamples\airframe24\models\DigitalControl.slx'
        DataType: 'none'
            Data: []
            Name: 'Design'
    CategoryName: 'Classification'

按名称获取特定文件。

myfile = findFile(proj,'models/AnalogControl.slx')
myfile = 

  ProjectFile with properties:

  Path: 'C:\slexamples\airframe24\models\AnalogControl.slx'
                 Labels: [1×1 slproject.Label]
               Revision: '2'
    SourceControlStatus: Unmodified

了解您可以对文件执行哪些操作。

methods(myfile)
Methods for class slproject.ProjectFile:

addLabel     findLabel    removeLabel

更新文件依存关系。

update(proj.Dependencies)

工程会运行依存关系分析以更新工程文件之间的已知依存关系。

有关处理工程文件(包括修改的文件和依存关系)的详细信息,请参阅Automate Project Tasks Using Scripts

输入参数

全部折叠

工程 .prj 文件的完整路径、工程根文件夹的路径或工程根文件夹下的任何子文件夹或文件,指定为字符向量。

示例: 'C:/projects/project1/myProject.prj'

示例: 'C:/projects/project1/'

输出参量

全部折叠

工程,以工程对象形式返回。使用工程对象可在命令行操作当前打开的工程。

proj 输出参量的属性。

工程属性描述
类别工程标签的类别
依存关系MATLAB 有向图对象中的工程文件之间的依存关系
文件工程文件的路径和名称
信息有关工程的信息,如描述、源代码管理集成、存储库位置以及是否为顶层工程
名称工程名称
ProjectPath

MATLAB 路径中放置工程的文件夹

ProjectReferences包含引用的工程的文件夹。包含用于引用的工程的只读工程对象。
RootFolder工程根文件夹的完整路径
快捷方式此工程中快捷方式的数组
ShutdownFiles此工程中关闭文件的数组
StartupFiles此工程中启动文件的数组

提示

或者,您可以使用 slproject.loadProject 加载工程,然后使用 slproject.getCurrentProjects 获取工程对象。使用 simulinkproject 打开工程,并以交互方式浏览工程。将 slproject.getCurrentProjectsslproject.loadProject 用于工程自动化脚本。

版本历史记录

在 R2012a 中推出

全部折叠

R2019a: 不推荐 Simulink 工程 API

从 R2019a 开始,请使用 MATLAB 中的 currentProjectopenProject 函数,而不是 simulinkproject 和相关函数。软件将继续支持 Simulink® 工程 API,但在 R2019a 后,新功能将只在新的 MATLAB 工程 API 中可用。当前没有删除 Simulink 工程 API 的计划。

您可以继续使用 simulinkproject 以及 methods(simulinkproject) 中列出的相关函数。在 R2019a 后添加的新函数,如 runCheckslistImpactedFiles,不适用于 simulinkproject。请改用 currentProject

MATLAB 工程 API 是 R2019a 的新功能之一,使用这一功能,无论您是否有 Simulink,都可以在 MATLAB 中使用工程。您现在可以与没有 Simulink 的用户共享工程。