告别MATLAB依赖！手把手教你用App Designer打包独立桌面软件（含Runtime组件）

告别MATLAB依赖！手把手教你用App Designer打包独立桌面软件（含Runtime组件）

在科研和工程领域，MATLAB凭借其强大的计算能力和丰富的工具箱，一直是算法开发和原型验证的首选工具。而随着App Designer的推出，开发者现在能够轻松创建具有专业外观的图形用户界面（GUI），将复杂的算法封装成直观易用的桌面应用。然而，当需要将这些应用分享给没有安装MATLAB的同事或客户时，依赖问题便成为横亘在开发者面前的一道难题。

本文将深入探讨如何通过MATLAB的打包工具，将App Designer开发的应用及其必需的Runtime组件一起打包成独立的安装包，确保应用能够在任何Windows电脑上运行，无论是否安装了MATLAB。我们将从Runtime的工作原理讲起，逐步拆解打包过程中的关键决策点，并通过实战演示完整的打包、分发、安装流程，帮助开发者避开常见的"坑"。

1. 理解MATLAB Runtime：独立运行的核心

MATLAB Runtime是一个独立的执行环境，它包含了运行MATLAB编译应用程序所需的核心组件，但不包含MATLAB开发环境本身。当你在没有安装MATLAB的计算机上运行由MATLAB编译的应用程序时，Runtime提供了必要的支持。

1.1 Runtime的工作原理

Runtime本质上是一个精简版的MATLAB环境，它包含了：

• 基础执行引擎：能够解释和执行MATLAB代码
• 核心数学库：提供基本的数学运算功能
• 图形系统：支持App Designer创建的GUI界面渲染
• 工具箱组件：仅包含应用程序实际使用的工具箱功能

与完整MATLAB安装相比，Runtime有几个关键区别：

1.2 是否包含Runtime的决策

在打包App Designer应用时，开发者面临一个关键选择：是否将Runtime包含在安装包中。这个决策会影响：

1. 安装包大小：

   • 不含Runtime：安装包小（通常几MB到几十MB）
   • 包含Runtime：安装包大（可能增加几百MB）

2. 用户体验：

   • 不含Runtime：用户需要单独下载安装Runtime
   • 包含Runtime：一键安装，用户体验更流畅

3. 网络分发：

   • 不含Runtime：适合网络条件差的环境
   • 包含Runtime：适合带宽充足的环境

提示：对于内部工具分发，如果目标计算机已经安装了相同版本的Runtime，可以选择不包含以节省空间。而对于面向广泛用户的应用，包含Runtime能减少用户操作步骤。

2. 准备打包环境与项目

在开始打包前，确保你的开发环境满足以下要求：

2.1 系统与软件要求

• 操作系统：Windows 10或更高版本（64位）
• MATLAB版本：R2019b或更新版本
• 必要组件：
  • MATLAB Compiler
  • 对应版本的MATLAB Runtime
  • App Designer支持包

可以通过以下命令检查是否安装了必要组件：

% 检查Compiler安装 if ~isdeployed && isempty(ver('compiler')) error('MATLAB Compiler未安装'); end % 检查App Designer支持 if ~exist('appdesigner', 'file') error('App Designer支持包未安装'); end

2.2 项目结构优化

良好的项目结构能避免打包时的路径问题。推荐采用如下结构：

/my_app_project /src my_app.mlapp # App Designer主文件 helper_functions.m # 辅助函数 /data config.json # 配置文件 default_settings.mat # 默认设置 /resources icon.png # 应用图标 splash.jpg # 启动画面

关键优化点：

1. 使用相对路径：所有文件引用都应基于app.ProjectRoot或fileparts(mfilename('fullpath'))
2. 资源文件处理：将需要随应用分发的文件放在明确的位置
3. 依赖管理：明确列出所有外部依赖函数

3. 详细打包流程解析

3.1 创建打包工程

在MATLAB命令行中执行：

% 启动Application Compiler applicationCompiler

或者在App Designer界面选择"共享" > "打包应用"。

打包界面主要配置区域包括：

1. 主应用选择：指定要打包的.mlapp文件
2. 附加文件：添加应用依赖的数据文件、资源文件
3. Runtime选项：选择是否包含Runtime
4. 安装信息：设置应用名称、版本、公司信息等
5. 高级选项：自定义安装流程、注册表项等

3.2 关键配置详解

3.2.1 Runtime包含选项

在"附加运行时"部分，有两个重要选项：

1. 包含运行时在包中：

   • 优点：用户无需额外下载
   • 缺点：显著增加安装包大小

2. 从Web下载运行时：

   • 优点：减小初始下载体积
   • 缺点：需要用户有网络连接，可能遇到下载失败

注意：如果选择包含Runtime，建议在打包前清理不必要的工具箱依赖，以减小Runtime体积。

3.2.2 文件依赖处理

MATLAB不会自动检测动态加载的文件（如通过load或imread加载的文件）。必须手动添加这些文件到"附加文件"列表。常见需要添加的文件类型包括：

• 数据文件（.mat, .csv, .json）
• 图像资源（.png, .jpg）
• 配置文件（.ini, .xml）
• 第三方库（.dll, .mex）

可以使用以下代码片段帮助识别潜在的文件依赖：

% 查找可能被动态加载的文件 projectFiles = matlab.codetools.requiredFilesAndProducts('my_app.mlapp'); disp('项目依赖的文件:'); disp(projectFiles');

3.2.3 安装包自定义

在"安装信息"部分可以设置：

• 应用名称：显示在开始菜单和程序列表中的名称
• 版本号：遵循语义化版本规范（如1.0.0）
• 公司名称：用于安装路径和组织结构
• 应用图标：推荐使用256x256像素的PNG图标
• 启动画面：可选，显示在应用启动时的图片

3.3 生成安装包

完成配置后，点击"打包"按钮开始生成过程。打包完成后，会在输出目录生成三个文件夹：

1. for_redistribution：

   • 包含完整的安装包（.exe）
   • 可直接分发给最终用户

2. for_redistribution_files_only：

   • 仅包含应用文件，不含安装程序
   • 适合高级用户手动部署

3. for_testing：

   • 包含可直接运行的测试版本
   • 用于验证打包结果

典型的安装包目录结构如下：

MyAppInstaller_web.exe # 在线安装程序 MyAppInstaller.exe # 离线安装程序 MyApp/ # 应用文件 application/ # 可执行文件 runtime/ # Runtime文件（如包含） uninstall/ # 卸载程序

4. 安装与部署实战

4.1 用户端安装流程

当用户运行安装程序时，会经历以下步骤：

1. 欢迎界面：显示应用信息和系统要求
2. 许可协议：需要用户接受MATLAB Runtime许可
3. 安装位置选择：
   • 默认路径：C:\Program Files\CompanyName\AppName
   • 可自定义，但避免包含空格或特殊字符的路径
4. Runtime安装（如需要）：
   • 自动检测是否已安装兼容版本
   • 如需安装，会提示选择Runtime安装位置
5. 安装确认：显示摘要信息供用户确认
6. 安装完成：可选择创建桌面快捷方式

4.2 常见安装问题排查

1. Runtime版本冲突：

   • 症状：应用无法启动，提示Runtime版本不匹配
   • 解决方案：卸载现有Runtime，安装打包时指定的版本

2. 文件访问权限问题：

   • 症状：应用启动后无法读取数据文件
   • 解决方案：确保安装目录有读写权限，或修改应用代码使用%APPDATA%

3. 防病毒软件拦截：

   • 症状：安装过程中被中断
   • 解决方案：临时禁用防病毒软件，或将安装程序加入白名单

4.3 应用更新策略

当需要更新应用时，推荐采用以下方法之一：

1. 完整重新安装：

   • 打包新版本安装程序
   • 用户运行新安装程序覆盖旧版本

2. 增量更新：

   • 设计应用内置更新机制
   • 仅下载变化的文件替换原有文件

实现增量更新的示例代码框架：

function checkForUpdates(app) % 获取当前版本 currentVer = app.Version; % 从服务器获取最新版本信息 latestVer = webread('https://example.com/version.json'); if latestVer.number > currentVer % 提示用户更新 answer = questdlg('发现新版本，是否更新？', '更新提示', '是', '否', '是'); if strcmp(answer, '是') % 下载更新包 updateFile = websave('update.zip', latestVer.url); % 解压并替换文件 unzip(updateFile, app.ProjectRoot); % 重启应用 close(app.UIFigure); system(['start "" "' fullfile(app.ProjectRoot, 'MyApp.exe') '"']); end end end

5. 高级技巧与优化建议

5.1 减小安装包体积

当包含Runtime时，安装包体积可能变得很大。以下方法可以帮助减小体积：

1. 工具箱精简：

   • 仅包含应用实际使用的工具箱
   • 在MATLAB命令行运行depfun分析实际依赖

2. 数据文件压缩：

   • 将.mat文件保存为v7.3格式并启用压缩

   save('data.mat', 'data', '-v7.3', '-nocompression')

3. 资源优化：

   • 压缩图像资源（使用工具如TinyPNG）
   • 移除开发调试用的临时文件

5.2 提升启动速度

MATLAB Runtime应用有时启动较慢，可通过以下方式优化：

1. 预加载策略：

   • 将常用数据预先加载到内存
   • 使用持久变量(persistent)缓存计算结果

2. 并行初始化：

   • 将耗时的初始化工作放在后台线程

   % 使用parallel.Future异步执行 future = parfeval(@loadBigData, 1);

3. 启动画面：

   • 显示进度信息，提升用户体验

   function showSplashScreen(app) splash = figure('Name', 'Loading...', 'NumberTitle', 'off'); uiprogressdlg(splash, 'Title', '请稍候', 'Message', '正在初始化应用...'); % 执行初始化... close(splash); end

5.3 跨平台兼容性考虑

虽然本文主要讨论Windows平台，但App Designer应用也可以部署到macOS和Linux。关键差异点包括：

对于跨平台分发，建议：

1. 路径处理：使用filesep代替硬编码的\或/
2. 平台检测：运行时检查操作系统类型

   if ismac % macOS特定代码 elseif isunix % Linux特定代码 elseif ispc % Windows特定代码 end

3. 测试矩阵：在目标平台上全面测试所有功能

6. 实际案例：科研数据处理工具打包

以一个实际的科研数据处理工具为例，演示完整的打包和优化过程。该工具具有以下特点：

• 基于App Designer开发
• 使用Signal Processing Toolbox进行数据分析
• 依赖多个外部.m文件和.mat数据文件
• 需要读取/保存用户配置文件

6.1 项目结构分析

原始项目结构存在以下问题：

1. 绝对路径：代码中使用'C:\Research\data\default.mat'等硬编码路径
2. 冗余依赖：包含了未使用的Image Processing Toolbox函数
3. 大资源文件：包含未压缩的高分辨率图像

优化步骤：

1. 路径重构：

   % 替换前 load('C:\Research\data\default.mat'); % 替换后 appDataPath = fullfile(fileparts(mfilename('fullpath')), 'data'); load(fullfile(appDataPath, 'default.mat'));

2. 依赖清理：

   % 使用depfun分析实际依赖 [fList,pList] = matlab.codetools.requiredFilesAndProducts('mainApp.mlapp'); disp('使用的工具箱:'); disp({pList.Name}');

3. 资源优化：

   % 压缩图像 originalImg = imread('highres.png'); imwrite(originalImg, 'optimized.jpg', 'Quality', 85);

6.2 打包配置

针对该项目的最佳打包设置：

1. Runtime选项：包含Runtime（目标用户多为科研人员，IT支持有限）
2. 附加文件：
   • /data/*.mat
   • /resources/*.jpg
   • /config/*.json
3. 安装信息：
   • 应用名称：Research Data Analyzer
   • 版本：1.2.0
   • 公司：Academic Labs

6.3 性能优化结果

优化前后对比：

这些优化显著提升了用户体验，特别是在配置较低的实验室电脑上。