You can package any MATLAB® app you create into a single
file that can be easily shared with others. When you package an app, MATLAB creates
a single app installation file (
The installation file enables you and others to install your app and
access it from the apps gallery without concern for installation details
or the MATLAB path.
As you enter information in the Package Apps dialog box, MATLAB creates
and saves a
.prj file continuously. A
contains information about your app, such as included files and a
description. Therefore, if you exit the dialog box before clicking
the Package button, the
remains, even though a
.mlappinstall file is not
.prj file enables you to quit and
resume the app creation process where you left off.
To create an app installation file:
On the desktop Toolstrip, on the Home tab, click the Add-Ons down-arrow.
Click Package App.
In the Package App dialog box, click Add main file and specify the file that you use to run the app you created.
The main file must be callable with no input and must be a function or method, not a script. MATLAB analyzes the main file to determine if there are other files used in the app. For more information, see Dependency Analysis.
The main file must return the figure handle of your app for MATLAB to remove your app files from the search path when users exit the app. For more information, see What Is the MATLAB Search Path?
(Functions created by GUIDE return the figure handle.)
If your app requires additional files that are not listed under Files included through analysis, add them by clicking Add files/folders.
You can include external interfaces, such as MEX-files or Java® in the
.mlappinstall file, although doing so can restrict
the systems on which your app can run.
Describe your app.
In the App Name field, type an app name.
If you install the app, MATLAB uses the name for the
and to label your app in the apps gallery.
Optionally, specify an app icon.
Click the icon to the left of the App Name field to select an icon for your app or to specify a custom icon. MATLAB automatically scales the icon for use in the Install dialog box, App gallery, and quick access toolbar.
Optionally, select a previously saved screenshot to represent your app.
Optionally, specify author information.
In the Description field, describe your app so others can decide if they want to install it.
Identify the products on which your app depends.
Click the plus button on the right side of the Products field, select the products on which your app depends, and then click Apply Changes. Keep in mind that your users must have all of the dependent products installed on their systems.
After you create the package, when you select a
.mlappinstall file in the
Current Folder browser, MATLAB displays the information you provided (except your email address and company
name) in the Current Folder browser Details panel. If you share your
app in the MATLAB Central File Exchange, the same information also displays there. The
screenshot you select, if any, represents your app in File Exchange.
As part of the app packaging process, MATLAB creates a
that contains information about your app, such as included files and
a description. The
.prj file enables you to update
the files in your app without requiring you to respecify descriptive
information about the app.
In the Build dialog box, note the location of the
installation file (
.mlappinstall), and then click Close.
For information on installing the app, see Install Add-Ons from File.