使用示例主函数合并生成的代码

当您编译使用生成的 C/C++ 代码的应用程序时，必须提供调用生成的代码的 C/C++ 主函数。

默认情况下，对于 C/C++ 源代码、静态库、动态库和可执行文件的代码生成，MATLAB^® Coder™ 会生成示例 C/C++ 主函数。此函数是可以帮助您将生成的 C/C++ 代码合并到应用程序中的模板。示例主函数声明和初始化数据，包括动态分配的数据。它会调用入口函数，但不使用入口函数返回的值。

MATLAB Coder 在编译文件夹的 examples 子文件夹中生成示例主函数的源文件和头文件。对于 C 代码生成，它会生成 main.c 和 main.h 文件。对于 C++ 代码生成，它会生成 main.cpp 和 main.h 文件。

不要修改 examples 子文件夹中的 main.c 和 main.h 文件。如果修改这些文件，则当您重新生成代码时，MATLAB Coder 不会重新生成示例主文件。它会发出警告，提示检测到生成文件发生了更改。在使用示例主函数之前，将示例主函数源文件和头文件复制到编译文件夹以外的某个位置。修改新位置的文件以满足您的应用程序的要求。

当您使用默认配置设置生成文件时，MATLAB Coder 的 packNGo 函数和打包选项不会打包示例主函数源文件和头文件。要打包示例主文件，请配置代码生成以生成和编译示例主函数，生成代码，然后打包编译文件。

使用示例主函数的工作流

准备您的 MATLAB 代码以进行代码生成。
检查是否存在运行时问题。
确保启用了生成示例主函数的功能。
生成入口函数的 C/C++ 代码。
将示例主文件从 examples 子文件夹复制到另一个文件夹。
修改新文件夹中的示例主文件以满足应用程序的要求。
针对所需的平台部署示例主函数和生成的代码。
编译应用程序。

有关如何生成示例主函数并使用它编译可执行文件的示例，请参阅在应用程序中使用示例 C 主函数。

使用 MATLAB Coder 控制示例主函数生成

在生成代码页上，要打开生成对话框，请点击生成箭头。
在生成对话框中，将编译类型设置为以下项之一：
- 源代码
- 静态库
- 动态库
- 可执行文件
点击更多设置。

在所有设置选项卡的高级下，将生成示例主函数设置为以下项之一：

设置为	目的
不生成示例主函数	不生成示例 C/C++ 主函数
生成但不编译示例主函数（默认值）	生成示例 C/C++ 主函数但不进行编译
生成并编译示例主函数	生成示例 C/C++ 主函数并进行编译

使用命令行界面控制示例主函数生成

为 'lib'、'dll' 或 'exe' 创建代码配置对象。例如：
```
cfg = coder.config('lib'); % or dll or exe
```

设置 GenerateExampleMain 属性。

设置为	目的
`'DoNotGenerate'`	不生成示例 C/C++ 主函数
`'GenerateCodeOnly'`（默认值）	生成示例 C/C++ 主函数但不进行编译
`'GenerateCodeAndCompile'`	生成示例 C/C++ 主函数并进行编译

例如：

cfg.GenerateExampleMain = 'GenerateCodeOnly';