copyRuntimeDependencies

R2026b

Class: clibgen.LibraryDefinition
Namespace: clibgen

(Not recommended) Copy run-time libraries to C++ interface library folder

Since R2023a

copyRuntimeDependencies is not recommended. For more information on updating your code, see Version History.

Syntax

copyRuntimeDependencies(libdef)
copyRuntimeDependencies(libdef,options)


Description

copyRuntimeDependencies(libdef) copies each run-time library specified in libDef to the folder containing the interface library file created by the build command. This folder is on the MATLAB^® path, making the files available when you test. The clibPublishInterfaceWorkflow script calls this function in the Set up and copy run-time libraries section.

This function collects the necessary files for distributing to end users so that they do not have to set environment variables to call functions in the library.

copyRuntimeDependencies(libdef,options) copies run-time libraries with additional options specified by one or more Name=Value arguments.

Name-Value Arguments

Specify optional pairs of arguments as Name1=Value1,...,NameN=ValueN, where Name is 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.

AdditionalRuntimeFolders — Absolute paths to folders with additional run-time dependencies

string vector

Absolute paths to folders with additional run-time dependencies, specified as a string vector. The function copies all run-time dependencies from each run-time path to the interface library folder.

AdditionalRuntimeDependencies — Absolute paths to additional run-time dependencies

string vector

Absolute paths to additional run-time dependencies, specified as a string vector, to be copied to the interface library folder.

Verbose — Option to display details

true or 1 (default) | false or 0

Option to display details from the copy command, specified as a numeric or logical 1 (true) or 0 (false). If Verbose is true, then the function displays details about each library copied. If Verbose is false, then the function displays a brief success message.

Examples

Copy Libraries from Additional Run-time Folders to Interface Library Folder

Show details about libraries copied into the interface library folder.

libdef.copyRuntimeDependencies(AdditionalRuntimeFolders="C:\mylib\util\win64",...
    Verbose=true)

Copied 5 run-time library file(s) to 'C:\matlab\win64\mylib'
            C:\mylib\lib\win64\mylib.dll
            C:\mylib\util\win64\bar.dll
            C:\mylib\util\win64\foo.dll
            C:\mylib\util\win64\foo32.dll
            C:\mylib\util\win64\fubar.dll
Run-time dependencies copied to interface library folder.

Version History

Introduced in R2023a

R2026b: Not recommended

There are no plans to remove copyRuntimeDependencies. However, creating a clibgen.api.InterfaceDefinition object in the clibgen.api namespace is recommended instead.