Migrate GUIDE apps to App Designer
This function requires the GUIDE to App Designer Migration Tool for MATLAB.
appmigration.migrateGUIDEApp launches the GUIDE to App Designer Migration Tool for MATLAB®.
the GUIDE apps in the specified files and folders to App Designer apps as a batch using the
GUIDE to App Designer Migration Tool for MATLAB.
Migrate GUIDE App to App Designer
Suppose you have a GUIDE app that is saved in the
C:\Documents\Apps folder and consists of two files:
myApp.m. Migrate the GUIDE app to
App Designer using the GUIDE to App Designer Migration Tool for MATLAB, and display the migration progress and summary in the MATLAB Command Window.
Identified 1 GUIDE apps to migrate: C:\Documents\Apps\myApp.fig Migrating C:\Documents\Apps\myApp.fig... Success Summary: GUIDE App App Designer App Lines Components Callbacks Issues (Migration Analyzed Created Configured Report) ================================================================================= myApp.fig myApp_App.mlapp 260 14 3 0 Migration Summary: 1 Succeeded, 0 Failed
The migration summary includes links to browse to the location of the original GUIDE app, open the migrated App Designer app, and open the migration report generated by the migration tool.
For more information about the GUIDE to App Designer Migration Tool for MATLAB, see GUIDE Migration Strategies.
Migrate Multiple GUIDE Apps to App Designer
Suppose you have multiple GUIDE apps that are saved in the
C:\Documents\Apps folder and consist of these files:
A main app,
main.figwith code file
A secondary app,
secondary.figwith code file
Migrate both of the apps in a single command by specifying the folder that the apps are saved in. Display only the migration summary in the MATLAB Command Window.
appmigration.migrateGUIDEApp("C:\Documents\Apps\", ... OutputDetail="summary")
Migrating 2 GUIDE apps... Success Summary: GUIDE App App Designer App Lines Components Callbacks Issues (Migration Analyzed Created Configured Report) ================================================================================================ main.fig main_App.mlapp 270 34 10 0 ------------------------------------------------------------------------------------------------ secondary.fig secondary_App.mlapp 135 7 3 0 Migration Summary: 2 Succeeded, 0 Failed
appmigration.migrateGUIDEApp function updates references to
all apps that were successfully migrated using a single command. For example, if
secondary.m, during migration the
function updates the code in
main_App.mlapp to instead call
files — GUIDE apps to migrate
string array | character vector | cell array of character vectors
GUIDE apps to migrate to App Designer, specified as a string array, character vector, or cell array of character vectors.
Migrate a specific app by specifying the FIG file corresponding to the GUIDE app.
Migrate all apps in a folder by specifying the folder.
Specify files and folders using either a full path or a relative path from your current folder.
Specify optional pairs of arguments as
the argument name and
Value is the corresponding value.
Name-value arguments must appear after other arguments, but the order of the
pairs does not matter.
IncludeSubfolders — Indicator to migrate apps in subfolders
0 (default) |
Indicator to migrate apps in subfolders, specified as a numeric or logical
false), the function ignores subfolders within the specified
If you specified an app or list of apps to migrate, the function additionally migrates all apps that are contained in subfolders of the folders that contain the specified apps.
If you specified a folder or list of folders with the apps to migrate, the function additionally migrates all apps that are contained in subfolders of those folders.
OutputDetail — Level of detail of migration progress output
"detailed" (default) |
Level of detail of the migration progress output, specified as
"none". The function displays the migration progress in the
MATLAB Command Window while migrating the apps.
"detailed"— Display all progress, including which app is currently being migrated, any errors that occur during the migration progress, and a summary of all the apps that succeeded and failed to be migrated.
"summary"— Display only a summary of the apps that succeeded and failed to be migrated after the migration completes.
"none"— Do not display migration progress or a summary.
Version HistoryIntroduced in R2023a
R2023b: Migrating multiple apps updates app references
When you use the
appmigration.migrateGUIDEApp function to migrate
multiple apps at once, the function updates app references. For example, to migrate a main
app that opens a secondary app from GUIDE to App Designer, use the
appmigration.migrateGUIDEApp function to migrate the main and
secondary apps using a single command. The function replaces all references to the apps that
you migrate together. Therefore, your migrated main app opens the migrated secondary app
without any manual changes to your app code.