使用 Web App 编译器打包 MATLAB App

支持的平台：Windows^®、Linux^®、Mac

此示例展示了如何使用 Web App 编译器将 MATLAB^® App 打包到 Web App 中。

在 R2025a 之前的版本中: 如创建 Web App (R2024b) 中所示，使用 Web App 编译器的旧版本创建一个 Web App。

使用 App 设计工具创建 MATLAB App

您需要先使用 MATLAB App 设计工具创建 Web App，然后才能打包并部署该 App。有关详细信息，请参阅使用 App 设计工具创建并运行简单 App。

在此示例中，使用 MATLAB App 创建一个显示血压数据的 Web App。要在 App 设计工具中打开该 App，请打开 App 设计工具起始页，然后在 App 部分点击显示示例。然后，选择响应用户选择。

该软件会创建一个名为 BloodPressureAppExample 的文件夹，其中包含示例文件。本示例所需的文件包括 MATLAB 文件、PatientsDisplay.mlapp 文件以及数据文件 patients.mat。

MATLAB app titled Patients Display shows a scatter plot of systolic blood pressure measured against weight for male patients

创建工程和编译任务

使用 Web App 编译器为 Web App 创建编译器任务。编译器任务允许您为特定部署目标编译工程中的文件。

要打开该 App，在 App 选项卡上，展开 App 图库。在应用程序部署部分中，点击 Web App 编译器。

Application Deployment section of the Apps gallery

您还可以在 MATLAB 命令行窗口中使用 webAppCompiler 函数打开该 App。

打开 App 后，“创建编译器任务”对话框会提示您将任务添加到新的或现有 MATLAB 工程中。在此示例中，选择启动新工程并创建编译器任务，并在 BloodPressureAppExample 文件夹中创建一个名为 BloodPressureAppExample 的新工程。有关创建和使用 MATLAB 工程的详细信息，请参阅创建工程。

Create compiler task dialog box with the text 'To deploy your MATLAB code, you need a MATLAB project to organize code and a compiler task to handle deployment.' The option 'Start a new project and create a compiler task' is selected.

编辑器中打开了一个名为 WebAppArchive1 的新编译任务。您可以通过打开编译器任务管理器或转到管理任务选项卡并创建一个新的编译器任务来编译其他部署目标的代码。

指定编译选项

您可以为 Web 应用指定选项以自定义构建过程。例如，您可以混淆处理 MATLAB 代码或修改 App 详细信息。

Exported file section of the compiler task with no file selected and a button labeled Add Exported Function

将 MATLAB App 添加到 Web App。所有文件必须位于工程根文件夹中才能添加到工程中。在此示例中，在编译器任务的主文件部分，点击添加文件，然后选择 PatientsDisplay.mlapp。在“工程”面板中，文件现在带有标签 Design 和 Main Function。

在存档信息部分，将字符串 MyWebAppArchive 替换为您的 Web App 的名称 BloodPressureExample。

打包 Web App

要查看包含有关构建和打包组件的说明的代码，请点击导出编译脚本旁边的箭头，然后选择显示代码。在右侧，一个窗口显示了一个部署脚本，其中包含与您的构建选项相对应的 compiler.build.webAppArchive 和 compiler.build.WebAppArchiveOptions 函数。您可以通过点击导出编译脚本按钮将此代码转换为 MATLAB 脚本文件。运行生成的构建脚本与点击打包按钮等效。

Two buttons labeled Export Build Script and Package

要创建 Web App，请点击打包。

编译器会在工程文件夹中的 <compiler_task_name>/output 文件夹中生成文件。要为生成的文件选择不同的输出位置，请在输出位置部分更新路径。

部署和运行 Web App

导航到打包过程中由 MATLAB Compiler™ 生成的工程文件夹。

将 Web App 存档文件 BloodPressureExample.ctf 复制到由服务器配置的 App 文件夹中。此表格列出了默认文件夹的位置。

操作系统	App 文件夹位置
Windows	`%ProgramData%\MathWorks\webapps\R2025a\apps`
Linux	`/local/MathWorks/webapps/R2025a/apps`
macOS	`/Library/Application Support/MathWorks/webapps/R2025a/apps`

您也可以点击开发版本的 MATLAB Web App Server™ 中的服务器应用程序中的打开 App 文件夹按钮打开 App 文件夹。有关详细信息，请参阅启动服务器应用程序。

或者，如果您使用的是 MATLAB Web App Server 产品，您可以直接将 App 上传到服务器。要上传 App，请导航至 Web App 主页，然后选择管理 Apps > 上传 App。此功能需要激活身份验证和基于角色的访问控制。有关详细信息，请参阅部署 Web App。

您可以在服务器应用程序中点击打开主页获得主页的 URL。主页 URL 的格式为：

http://webAppServer:PortNumber/webapps/home/index.html

在 Web 浏览器中打开 Web App 主页。您会看到一个显示患者显示 Web App 的磁贴。您的 Web App 现已部署完成。

另请参阅

compiler.build.webAppArchive | Web App 编译器

使用 Web App 编译器 打包 MATLAB App