Main Content

本页的翻译已过时。点击此处可查看最新英文版本。

simulinkproject

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

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

说明

示例

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

示例

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 工程并创建工程对象以在命令行操作和浏览该工程。

sldemo_slproject_airframe
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 输出参数的属性。

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

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

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

提示

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

兼容性注意事项

全部展开

从 R2019a 起不建议使用

另请参阅

函数

在 R2012a 中推出