How to Publish a MATLAB Interface to a C/C++ Library

You can publish an interface using a workflow script or from the MATLAB^® command line. For requirements to build an interface, see Requirements for Building Interface to C/C++ Libraries.

Publish with Workflow Script

1. Call the clibPublishInterfaceWorkflow function to open the template workflow script Publish MATLAB interface to C++ library.

2. Follow these steps in the live script. Each step has a code section to run.

   • Step 1: GENERATE — Generate a library definition file using the Generate C++ Interface Live Editor task.

     • 1a: Restore library definition — Optional step to recreate workspace variables across MATLAB sessions. For more information, see Restore Library Definition.

   • Step 2: DEFINE — Edit the library definition file to define missing DIRECTION, SHAPE, or MLTYPE parameters, or to customize the library help. For more information, see Define Missing DIRECTION Parameter, Define Missing SHAPE Parameter, Define Missing MLTYPE Parameter, and Publish Help Text for MATLAB Interface to C/C++ Library.

     • 2a: Confirm edits and run summary — Display the MATLAB signatures for each supported construct of the library.

   • Step 3: BUILD — Build the MATLAB interface to the C++ library file from the library definition file. For more information, see Build C/C++ Library Interface and Review Contents.

   • Step 4: TEST

     • 4a: Set up and copy run-time libraries — Copy run-time library files to the interface library folder. If your library has additional run-time dependencies, specify them in this section. For more information, see Set Up and Copy Run-Time Libraries.

     • 4b: Enable out-of-process execution mode — Setup to call the interface library out-of-process which prevents a MATLAB restart if the definition file needs to change. For more information, see Load Out-of-Process C/C++ Library.

     • 4c: Call help on interface library — Display help for the interface library.

     • 4d: Write code to call and test interface library — Call your library using the syntax clib.libraryName followed by the library construct.

     • 4e: Unload out-of-process library — Unload the out-of-process MATLAB library. For more information, see Unload Out-of-Process C/C++ Library.

3. To share your interface with MATLAB users, see Distribute MATLAB Interface to C/C++ Library.

Publish at Command Line

You can publish an interface from the command line by calling the clibgen.generateLibraryDefinition function. The outline for publishing an interface includes these steps:

• For Step 1: Generate, see clibgen.generateLibraryDefinition.

• For Step 2: Define, see Define MATLAB Interface for C/C++ Library.

• For Step 3: Build, see Build C/C++ Library Interface and Review Contents.

• For Step 4: Test, see Call Functions in Interface to matrixOperations C++ Compiled Library on Windows or Call Functions in Interface to matrixOperations C++ Compiled Library on Linux.

• For Step 5: Distribute, see Distribute MATLAB Interface to C/C++ Library.

Examples to Publish an Interface

• Header and C++ Source Files

• Header and C++ Compiled Library Files on Windows

• Header and C++ Compiled Library Files on Linux

• Header and C++ Compiled Library Files on macOS

• Header-Only HPP File