主要内容

配置构建设置

指定构建类型

构建类型

MATLAB®编码器™可以生成以下输出代码类型:

  • 墨西哥人的功能

  • 独立的C / c++代码

  • 独立的C / c++代码和编译到一个静态库

  • 独立的C / c++代码和编译一个动态链接库

  • 独立的C / c++代码和编译到一个可执行的

    请注意

    当你生成一个可执行文件,你必须提供一个C / c++文件包含主要功能,如中描述指定为C / c++主要功能可执行文件。

生成的文件的位置

默认情况下,MATLAB编码器生成文件输出文件夹根据你的输出类型。有关更多信息,请参见生成的文件和位置。

请注意

每一次MATLAB编码器产生同样的输出相同的代码或项目,它将文件从先前的构建。如果你想保存从一个构建文件,将它们复制到另一个位置开始前另一个构建。

指定使用的构建类型MATLAB编码器应用程序

  1. 打开生成对话框,在生成代码页面,点击生成箭头。

  2. 集构建类型下列之一。

    • 源代码

    • 墨西哥人

    • 静态库

    • 动态库

    • 可执行的

如果您选择源代码,MATLAB编码器不调用make命令或生成汇编对象代码。当你修改MATLAB代码之间的迭代生成C / c++代码和你想检查生成的代码,这个选项可以节省你的时间。相当于这个选项静态库与只生成代码框选中。

代码生成为墨西哥人使用一组不同的配置参数函数比使用其他类型的构建。当你切换之间的输出类型墨西哥人的功能和源,静态库,动态库,或可执行的,验证这些设置。

某些配置参数相关的墨西哥人和独立的代码生成。如果你让这些参数输出类型时墨西哥人的功能,你想使用相同的设置为C / c++代码生成,您必须重新启用它C / c++静态库,C / c++动态库,C / c++可执行文件。

在命令行中指定构建类型

调用codegen与配置选择。例如,假设你有一个主要功能喷火不需要输入参数。下面的表显示了如何编译时指定不同的输出类型喷火。如果一个主函数输入参数,您必须指定这些输入。有关更多信息,请参见指定入口点函数输入的属性。

请注意

C代码生成的默认语言MATLAB编码器。生成c++代码,看看为代码生成指定一种语言。

生成: 使用这个命令:
墨西哥人函数使用默认代码生成选项 

codegen foo
墨西哥人函数指定代码生成选项 

cfg = coder.config(墨西哥人);%设置配置参数,例如,% cfg.GenerateReport = true启用代码生成报告;% % codegen打电话,通过配置对象codegen配置cfg foo
独立的C / c++代码和编译到一个库使用默认代码生成选项 
codegen配置:自由foo
独立的C / c++代码和编译库指定代码生成选项 

cfg = coder.config(“自由”);%设置配置参数,例如,% cfg.GenerateReport = true启用代码生成报告;% % codegen打电话,通过配置对象codegen配置cfg foo
独立的C / c++代码和编译它使用默认代码生成一个可执行的选项和指定c文件在命令行 

codegen配置:主要exe。c foo

请注意

您必须指定一个主要函数用于生成一个C / c++可执行文件。看到指定为C / c++主要功能可执行文件
独立的C / c++代码和可执行指定代码生成选项编译它 

cfg = coder.config (exe);%设置配置参数,例如,指定主文件cfg。CustomSource = ' c ';cfg。CustomInclude = 'c:\myfiles'; codegen -config cfg foo

请注意

您必须指定一个主要函数用于生成一个C / c++可执行文件。看到指定为C / c++主要功能可执行文件

为代码生成指定一种语言

MATLAB编码器可以生成C或c++库和可执行文件。C是默认的语言。您可以显式地指定一种语言从“项目设置”对话框中或在命令行。

指定使用的语言MATLAB编码器应用程序

  1. 打开生成对话框,在生成代码页面,点击生成箭头。

  2. 集语言来C或c++。

    请注意

    如果您指定c++,MATLAB编码器包装了C代码. cpp文件。您可以使用一个c++编译器和接口与外部c++应用程序。MATLAB编码器不产生c++类。

使用命令行界面指定的语言

  1. 选择一个适合你的目标语言的编译器。

  2. 创建一个配置对象的代码生成。例如,对于一个库:

    cfg = coder.config(“自由”);

  3. 设置TargetLang财产“C”或“c++”。例如:

    cfg。TargetLang =“c++”;

    请注意

    如果您指定c++,MATLAB编码器包装了C代码. cpp文件。然后您可以使用一个c++编译器和接口与外部c++应用程序。MATLAB编码器不产生c++类。

另请参阅

指定输出文件名称

使用指定输出文件的名称MATLAB编码器应用程序

  1. 打开生成对话框,在生成代码页面,点击生成箭头。

  2. 在输出文件的名字字段中,输入文件名。

请注意

不要把空格的文件名。

默认情况下,如果第一个入口点MATLAB文件的名称fcn1输出文件的名字是:

  • fcn1对于C / c++库和可执行文件。

  • fcn1_mex墨西哥人功能。

默认情况下,MATLAB编码器生成文件的文件夹project_folder/ codegen /目标/ fcn1:

  • project_folder你目前的项目文件夹吗

  • 目标是:

    • 墨西哥人对墨西哥人的功能

    • 自由对于静态C / c++库

    • dll动态C / c++库

    • exeC / c++的可执行文件

选择命令行

使用codegen函数- o选择。

指定输出文件的位置

指定输出文件的位置使用MATLAB编码器应用程序

输出文件的位置必须不包含:

  • 空间(空间会导致代码生成失败在某些操作系统配置)。

  • 选项卡

  • \,美元,#,*,吗?

  • Non-7-bit ASCII字符,如日本的角色。

  1. 打开生成对话框,在生成代码页面,点击生成箭头。

  2. 集构建类型来源代码,静态库,动态库,或可执行的(取决于您的需求)。

  3. 点击更多的设置。

  4. 单击路径选项卡。

    的默认设置建立文件夹字段是项目文件夹的子文件夹。默认情况下,MATLAB编码器生成文件的文件夹project_folder/ codegen /目标/ fcn1:

    • fcn1是按字母顺序第一入口点文件的名称。

    • 目标是:

      • 墨西哥人对墨西哥人的功能

      • 自由对于静态C / c++库

      • dll对于动态链接C / c++库

      • exeC / c++的可执行文件

  5. 改变输出位置,您可以:

    • 集建立文件夹来当前MATLAB工作文件夹的子文件夹

      MATLAB编码器生成文件MATLAB_working_folder/ codegen /目标/ fcn1文件夹

    • 集建立文件夹来指定的文件夹。在建立文件夹名称领域,提供文件夹的路径。

选择命令行

使用codegen函数- d选择。

参数规范方法

如果您使用的是 使用 细节
的MATLAB编码器应用程序 “项目设置”对话框中。 MATLAB编码器应用指定构建配置参数
codegen在命令行,想指定一些参数 配置对象 在命令行指定构建配置参数使用配置对象
codegen在构建脚本
codegen在命令行,希望指定许多参数 配置对象对话框 在命令行指定构建配置参数使用对话框

指定构建配置参数

您可以指定从构建配置参数MATLAB编码器项目设置”对话框中,命令行或配置对象对话框。

指定构建配置参数MATLAB编码器应用程序

  1. 打开生成对话框,在生成代码页面,点击生成箭头。

  2. 集构建类型来源代码,静态库,动态库,或可执行的(取决于您的需求)。

  3. 点击更多的设置。

    “项目设置”对话框中提供的配置参数适用于您选择的输出类型。代码生成为墨西哥人使用一组不同的配置参数函数比使用其他类型的构建。当你切换之间的输出类型墨西哥人的功能和源代码,静态库,动态库,或可执行的,验证这些设置。

    某些配置参数相关的墨西哥人和独立的代码生成。如果你让这些参数输出类型时墨西哥人的功能,你想使用相同的设置为C / c++代码生成,您必须重新启用它C / c++静态库,C / c++动态库,C / c++可执行文件。

  4. 根据需要修改参数。关于参数的更多信息选项卡中,单击帮助。

    修改参数设置立即生效。

在命令行指定构建配置参数使用配置对象

类型的配置对象。的codegen函数使用配置对象为代码生成定制您的环境。下表列出了可用的配置对象。

配置对象 描述

coder.CodeConfig

如果没有嵌入式编码器®许可证是可用的或您禁用使用嵌入式编码人员许可,指定参数C / c++库或可执行的一代。

coder.EmbeddedCodeConfig

如果嵌入式编码器许可证可用,指定参数C / c++库或可执行的一代。

coder.HardwareImplementation

指定目标硬件实现的参数。如果不指定,codegen生成的代码与MATLAB主机兼容。

coder.MexCodeConfig

墨西哥人指定参数代码生成。

使用配置对象。使用代码生成的配置对象来定制您的环境:

  1. 在MATLAB工作区,配置对象变量,定义为中描述创建配置对象。

    例如,生成一个配置对象的C生成静态库:

    cfg = coder.config(“自由”);%返回一个编码器。CodeConfig object if no % Embedded Coder license available. % Otherwise, returns a coder.EmbeddedCodeConfig object.

  2. 根据需要修改的参数配置对象,使用这些方法之一:

  3. 调用codegen函数与配置选择。指定配置对象作为它的参数。

    的配置选项指示codegen生成目标代码,根据配置属性值。在接下来的例子中,codegen从MATLAB生成C静态库函数,喷火基于代码生成配置对象的参数,cfg第一步中定义:

    codegen配置cfg foo

    的配置选项指定您想要构建的输出类型——在这种情况下,一个C静态库。有关更多信息,请参见codegen。

创建配置对象。您可以定义一个配置对象在MATLAB工作区。

创建… 使用一个命令,比如……
墨西哥人配置对象

coder.MexCodeConfig		 
cfg = coder.config(墨西哥人);
代码生成配置对象生成一个独立的C / c++库或可执行文件

coder.CodeConfig		 
%来生成一个静态库cfg = coder.config(“自由”);%来生成一个动态库cfg = coder.config (dll) %来生成一个可执行的cfg = coder.config (exe);

请注意

如果嵌入式编码器许可证可用,创建一个coder.EmbeddedCodeConfig对象。

如果你使用并发许可,禁用嵌入式编码人员许可的检查,使用以下命令之一:

cfg =编码器。配置(‘自由’,‘是’,假)

cfg =编码器。配置(dll,‘是’,假)

cfg =编码器。配置(“exe”、“是”,假)
代码生成配置对象生成一个独立的C / c++库或嵌入式目标的可执行文件

coder.EmbeddedCodeConfig		 
%来生成一个静态库cfg = coder.config(“自由”);%来生成一个动态库cfg = coder.config (dll) %来生成一个可执行的cfg = coder.config (exe);

请注意

需要嵌入式编码器许可证;否则创建一个coder.CodeConfig对象。
硬件实现配置对象

coder.HardwareImplementation		 hwcfg = coder.HardwareImplementation

每个配置对象都有一组参数,初始化为默认值。您可以更改这些设置,如中描述修改配置对象在命令行中使用点符号。

修改配置对象在命令行中使用点符号。可以使用点符号修改一个配置对象参数的值。使用这种语法:

configuration_object。财产=价值

点符号使用赋值语句来修改配置对象属性:

  • 指定一个主要函数在C / c++代码生成:

    cfg = coder.config (exe);cfg。CustomInclude = 'c:\myfiles'; cfg.CustomSource = 'main.c'; codegen -config cfg foo

  • 自动生成和启动代码生成报告后生成C / c++静态库:

    cfg = coder.config(“自由”);cfg。GenerateReport = true;cfg。LaunchReport = true;codegen配置cfg foo

保存配置对象。配置对象不MATLAB之间自动保存会话。使用下列方法之一来保存你的设置:

保存配置对象MAT-file然后加载MAT-file在你的下一个会话

写一个脚本,该脚本创建的配置对象,并设置它的属性。

在命令行指定构建配置参数使用对话框

您已经创建了一个配置对象后,您可以修改对象的属性通过使用配置参数对话框。看到在命令行指定配置参数工作流交互。