Main Content

isdeployed

Determine whether code is running in deployed or MATLAB mode

Description

example

x = isdeployed returns logical 1 (true) when the function is running in deployed mode using MATLAB® Runtime and 0 (false) if it is running in a MATLAB session.

An application running in deployed mode consists of a collection of MATLAB functions and data packaged using MATLAB Compiler™ into software components that run outside of a MATLAB session using MATLAB Runtime libraries.

Examples

collapse all

You can access files included in a packaged application by using the which function, or by specifying the file location relative to ctfroot.

Add a file such as extern_app.exe to your MATLAB Compiler project.

Check if the code is running in deployed mode by using isdeployed. Then, obtain the path to the file by using the which function.

if isdeployed
    locate_externapp = which(fullfile('extern_app.exe'));
end
The which function returns the path to the file extern_app.exe, as long as it is located within the deployable archive.

For more information, see Access Files in Packaged Applications.

The path of a deployed application is fixed at compile time and cannot change. Use isdeployed to ensure that the application uses path modifying functions, such as addpath, before deployment.

if ~(ismcc || isdeployed)
    addpath(mypath);
end

You cannot use the doc function to open the Help browser from a deployed application. Instead, redirect a help query to the MathWorks® website.

if ~isdeployed
    doc(mfile);
else 
   web('https://www.mathworks.com/support.html');
end

Extended Capabilities

Version History

Introduced before R2006a