主要内容

compiler.build.CSharedLibraryOptions

选项用于构建C共享库

自从R2021a

描述

例子

选择= compiler.build.CSharedLibraryOptions (FunctionFiles)创建一个默认使用MATLAB C共享库的选择对象®文件FunctionFiles。使用CSharedLibraryOptions对象作为输入compiler.build.cSharedLibrary函数。

例子

选择= compiler.build.CSharedLibraryOptions (FunctionFiles,名称,值)创建一个CSharedLibraryOptions对象使用一个或多个指定的选项名称参数。选项包括库名称,输出目录,包括额外的文件。

例子

全部折叠

创建一个CSharedLibraryOptions使用文件输入对象。

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

appFile = fullfile (matlabroot,“外来的”,“例子”,编译器的,“magicsquare.m”);选择= compiler.build.CSharedLibraryOptions (appFile)
选择= CSharedLibraryOptions属性:EmbedArchive: FunctionFiles: {“C: \ Program Files \ MATLAB \R2023a\走读生\ \编译器\ magicsquare例子。m '} DebugBuild:从LibraryName: magicsquare‘LibraryVersion: 1.0.0.0”AdditionalFiles: {} s + AutoDetectDataFiles: ons + ObfuscateArchive:杀死+ Support金宝appPackages:{“自动检测”}详细:从OutputDir:“\ magicsquarecSharedLibrary '。

您可以修改现有的属性值CSharedLibraryOptions对象使用点符号。例如,启用详细输出。

选择。Verbose =“上”
选择= CSharedLibraryOptions属性:EmbedArchive: FunctionFiles: {“C: \ Program Files \ MATLAB \R2023a\走读生\ \编译器\ magicsquare例子。m '} DebugBuild:从LibraryName: magicsquare‘LibraryVersion: 1.0.0.0”AdditionalFiles: {} s + AutoDetectDataFiles: ons + ObfuscateArchive:杀死+ Support金宝appPackages:{“自动检测”}详细:OutputDir:“\ magicsquarecSharedLibrary '。

使用CSharedLibraryOptions对象作为输入compiler.build.cSharedLibraryC函数来构建一个共享库。

buildResults = compiler.build.cSharedLibrary(选择);

创建一个CSharedLibraryOptions对象,并使用名称-值参数定制它。

对于这个示例,使用该文件magicsquare.m位于matlabroot\走读生\ \编译器例子。使用名称-值参数来指定输出目录和禁用自动检测的数据文件。

appFile = fullfile (matlabroot,“外来的”,“例子”,编译器的,“magicsquare.m”);选择= compiler.build.CSharedLibraryOptions (appFile,“OutputDir”,' D: \ \ MATLAB文件\ \工作MagicSquareLib”,“AutoDetectDataFiles”,“关闭”)
选择= CSharedLibraryOptions属性:EmbedArchive: FunctionFiles: {“C: \ Program Files \ MATLAB \R2023a\走读生\ \编译器\ magicsquare例子。m '} DebugBuild:从LibraryName: magicsquare‘LibraryVersion: 1.0.0.0”AdditionalFiles: {} AutoDetectDataFiles: SupportPack金宝appages:{“自动检测”}详细:从OutputDir:“D: \ \ MATLAB文件\ \ MagicSquareLib工作”

您可以修改现有的属性值CSharedLibraryOptions对象使用点符号。例如,启用详细输出。

选择。Verbose =“上”
选择= CSharedLibraryOptions属性:EmbedArchive: FunctionFiles: {“C: \ Program Files \ MATLAB \R2023a\走读生\ \编译器\ magicsquare例子。m '} DebugBuild:从LibraryName: magicsquare‘LibraryVersion: 1.0.0.0”AdditionalFiles: {} AutoDetectDataFiles: SupportPack金宝appages:{“自动检测”}详细:OutputDir:“D: \ \ MATLAB文件\ \ MagicSquareLib工作”

使用CSharedLibraryOptions对象作为输入compiler.build.cSharedLibraryC函数来构建一个共享库。

buildResults = compiler.build.cSharedLibrary(选择);

输入参数

全部折叠

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

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

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

名称-值参数

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

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

例子:“详细”,“上”

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

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

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

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

  • 如果你设定这个属性“上”,然后数据文件提供某些功能(如作为输入负载打开外部文件)自动包括在共享库。

  • 如果你设定这个属性“关闭”,那么您必须添加数据文件共享库使用AdditionalFiles选择。

例子:“AutoDetectDataFiles”,“关闭”

数据类型:逻辑

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

  • 如果你设定这个属性“上”,那么编译库包含调试符号。

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

例子:“DebugBuild”,“上”

数据类型:逻辑

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

  • 如果你设定这个属性“上”,那么函数嵌入可部署归档文件的共享库。

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

例子:“EmbedArchive”,“关闭”

数据类型:逻辑

C的共享库的名称,指定为一个特征向量或字符串标量。默认名称生成的库的第一个元素FunctionFiles论点。

例子:“LibraryName”、“mymagic”

数据类型:字符|字符串

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

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

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

例子:“ObfuscateArchive”,“上”

数据类型:逻辑

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

建立文件夹的默认名称库名称附加cSharedLibrary

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

数据类型:字符|字符串

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

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

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

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

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

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

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

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

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

例子:“详细”,“上”

数据类型:逻辑

输出参数

全部折叠

C库构建选项,作为一个返回CSharedLibraryOptions对象。

版本历史

介绍了R2021a