compiler.build.COMComponentOptions

Опции для создания COM-компонентов

свернуть все на странице

Синтаксис

opts = compiler.build.COMComponentOptions(Files)

opts = compiler.build.COMComponentOptions(Files,Name,Value)

opts = compiler.build.COMComponentOptions(ClassMap)

opts = compiler.build.COMComponentOptions(ClassMap,Name,Value)

Описание

пример

opts = compiler.build.COMComponentOptions(Files) создает COMComponentOptions объект с помощью функций MATLAB^® задан Files. Используйте COMComponentOptions возразите как вход против compiler.build.comComponent функция.

пример

opts = compiler.build.COMComponentOptions(Files,Name,Value) создает COMComponentOptions объект с опциями, заданными с помощью одного или нескольких аргументов значения имени. Опции включают имя компонента, выводят директорию и дополнительные файлы, чтобы включать.

пример

opts = compiler.build.COMComponentOptions(ClassMap) создает COMComponentOptions объект с классом, сопоставляющим заданное использование container.Map объект ClassMap.

пример

opts = compiler.build.COMComponentOptions(ClassMap,Name,Value) создает COMComponentOptions объект с классом, сопоставляющим заданное использование ClassMap и опции задали использование одного или нескольких аргументов значения имени.

Примеры

свернуть все

Создайте объект опций COM-компонента Используя файл

Создайте COMComponentOptions объект в системе Windows^® с помощью файла вводится.

В данном примере используйте файл magicsquare.m расположенный в matlabroot\extern\examples\compiler.

appFile = fullfile(matlabroot,'extern','examples','compiler','magicsquare.m');
opts = compiler.build.COMComponentOptions(appFile)

opts =

  COMComponentOptions with properties:

            ClassMap: [1×1 containers.Map]
          ComponentName: 'magicsquare'
       ComponentVersion: '1.0.0.0'
           EmbedArchive: on
        AdditionalFiles: {}
    AutoDetectDataFiles: on
                Verbose: off
              OutputDir: '.\magicsquarecomComponent'

   Class Map Information
       magicsquareClass: {'C:\Program Files\MATLAB\R2021a\extern\examples\compiler\magicsquare.m'}

Можно изменить значения свойств существующего COMComponentOptions объект с помощью записи через точку. Например, включите многословный выход.

opts.Verbose = 'on'

opts =

  COMComponentOptions with properties:

            ClassMap: [1×1 containers.Map]
          ComponentName: 'magicsquare'
       ComponentVersion: '1.0.0.0'
           EmbedArchive: on
        AdditionalFiles: {}
    AutoDetectDataFiles: on
                Verbose: on
              OutputDir: 'D:\Documents\MATLAB\work\COMComponent'

   Class Map Information
       magicsquareClass: {'C:\Program Files\MATLAB\R2021a\extern\examples\compiler\magicsquare.m'}

Используйте COMComponentOptions возразите как вход против compiler.build.comComponent функционируйте, чтобы создать COM-компонент.

buildResults = compiler.build.comComponent(opts);

Настройте объект опций COM-компонента

Создайте COMComponentOptions объект в системе Windows и настраивает его с помощью аргументов значения имени.

В данном примере используйте файл magicsquare.m расположенный в matlabroot\extern\examples\compiler. Используйте аргументы значения имени, чтобы задать выходную директорию и отключить автоматическое обнаружение файлов данных.

opts = compiler.build.COMComponentOptions('magicsquare.m',...
    'OutputDir','D:\Documents\MATLAB\work\MagicCOMComponent',...
    'AutoDetectDataFiles','off')

opts =

  COMComponentOptions with properties:

            ClassMap: [1×1 containers.Map]
          ComponentName: 'magicsquare'
       ComponentVersion: '1.0.0.0'
           EmbedArchive: on
        AdditionalFiles: {}
    AutoDetectDataFiles: off
                Verbose: off
              OutputDir: 'D:\Documents\MATLAB\work\MagicCOMComponent'

   Class Map Information
       magicsquareClass: {'C:\Program Files\MATLAB\R2021a\extern\examples\compiler\magicsquare.m'}

opts.Verbose = 'on'

opts =

  COMComponentOptions with properties:

            ClassMap: [1×1 containers.Map]
          ComponentName: 'magicsquare'
       ComponentVersion: '1.0.0.0'
           EmbedArchive: on
        AdditionalFiles: {}
    AutoDetectDataFiles: off
                Verbose: on
              OutputDir: 'D:\Documents\MATLAB\work\MagicCOMComponent'

   Class Map Information
       magicsquareClass: {'C:\Program Files\MATLAB\R2021a\extern\examples\compiler\magicsquare.m'}

Используйте COMComponentOptions возразите как вход против compiler.build.comComponent функция.

buildResults = compiler.build.comComponent(opts);

Создайте объект опций COM-компонента Используя карту класса

Создайте COMComponentOptions объект в системе Windows с помощью карты класса.

Создайте containers.Map возразите, чьи ключи являются именами классов и чьи значения являются файлами функции MATLAB.

cmap = containers.Map;
cmap('Class1') = {'exampleFcn1.m','exampleFcn2.m'};
cmap('Class2') = {'exampleFcn3.m','exampleFcn4.m'};

Создайте COMComponentOptions объект с помощью класса сопоставляет cmap.

opts = compiler.build.COMComponentOptions(cmap)

opts =

  COMComponentOptions with properties:

            ClassMap: [2×1 containers.Map]
          ComponentName: 'exampleFcn1'
       ComponentVersion: '1.0.0.0'
           EmbedArchive: on
        AdditionalFiles: {}
    AutoDetectDataFiles: on
                Verbose: off
              OutputDir: '.\exampleFcn1comComponent'

   Class Map Information
                 Class1: {2×1 cell}
                 Class2: {2×1 cell}

Чтобы настроить COM-компонент, создайте новый COMComponentOptions объект с помощью аргументов значения имени или изменяет существующий объект с помощью записи через точку. Например, задайте выходную директорию, включите многословный выход и отключите автоматическое обнаружение файлов данных.

opts = compiler.build.COMComponentOptions(cmap,...
    'OutputDir','D:\Documents\MATLAB\work\MagicCOMComponent',...
    'Verbose','On');
opts.AutoDetectDataFiles = 'off'

opts =

  COMComponentOptions with properties:

            ClassMap: [2×1 containers.Map]
          ComponentName: 'exampleFcn1'
       ComponentVersion: '1.0.0.0'
           EmbedArchive: on
        AdditionalFiles: {}
    AutoDetectDataFiles: off
                Verbose: on
              OutputDir: 'D:\Documents\MATLAB\work\MagicCOMComponent'

   Class Map Information
                 Class1: {2×1 cell}
                 Class2: {2×1 cell}

buildResults = compiler.build.comComponent(opts);

Входные параметры

свернуть все

`Files` — Файлы, реализующие функции MATLAB
вектор символов | строковый скаляр | массив ячеек из символьных векторов | массив строк

Файлы, реализующие функции MATLAB в виде вектора символов, строкового скаляра, массива строк или массива ячеек из символьных векторов. Пути к файлам могут быть относительно текущей рабочей директории или абсолюта. Файлы должны иметь .m расширение.

Пример: ["myfunc1.m","myfunc2.m"]

Типы данных: char | string | cell

`ClassMap` — Карта класса
`containers.Map` объект

Карта класса в виде containers.Map объект. Ключи карты являются именами классов, и каждое значение является набором файлов, сопоставленных с соответствующим классом. Файлы должны иметь .m расширение.

Пример: cmap

Аргументы в виде пар имя-значение

Задайте дополнительные разделенные запятой пары Name,Value аргументы. Name имя аргумента и Value соответствующее значение. Name должен появиться в кавычках. Вы можете задать несколько аргументов в виде пар имен и значений в любом порядке, например: Name1, Value1, ..., NameN, ValueN.

Пример: 'EmbedArchive','on'

`'AdditionalFiles'` — Дополнительные файлы
вектор символов | строковый скаляр | массив ячеек из символьных векторов | массив строк

Дополнительные файлы, чтобы включать в COM-компонент в виде вектора символов, строкового скаляра, массива строк или массива ячеек из символьных векторов. Пути к файлам могут быть относительно текущей рабочей директории или абсолюта.

Пример: 'AdditionalFiles',["myvars.mat","data.txt"]

Типы данных: char | string | cell

`'AutoDetectDataFiles'` — Отметьте, чтобы автоматически включать файлы данных
`'on'` (значение по умолчанию) | логическое значение включения - выключения

Отметьте, чтобы автоматически включать файлы данных в виде 'on' или 'off', или как числовой или логический 1 TRUE) или 0 ложь). Значение 'on' эквивалентно true, и 'off' эквивалентно false. Таким образом можно использовать значение этого свойства как логическое значение. Значение хранится как логическое значение включения - выключения типа matlab.lang.OnOffSwitchState.

Если вы устанавливаете это свойство на 'on', затем файлы данных, которые вы предоставляете как входные параметры определенным функциям (такой как load и fopen) автоматически включены в COM-компонент.
Если вы устанавливаете это свойство на 'off', затем необходимо добавить файлы данных в компонент с помощью AdditionalFiles свойство.

Пример: 'AutoDetectDataFiles','off'

Типы данных: логический

`'ClassName'` — Имя COM-класса
вектор символов | строковый скаляр

Имя COM-класса в виде вектора символов или строкового скаляра. Вы не можете задать эту опцию, если вы используете ClassMap входной параметр. Имена классов должны совпадать с требованиями имени COM-класса.

Значением по умолчанию является имя первого файла, перечисленного в Files аргумент добавлен с Class.

Пример: 'ClassName','magicsquareClass'

Типы данных: char | string

`'ComponentName'` — Имя COM-компонента
вектор символов | строковый скаляр

Имя COM-компонента в виде вектора символов или строкового скаляра. Значение действует как идентификатор программы, который введен в Windows Registry. Имя по умолчанию сгенерированного компонента является первой записью Files аргумент. Имя должно начаться с буквы и содержать только буквенные символы и периоды.

Пример: 'ComponentName','mycomponent'

Типы данных: char | string

`'ComponentVersion'` — Версия компонента
'1.0.0.0' (значение по умолчанию) | вектор символов | строковый скаляр

Версия компонента в виде вектора символов или строкового скаляра. Для получения информации об управлении версиями с помощью MATLAB Compiler SDK™ смотрите Управление версиями.

Пример: 'ComponentVersion','4.0'

Типы данных: char | string

`'EmbedArchive'` — Отметьте, чтобы встроить архив блока
`'on'` (значение по умолчанию) | логическое значение включения - выключения

Отметьте, чтобы встроить архив блока в виде 'on' или 'off', или как числовой или логический 1 TRUE) или 0 ложь). Значение 'on' эквивалентно true, и 'off' эквивалентно false. Таким образом можно использовать значение этого свойства как логическое значение. Значение хранится как логическое значение включения - выключения типа matlab.lang.OnOffSwitchState.

Если вы устанавливаете это свойство на 'on', затем функция встраивает архив блока в COM-компонент.
Если вы устанавливаете это свойство на 'off', затем функция генерирует архив блока как отдельный файл.

Пример: 'EmbedArchive','off'

Типы данных: логический

`'OutputDir'` — Путь, чтобы вывести директорию
вектор символов | строковый скаляр

Путь к выходной директории, где файлы типа "build" сохранены в виде вектора символов или строкового скаляра. Путь может быть относительно текущей рабочей директории или абсолюта.

Имя по умолчанию папки сборки является именем компонента, добавленным с comComponent.

Пример: 'OutputDir','D:\Documents\MATLAB\work\mycomponentcomComponent'

Типы данных: char | string

`'Verbose'` — Отметьте, чтобы управлять многословием сборки
`'off'` (значение по умолчанию) | логическое значение включения - выключения

Отметьте, чтобы управлять многословием сборки в виде 'on' или 'off', или как числовой или логический 1 TRUE) или 0 ложь). Значение 'on' эквивалентно true, и 'off' эквивалентно false. Таким образом можно использовать значение этого свойства как логическое значение. Значение хранится как логическое значение включения - выключения типа matlab.lang.OnOffSwitchState.

Если вы устанавливаете это свойство на 'on', затем окно команды MATLAB отображает информацию о прогрессе, указывающую на выход компилятора во время процесса сборки.
Если вы устанавливаете это свойство на 'off', затем командное окно не отображает информацию о прогрессе.

Пример: 'Verbose','on'

Типы данных: логический

Выходные аргументы

свернуть все

`opts` — Опции сборки COM-компонента
`COMComponentOptions` объект

Опции сборки COM-компонента, возвращенные как COMComponentOptions объект.

Введенный в R2021a

Документация

compiler.build.COMComponentOptions

Синтаксис

Описание

Примеры

Создайте объект опций COM-компонента Используя файл

Настройте объект опций COM-компонента

Создайте объект опций COM-компонента Используя карту класса

Входные параметры

`Files` — Файлы, реализующие функции MATLAB
вектор символов | строковый скаляр | массив ячеек из символьных векторов | массив строк

`ClassMap` — Карта класса
`containers.Map` объект

Аргументы в виде пар имя-значение

`'AdditionalFiles'` — Дополнительные файлы
вектор символов | строковый скаляр | массив ячеек из символьных векторов | массив строк

`'AutoDetectDataFiles'` — Отметьте, чтобы автоматически включать файлы данных
`'on'` (значение по умолчанию) | логическое значение включения - выключения

`'ClassName'` — Имя COM-класса
вектор символов | строковый скаляр

`'ComponentName'` — Имя COM-компонента
вектор символов | строковый скаляр

`'ComponentVersion'` — Версия компонента
'1.0.0.0' (значение по умолчанию) | вектор символов | строковый скаляр

`'EmbedArchive'` — Отметьте, чтобы встроить архив блока
`'on'` (значение по умолчанию) | логическое значение включения - выключения

`'OutputDir'` — Путь, чтобы вывести директорию
вектор символов | строковый скаляр

`'Verbose'` — Отметьте, чтобы управлять многословием сборки
`'off'` (значение по умолчанию) | логическое значение включения - выключения

Выходные аргументы

`opts` — Опции сборки COM-компонента
`COMComponentOptions` объект

Смотрите также

Документация MATLAB Compiler SDK

Поддержка

Документация

compiler.build.COMComponentOptions

Синтаксис

Описание

Примеры

Создайте объект опций COM-компонента Используя файл

Настройте объект опций COM-компонента

Создайте объект опций COM-компонента Используя карту класса

Входные параметры

Files — Файлы, реализующие функции MATLAB вектор символов | строковый скаляр | массив ячеек из символьных векторов | массив строк

ClassMap — Карта класса containers.Map объект

Аргументы в виде пар имя-значение

'AdditionalFiles' — Дополнительные файлы вектор символов | строковый скаляр | массив ячеек из символьных векторов | массив строк

'AutoDetectDataFiles' — Отметьте, чтобы автоматически включать файлы данных 'on' (значение по умолчанию) | логическое значение включения - выключения

'ClassName' — Имя COM-класса вектор символов | строковый скаляр

'ComponentName' — Имя COM-компонента вектор символов | строковый скаляр

'ComponentVersion' — Версия компонента'1.0.0.0' (значение по умолчанию) | вектор символов | строковый скаляр

'EmbedArchive' — Отметьте, чтобы встроить архив блока 'on' (значение по умолчанию) | логическое значение включения - выключения

'OutputDir' — Путь, чтобы вывести директорию вектор символов | строковый скаляр

'Verbose' — Отметьте, чтобы управлять многословием сборки 'off' (значение по умолчанию) | логическое значение включения - выключения

Выходные аргументы

opts — Опции сборки COM-компонента COMComponentOptions объект

Смотрите также

Документация MATLAB Compiler SDK

Поддержка

`Files` — Файлы, реализующие функции MATLAB
вектор символов | строковый скаляр | массив ячеек из символьных векторов | массив строк

`ClassMap` — Карта класса
`containers.Map` объект

`'AdditionalFiles'` — Дополнительные файлы
вектор символов | строковый скаляр | массив ячеек из символьных векторов | массив строк

`'AutoDetectDataFiles'` — Отметьте, чтобы автоматически включать файлы данных
`'on'` (значение по умолчанию) | логическое значение включения - выключения

`'ClassName'` — Имя COM-класса
вектор символов | строковый скаляр

`'ComponentName'` — Имя COM-компонента
вектор символов | строковый скаляр

`'ComponentVersion'` — Версия компонента
'1.0.0.0' (значение по умолчанию) | вектор символов | строковый скаляр

`'EmbedArchive'` — Отметьте, чтобы встроить архив блока
`'on'` (значение по умолчанию) | логическое значение включения - выключения

`'OutputDir'` — Путь, чтобы вывести директорию
вектор символов | строковый скаляр

`'Verbose'` — Отметьте, чтобы управлять многословием сборки
`'off'` (значение по умолчанию) | логическое значение включения - выключения

`opts` — Опции сборки COM-компонента
`COMComponentOptions` объект