无法签出 Report Generator 许可证，如何解决？(标签-MATLAB)

Question

使用MATLAB生成报告没有问题，但是打包之后就无法使用，存在下面问题怎么解决？

无法签出 Report Generator 许可证。原因: 报告生成程序不可编译。有关详细信息，请参阅 makeDOMCompilable 函数。

Answer 1

中午好🌞🌞🌞
本答案参考通义千问

在使用 MATLAB 生成报告时，如果遇到以下错误：

无法签出 Report Generator 许可证。原因: 报告生成程序不可编译。
有关详细信息，请参阅 makeDOMCompilable 函数。

这通常是因为你尝试将 Report Generator 功能打包为独立应用程序（如使用 matlab.compiler 或 deploytool）时，MATLAB 无法正确识别或编译与 Report Generator 相关的组件。

以下是解决该问题的详细步骤和解决方案：

---

一、问题分析

• Report Generator 是 MATLAB 的一个附加产品，用于生成 HTML、PDF 等格式的报告。
• 当你将包含 Report Generator 的代码打包成独立应用程序时，MATLAB 默认不会自动包含这些组件。
• 因此，无法签出许可证的问题实际上是一个“编译失败”问题，因为 MATLAB 无法找到必要的库或资源。

---

二、解决方案

1. 确保安装了 Report Generator

检查是否已安装 Report Generator：

ver('reportgenerator')

如果没有输出或显示版本号，表示未安装。请通过 MATLAB Add-Ons 安装 Report Generator。

---

2. 使用 makeDOMCompilable 函数

MATLAB 提供了一个函数 makeDOMCompilable 来确保你的报告对象可以被编译为独立应用程序。

调用方式如下：

% 创建一个报告对象
report = mlreportgen.report.Report('myReport', 'html');

% 添加内容到报告
append(report, mlreportgen.report.Section('Introduction'));

% 将报告对象转换为可编译形式
makeDOMCompilable(report);

注意： 这一步非常重要，它会确保报告对象在打包时被正确识别和处理。

---

3. 在打包时添加 Report Generator 依赖项

如果你使用的是 matlab.compiler 打包工具（如 mcc 或 deploytool），你需要手动添加 Report Generator 的依赖项。

示例命令（使用 mcc）：

mcc -R -nodisplay -mv reportgenerator -W 'application,MyApp.exe,main' -T link:exe main.m

其中 -mv reportgenerator 表示将 Report Generator 模块打包进去。

---

4. 使用 deploytool 打包时添加依赖项

如果你使用图形界面工具 deploytool，请按以下步骤操作：

1. 打开 deploytool。
2. 选择你的项目。
3. 在 Dependencies 部分：
   • 添加 reportgenerator 模块。
   • 确保所有相关的工具箱（如 MATLAB Report Generator）都被选中。
4. 重新构建并打包应用。

---

5. 确保运行环境支持 Report Generator

如果你将应用部署到其他机器上，必须确保目标机器也安装了 Report Generator 和相关工具箱。

---

三、完整代码示例（推荐）

% 创建报告对象
report = mlreportgen.report.Report('MyReport', 'html');

% 添加章节
section = mlreportgen.report.Section('Introduction');
append(report, section);

% 添加内容
content = mlreportgen.dom.Paragraph('This is a sample report.');
append(section, content);

% 将报告对象转为可编译形式
makeDOMCompilable(report);

% 生成报告
write(report);
close(report);

---

四、常见错误排查

| 错误提示 | 原因 | 解决方法 | |----------|------|----------| | 无法签出 Report Generator 许可证 | 未安装或未正确打包 Report Generator | 安装 Report Generator 并使用 makeDOMCompilable | | 报告生成程序不可编译 | 缺少依赖项 | 使用 mcc 或 deploytool 包含 Report Generator 模块 | | 找不到 ReportGenerator | 目标机器未安装 | 确保目标机器也安装了 Report Generator |

---

五、总结

要解决“无法签出 Report Generator 许可证”的问题，请按照以下顺序操作：

1. 确认已安装 Report Generator
2. 使用 makeDOMCompilable 转换报告对象
3. 在打包时包含 Report Generator 依赖项
4. 确保目标环境也安装了 Report Generator

通过以上步骤，你应该能够成功打包并运行包含 Report Generator 的 MATLAB 应用程序。

如有需要，我也可以提供完整的打包脚本或配置文件模板。