Learn more about MATLAB Compiler

Deploying to Programmers

On this page…
Steps by the Programmer to Deploy to Programmers What Software Does a Programmer Need? Ensuring Memory for Deployed Applications

Steps by the Programmer to Deploy to Programmers

Note   If you are programming on the same machine where you created the component, you can skip the steps described here.

1. Create a package that contains the software necessary to support the compiled M-code. It is frequently helpful to install the MCR on development machines, for testing purposes. See What Software Does a Programmer Need?

   Note   You can use the Deployment Tool to create a package for programmers. For Windows platforms, the package created by the Deployment Tool is a self-extracting executable. For UNIX platforms, the package created by the Deployment Tool is a zip file that must be decompressed and installed manually. See Getting Started to get started using the Deployment Tool.

2. Write instructions for how to use the package.

   1. If your package was created with the Deployment Tool, Windows programmers can just run the self-extracting executable created by the Deployment Tool. UNIX programmers must unzip and install manually.

   2. All programmers must set path environment variables properly. See Directories Required for Development and Testing.

3. Distribute the package and instructions.

Back to Top

What Software Does a Programmer Need?

The software that you provide to a programmer who wants to use compiled M-code depends on which of the following kinds of software the programmer will be using:

• Standalone Application

• C or C++ Shared Library

• .NET Component

• COM Component

• Java Component

• COM Component to Use with Microsoft Excel

Note   MCRInstaller.exe has obsoleted the need for the function buildmcr or the creation of MCRInstaller.zip. See Replacement of MCRInstaller.zip and BUILDMCR Functionality for more details including complete file paths to all install programs.

Standalone Application

To distribute a standalone application created with MATLAB Compiler to a development machine, create a package that includes the following files.

Software Module	Description
MCRInstaller.exe (Windows)	MCRInstaller is a self-extracting executable that installs the necessary components to develop your application. This file is included with MATLAB Compiler.
MCRInstaller.bin (UNIX)	MCRInstaller is a self-extracting executable that installs the necessary components to develop your application on UNIX machines (other than Mac®). This file is included with MATLAB Compiler.
MCRInstaller.dmg (Mac)	MCRInstaller.dmg is a self-extracting executable that installs the necessary components to develop your application on Mac machines. This file is included with MATLAB Compiler.
application_name.exe (Windows)	Application created by MATLAB Compiler. Maci64 must include the bundle directory hierarchy.
application_name (UNIX)
application_name.app (Maci64)

Note   If you are using a non-Windows operating system, "console applications" are referred to as "standalone applications".

C or C++ Shared Library

To distribute a shared library created with MATLAB Compiler to a development machine, create a package that includes the following files.

Software Module	Description
MCRInstaller.bin (UNIX)	MATLAB Compiler Runtime library archive; platform-dependent file that must correspond to the end user's platform
MCRInstaller.dmg (Mac)	MCRInstaller.dmg is a self-extracting executable that installs the necessary components to develop your application on Mac machines. This file is included with MATLAB Compiler.
MCRInstaller.exe (Windows)	Self-extracting MATLAB Compiler Runtime library utility; platform-dependent file that must correspond to the end user's platform
libmatrix	Shared library; extension varies by platform, for example, DLL on Windows
libmatrix.h	Library header file
libmatrix.lib	Application library file; file is needed to create the driver application for the shared library.

.NET Component

To distribute a .NET component to a development machine, create a package that includes the following files.

Software Module	Description
componentName.xml	Documentation files
componentName.pdb (if Debug option is selected)	Program Database File, which contains debugging information
componentName.dll	Component assembly file
MCRInstaller.exe	MCR Installer (if not already installed on the target machine)

COM Component

To distribute a COM component to a development machine, create a package that includes the following files.

Software Module	Description
mwcomutil.dll	Utilities required for array processing. Provides type definitions used in data conversion.
componentname_ version.dll	Component that contains compiled M-code.
MCRInstaller.exe	Self-extracting MATLAB Compiler Runtime library utility; platform-dependent file that must correspond to the end user's platform. MCRInstaller.exe installs MATLAB Compiler Runtime (MCR), which users of your component need to install on the target machine once per release.

Java Component

To distribute a Java component to a development machine, create a package that includes the componentname.jar file, a Java package containing the Java interface to M-code.

Note   For more information, see the MWArray Javadoc, which is searchable from the Help or from the MathWorks Web site.

COM Component to Use with Microsoft Excel

To distribute a COM component for Excel to a development machine, create a package that includes the following files.

Software Module	Description
componentname_projectversion.dll	Compiled component.
MCRInstaller.exe	Self-extracting MATLAB Compiler Runtime library utility; platform-dependent file that must correspond to the end user's platform. MCRInstaller.exe installs the MATLAB Compiler Runtime (MCR), which users of your component need to install on the target machine once per release.
*.xla	Any user-created Excel add-in files found in the <projectdir>\distrib folder

Back to Top

Ensuring Memory for Deployed Applications

If you are having trouble obtaining memory for your deployed application, use MATLAB Memory Shielding for deployed applications to ensure a maximum amount of contiguous allocated memory. See Reserving Memory for Deployed Applications with MATLAB Memory Shielding for more information.

Back to Top

Overview

Deploying to End Users

© 1984-2009- The MathWorks, Inc.    -   Site Help   -   Patents   -   Trademarks   -   Privacy Policy   -   Preventing Piracy   -   RSS