主要内容

compiler.build.dotNETAssembly

为部署创建net程序集MATLAB

自从R2021a

所有的页面崩溃

语法

compiler.build.dotNETAssembly(文件)
compiler.build.dotNETAssembly(文件名称,值)
compiler.build.dotNETAssembly (ClassMap)
compiler.build.dotNETAssembly (ClassMap、名称、值)
compiler.build.dotNETAssembly(选择)
结果= compiler.build.dotNETAssembly (___)

描述

例子

compiler.build.dotNETAssembly (文件)创建一个使用MATLAB net程序集®指定的功能文件。

例子

compiler.build.dotNETAssembly (文件,名称,值)创建一个. net装配与使用一个或多个指定附加选项名称参数。选项包括类名、输出目录和包含额外的文件。

例子

compiler.build.dotNETAssembly (ClassMap)创建一个类。net程序集指定使用一个映射container.Map对象ClassMap。

例子

compiler.build.dotNETAssembly (ClassMap,名称,值)创建一个. net组装使用ClassMap和附加选项指定使用一个或多个名称参数。选项包括程序集名称、输出目录,包括额外的文件。

例子

compiler.build.dotNETAssembly (选择)创建一个与选项指定使用。net程序集compiler.build.DotNetAssemblyOptions对象选择。你不能指定其他选项使用名称-值参数。

例子

结果= compiler.build.dotNETAssembly (___)构建信息作为回报compiler.build.Results对象使用任何输入参数组合在以前的语法。构建信息包括构建类型,编译后的文件路径,构建选项。

例子

全部折叠

创建一个. net汇编在Windows®系统使用一个函数文件生成一个幻方。

在MATLAB中,找到你想要的MATLAB函数部署net程序集。对于这个示例,使用该文件magicsquare.m位于matlabroot\走读生\ \编译器例子。

appFile = fullfile (matlabroot,“外来的”,“例子”,编译器的,“magicsquare.m”);

构建一个。net组装使用compiler.build.dotNETAssembly命令。

compiler.build.dotNETAssembly (appFile);

构建函数生成下列文件在一个文件夹命名magicsquaredotNETAssembly在当前工作目录中:

  • GettingStarted.html——HTML文件,其中包含的信息集成组装。

  • included金宝appSupportPackages.txt文本文件,列出所有支持文件包含在组装。金宝app

  • magicsquare.dll动态链接库文件,可以使用访问mwArrayAPI。

  • magicsquare.xml——包含文档的XML文件mwArray组装。

  • magicsquare_overview.html——HTML文件,其中包含要求访问组件和用于生成参数使用mwArray类的层次结构。

  • magicsquareNative.dll动态链接库文件,可以使用本机API访问。

  • magicsquareNative.xmlXML文件,包含本地组装的文档。

  • magicsquareVersion.cs——c#文件,其中包含版本信息。

  • mccExcludedFiles.log日志文件,包含任何工具箱函数的列表,并不包括在应用程序。不受支持的功能的信息,请参阅金宝appMATLAB编译器限制。

  • 固定——文本文件,其中包含包装和接口信息。

  • requiredMCR下载188bet金宝搏Products.txt——文本文件,其中包含产品id所需的产品下载188bet金宝搏MATLAB运行时运行该应用程序。

  • unresolvedSymbols.txt——文本文件,其中包含的信息未解决符号。

创建一个. net汇编在Windows系统上使用名称-值参数和定制它。

对于这个示例,使用的文件flames.m和flames.mat位于matlabroot\走读生\ \编译器例子。

appFile = fullfile (matlabroot,“外来的”,“例子”,编译器的,“flames.m”);MATFile = fullfile (matlabroot,“外来的”,“例子”,编译器的,“flames.mat”);

构建一个。net组装使用compiler.build.dotNETAssembly命令。使用名称-值参数指定程序集名称和版本,添加一个MAT-file,并启用详细的输出。

compiler.build.dotNETAssembly (appFile“AssemblyName”,“FlamesComp”,…“AssemblyVersion”,“2.0”,…“AdditionalFiles”MATFile,…“详细”,“上”);

创建一个. net汇编在Windows系统上使用一个类映射文件和多个函数。

创建一个containers.Map对象的键是类名和函数文件的位置的值。

提出= containers.Map;提出(“Class1”)= {“exampleFcn1.m”,“exampleFcn2.m”};提出(“Class2”)= {“exampleFcn3.m”,“exampleFcn4.m”};

构建一个。net组装使用compiler.build.dotNETAssembly命令。

compiler.build.dotNETAssembly城市规划机构(cmap);

或者,您可以使用名称-值指定附加选项参数构建. net程序集时。

compiler.build.dotNETAssembly(提出,…“AssemblyName”,“MyExampleComp”,…“AssemblyVersion”,“2.0”,…“详细”,“上”);

创建多个。net程序集在Windows系统上使用compiler.build.DotNETAssemblyOptions对象。

对于这个示例,使用该文件magicsquare.m位于matlabroot\走读生\ \编译器例子。

appFile = fullfile (matlabroot,“外来的”,“例子”,编译器的,“magicsquare.m”);

创建一个DotNETAssemblyOptions对象使用appFile。使用名称-值参数来指定一个共同的输出目录,生成装配单独存档,并启用详细的输出。

选择= compiler.build.DotNETAssemblyOptions (appFile,…“OutputDir”,' D: \ \ MATLAB文件\ \工作dotNETBatch”,…“EmbedArchive”,“关闭”,…“详细”,“上”)
选择= DotNETAssemblyOptions属性:AssemblyName:“的例子。magicsquare ClassMap:(1×1容器。地图]DebugBuild:从EmbedArchive:从EnableRemoting:从FrameworkVersion:“4.0”SampleGenerationFiles: {} StrongNameKeyFile:“AssemblyVersion:“1.0.0.0”接口:“mwarray”AdditionalFiles: {} s + AutoDetectDataFiles: ons + ObfuscateArchive:杀死+ SupportPackages:{“自动检测”}详细:Out金宝appputDir: ' D: \ \ MATLAB文件\ \ dotNETBatch”类地图信息magicsquareClass: {“C: \ Program Files \ MATLAB \R2023aextern \ \ \编译器\ magicsquare.m例子'}

构建. net程序集使用DotNETAssemblyOptions对象。

compiler.build.dotNETAssembly(选择);

使用这个函数文件来编译hello.m相同的选择,使用点符号来修改ClassMap现有的COMComponentOptions对象在运行构建函数了。

删除(选择。ClassMap,keys(opts.ClassMap)); opts.ClassMap(“helloClass”)= fullfile (matlabroot,“外来的”,“例子”,编译器的,“hello.m”);compiler.build.dotNETAssembly(选择);

通过修改ClassMap参数,重新编译,您可以编译多个组件使用相同的选择对象。

创建一个. net汇编在Windows系统上构建并保存信息类型,生成的文件,包括支持包,和构建选项金宝appcompiler.build.Results对象。

编译使用文件magicsquare.m。

结果= compiler.build.dotNETAssembly (“magicsquare.m”)
结果=结果与属性:BuildType:“dotNETAssembly”文件:{4×1细胞}IncludedSupportPackages:{}选项:[1×1 compiler.b金宝appuild.DotNETAssemblyOptions]

的文件属性包含以下编译文件的路径:

  • magicsquare.dll

  • magicsquareNative.dll

  • magicsquare_overview.dll

  • GettingStarted.html

输入参数

全部折叠

文件实现MATLAB函数,指定为一个特征向量,一个字符串标量,字符串数组或单元阵列的特征向量。文件路径可以相对于当前工作目录或绝对的。文件必须有一个。m扩展。

例子:[" myfunc1.m”、“myfunc2.m”)

数据类型:字符|字符串|细胞

类图,指定为一个containers.Map对象。地图键类名和每个值的集合文件映射到相应的类。文件必须有一个。m扩展。

例子:提出

net程序集构建选项,指定为一个compiler.build.DotNETAssemblyOptions对象。

名称-值参数

指定可选的双参数作为Name1 = Value1,…,以=家,在那里的名字参数名称和吗价值相应的价值。名称-值参数必须出现在其他参数,但对的顺序无关紧要。

R2021a之前,用逗号来分隔每一个名称和值,并附上的名字在报价。

例子:“详细”,“上”

额外的文件和文件夹包含在. net程序集指定为一个特征向量,一个字符串标量,字符串数组或单元阵列的特征向量。路径可以是相对于当前工作目录或绝对的。

例子:“AdditionalFiles”, (“myvars.mat”、“data.txt”)

数据类型:字符|字符串|细胞

net程序集名称,指定为一个特征向量或字符串标量。指定“AssemblyName”作为一个命名空间,这是一个period-separated列表,等companyname.groupname.component。生成的库的名称设置为最后一个period-separated列表的条目。名称必须以字母开头,只包含字母字符和时间。

例子:“AssemblyName”、“mathworks.dotnet.mymagic”

数据类型:字符|字符串

组装版本,指定为一个特征向量或字符串标量。在版本控制使用的信息MATLAB编译器SDK™,请参阅版本控制。

例子:“AssemblyVersion”、“4.0”

数据类型:字符|字符串

国旗自动包括数据文件,指定为“上”或“关闭”或数字或逻辑1(真正的)或0(假)。的值“上”相当于真正的,“关闭”相当于假。因此,您可以使用这个属性的值作为一个逻辑值。存储的值是作为一个开/关逻辑值的类型matlab.lang.OnOffSwitchState。

  • 如果你设定这个属性“上”,然后数据文件提供某些功能(如作为输入负载和打开外部文件)会自动包含在. net程序集。

  • 如果你设定这个属性“关闭”,那么你必须将数据文件添加到装配使用AdditionalFiles选择。

例子:“AutoDetectDataFiles”,“关闭”

数据类型:逻辑

. net类的名称,指定为一个特征向量或字符串标量。你不能指定这个选项如果你使用ClassMap输入。类名。net类名称必须符合要求。

默认值是第一个文件中列出的名称文件参数附加与类。

例子:“名称”、“magicsquareClass”

数据类型:字符|字符串

指定为旗帜,使调试符号“上”或“关闭”或数字或逻辑1(真正的)或0(假)。的值“上”相当于真正的,“关闭”相当于假。因此,您可以使用这个属性的值作为一个逻辑值。存储的值是作为一个开/关逻辑值的类型matlab.lang.OnOffSwitchState。

  • 如果你设定这个属性“上”,然后编译后的程序集包含调试符号。

  • 如果你设定这个属性“关闭”,然后编译好的程序集不包含调试符号。

例子:“DebugBuild”,“上”

数据类型:逻辑

国旗中嵌入可部署归档文件,指定为“上”或“关闭”或数字或逻辑1(真正的)或0(假)。的值“上”相当于真正的,“关闭”相当于假。因此,您可以使用这个属性的值作为一个逻辑值。存储的值是作为一个开/关逻辑值的类型matlab.lang.OnOffSwitchState。

  • 如果你设定这个属性“上”,那么函数嵌入在. net程序集部署归档文件。

  • 如果你设定这个属性“关闭”,那么函数生成可部署归档文件作为一个单独的文件中。

例子:“EmbedArchive”,“关闭”

数据类型:逻辑

国旗来控制远程类型的组装,指定为“上”或“关闭”或数字或逻辑1(真正的)或0(假)。的值“上”相当于真正的,“关闭”相当于假。因此,您可以使用这个属性的值作为一个逻辑值。存储的值是作为一个开/关逻辑值的类型matlab.lang.OnOffSwitchState。

  • 如果你设定这个属性“上”,那么函数建立一个远程会议。

  • 如果你设定这个属性“关闭”,那么函数建立一个组装这不是远程。

例子:“EnableRemoting”,“上”

数据类型:逻辑

版本的微软®编译使用。net框架组装。

例子:“AssemblyVersion”、“5.0”

数据类型:字符|字符串

Data API用于处理. net应用程序之间的数据交换和部署MATLAB代码。

  • mwarray——MWArray API。这个API使用。net框架。这是默认的界面在Windows。

  • matlab-data——MATLAB数据为。net API。这个API需要。net 5.0或更高版本。这是默认的界面上macOS。

MathWorks®建议使用MATLAB为. net Data API。

例子:“接口”、“matlab-data”

数据类型:字符|字符串

国旗使部署归档文件,指定为“上”或“关闭”或数字或逻辑1(真正的)或0(假)。的值“上”相当于真正的,“关闭”相当于假。因此,您可以使用这个属性的值作为一个逻辑值。存储的值是作为一个开/关逻辑值的类型matlab.lang.OnOffSwitchState。

  • 如果你设定这个属性“上”,然后文件夹结构和部署归档文件的文件名从最终用户混淆,和用户代码和数据包含在MATLAB文件放置到一个用户包内的档案。此外,所有。m包装之前文件转换为档案。相当于使用这个选项世纪挑战集团与- j和- s指定。

  • 如果你设定这个属性“关闭”,然后部署归档文件不是混淆。这是默认的行为。

例子:“ObfuscateArchive”,“上”

数据类型:逻辑

路径构建文件保存到输出目录,指定为一个特征向量或字符串标量。可以相对于当前工作目录的路径或绝对的。

建立文件夹的默认名称是组装的名字附加dotNETAssembly。

例子:“OutputDir”、“D: \ \ MATLAB文件\ \ mymagicdotNETAssembly工作'

数据类型:字符|字符串

MATLAB示例文件用于生成样本。net驱动文件函数包含在组装,指定为一个特征向量,一个字符串标量,字符串数组或单元阵列的特征向量。路径可以是相对于当前工作目录或绝对的。文件必须有一个。m扩展。和限制的更多信息,参见示例驱动文件创建。

例子:“SampleGenerationFiles”, (“sample1.m”、“sample2.m”)

数据类型:字符|字符串|细胞

道路使用的加密密钥文件签署分享大会,指定为一个特征向量或字符串标量。如果该值为空,该函数创建一个私人组装。文件路径可以相对于当前工作目录或绝对的。

例子:“StrongNameKeyFile”、“sgKey.snk”

数据类型:字符|字符串

金宝app支持包包含指定为以下选项之一:

  • “自动检测”(默认)——依赖分析过程自动检测,包括所需的支持包。金宝app

  • “没有”——不包括金宝app支持包。使用这个选项会导致运行时错误。

  • 一个字符串标量、特征向量或单元阵列特征向量的——仅包含了指定的支持包。金宝app列出支持包安装或使用的特定文件,看看金宝appcompiler.codetools.deployable金宝appSupportPackages。

例子:S金宝appupportPackages,{“深度学习工具箱为TensorFlow模型转换器”,“深度学习工具箱Places365-GoogLeNet网络模型”}

数据类型:字符|字符串|细胞

国旗来控制构建冗长,指定为“上”或“关闭”或数字或逻辑1(真正的)或0(假)。的值“上”相当于真正的,“关闭”相当于假。因此,您可以使用这个属性的值作为一个逻辑值。存储的值是作为一个开/关逻辑值的类型matlab.lang.OnOffSwitchState。

  • 如果你设定这个属性“上”,然后用MATLAB命令窗口显示进度信息指示编译器输出在构建过程中。

  • 如果你设定这个属性“关闭”,那么命令窗口不显示进度信息。

例子:“详细”,“上”

数据类型:逻辑

输出参数

全部折叠

构建结果,作为一个返回compiler.build.Results对象。的结果对象包括:

  • 构建类型,它是“dotNETAssembly”

  • 编制文件路径如下:

    • AssemblyName. dll

    • AssemblyNameNative.dll

    • AssemblyName_overview.dll

    • GettingStarted.html

  • 包括支持包的列表金宝app

  • 构建选项,指定为一个DotNETAssemblyOptions对象

限制

  • 在R2023a:除了窗户,这个函数支持Linux金宝app®和macOS操作系统。

版本历史

介绍了R2021a

另请参阅