使用 MSVC 工具链在 64 位 Windows 平台上编译 32 位 DLL
注意：如果只需要在安装了 Microsoft® Visual Studio® 的 Windows® 上生成 32 位 DLL，请使用 CMake 工具链，如 Microsoft Visual Studio Project 2017 | CMake (32-bit Windows)。本页说明如何创建自定义工具链来更改编译器选项和集成新编译器。有关使用 CMake 编译所生成代码的详细信息，请参阅配置 CMake 编译过程。
注册并使用运行在 64 位 Windows 平台上的 Microsoft Visual C/C++(MSVC) 工具链，编译 32 位动态链接库 (DLL)。此示例使用 Microsoft 编译器。然而，概念和编程接口适用于其他工具链。一旦注册工具链，就可以从工具链列表中选择它，代码生成器会生成联编文件来使用该工具链编译代码。工具链由几个工具组成，如编译器、链接器和具有多个不同配置选项的存档器。工具链在指定的平台上编译、链接和运行代码。要访问此示例使用的文件，请点击打开脚本。
检查平台并确定 MSVC 版本
以下代码检查平台是否受支持，以及您是否有支持的 Microsoft Visual C/C++ 版本。my_msvc_32bit_tc.m 工具链定义可以使用 Microsoft Visual Studio 版本 9.0、10.0、11.0、12.0、14.0 或 15.0。
如果您没有使用 Windows® 平台，或如果您没有支持的 Microsoft Visual C/C++ 版本，该示例仅生成代码和联编文件，而不运行生成的联编文件。
VersionNumbers = {'14.0'}; % Placeholder value
if ~ispc
supportedCompilerInstalled = false;
else
installed_compilers = mex.getCompilerConfigurations('C', 'Installed');
MSVC_InstalledVersions = regexp({installed_compilers.Name}, 'Microsoft Visual C\+\+ 20\d\d');
MSVC_InstalledVersions = cellfun(@(a)~isempty(a), MSVC_InstalledVersions);
if ~any(MSVC_InstalledVersions)
supportedCompilerInstalled = false;
else
VersionNumbers = {installed_compilers(MSVC_InstalledVersions).Version}';
supportedCompilerInstalled = true;
end
end
动态链接库的函数
动态链接库的示例函数 myMatlabFunction.m 将数字乘以 2。
function y = myMatlabFunction(u) % myMatlabFunction: Returns twice its input. % Copyright 2017 The MathWorks, Inc. %#codegen assert(isa(u, 'double'), 'The input must be a "double".'); assert(all([1, 1] == size( u )), 'The input must be a scalar.'); y = double(u + u);
创建和配置 MSVC 工具链
my_msvc_32bit_tc.m 工具链定义函数接受包含 Visual Studio 版本号的参量。在此示例中，创建和配置该工具链的命令是：
tc = my_msvc_32bit_tc(VersionNumbers{end});
save my_msvc_32bit_tc tc;
Executing "C:\Users\user\OneDrive - MathWorks\Documents\MATLAB\ExampleManager\user.Bdoc\coder-ex19875030\my_msvc_32bit_tc"... Executed "C:\Users\user\OneDrive - MathWorks\Documents\MATLAB\ExampleManager\user.Bdoc\coder-ex19875030\my_msvc_32bit_tc".
注册工具链
在代码生成器可以将工具链用于编译过程之前，RTW.TargetRegistry 必须包含工具链注册。此注册可以来自 MATLAB® 路径中的任何 rtwTargetInfo.m 文件。如果重置 RTW.TargetRegistry，MATLAB 将加载新注册。
从对应的文本文件 myRtwTargetInfo.txt 创建 rtwTargetInfo.m 文件。
function myRtwTargetInfo(tr)
%RTWTARGETINFO Registration file for custom toolchains.
% Copyright 2012-2017 The MathWorks, Inc.
tr.registerTargetInfo(@createToolchainRegistryFor32BitMSVCToolchain);
end
% -------------------------------------------------------------------------
% Create the ToolchainInfoRegistry entries
% -------------------------------------------------------------------------
function config = createToolchainRegistryFor32BitMSVCToolchain
config(1) = coder.make.ToolchainInfoRegistry;
config(1).Name = 'Microsoft 32 Bit Toolchain | nmake makefile (64-bit Windows)';
config(1).FileName = fullfile(fileparts(mfilename('fullpath')), 'my_msvc_32bit_tc.mat');
config(1).TargetHWDeviceType = {'Intel->x86-32 (Windows32)','AMD->x86-32 (Windows32)','Generic->Unspecified (assume 32-bit Generic)'};
config(1).Platform = {'win64'};
end
copyfile myRtwTargetInfo.txt rtwTargetInfo.m RTW.TargetRegistry.getInstance('reset');
创建代码生成配置对象
要生成 32 位动态链接库 (DLL)，请创建一个 'dll' 代码生成配置对象。指定 'dll' 会指示链接器（工具链中的一个编译工具）使用“共享库”链接器命令。
cfg = coder.config('dll');
为 32 位硬件配置代码生成
要成功生成与 32 位硬件兼容的代码，生成的代码必须使用正确的底层 C 类型（例如，int、signed char 等）。这些类型是大小类型的 typedef 语句的基础（例如，uint8、int16 等）。使用以下命令设置配置：
cfg.HardwareImplementation.ProdHWDeviceType = ... 'Generic->Unspecified (assume 32-bit Generic)';
将代码生成配置为使用 32 位工具链
设置 Toolchain 属性的名称，以匹配您在 rtwTargetInfo.m 文件中指定的 Name。
cfg.Toolchain = ... 'Microsoft 32 Bit Toolchain | nmake makefile (64-bit Windows)';
选择详尽状态报告
要确认工具链用于构建 DLL 的编译器标志，请选择详尽状态报告。
cfg.Verbose = true;
确定是否仅生成代码
当没有安装 Microsoft 编译器时，代码生成器只生成代码和联编文件。安装支持的编译器后，代码生成器会构建 32 位二进制文件。
if supportedCompilerInstalled cfg.GenCodeOnly = false; else cfg.GenCodeOnly = true; end
生成代码并编译 DLL
要使用工具链生成代码并编译 DLL（如果已启用编译），请在命令提示符下输入：
codegen -config cfg myMatlabFunction -args { double(1.0) };
### Compiling function(s) myMatlabFunction ... ------------------------------------------------------------------------ Compilation suppressed: generating code only. ------------------------------------------------------------------------ Code generation successful.
编译并运行可执行文件
如果您安装支持的编译器版本，您可以通过使用 C 主函数来构建 32 位可执行文件。您可以使用可执行文件来测试生成的代码是否按预期工作。
cfge = coder.config('exe'); cfge.CustomInclude = {pwd}; cfge.CustomSource = 'myMatlabFunction_main.c'; cfge.GenCodeOnly = cfg.GenCodeOnly; cfge.Verbose = true; cfge.Toolchain = ... 'Microsoft 32 Bit Toolchain | nmake makefile (64-bit Windows)'; codegen -config cfge myMatlabFunction -args { double(1.0) }; if supportedCompilerInstalled pause(5); %wait for EXE to get generated system('myMatlabFunction 3.1416'); % Expected output: myMatlabFunction(3.1416) = 6.2832 end
### Compiling function(s) myMatlabFunction ... ------------------------------------------------------------------------ Compilation suppressed: generating code only. ------------------------------------------------------------------------ Code generation successful.
可选步骤：注销工具链
要注销工具链，请输入：
delete ./rtwTargetInfo.m RTW.TargetRegistry.getInstance('reset');
