Опции для создания COM-компонентов
создает 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
,Name,Value
)COMComponentOptions
объект с классом, сопоставляющим заданное использование ClassMap
и опции задали использование одного или нескольких аргументов значения имени.
Создайте 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);
Создайте 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'}
Можно изменить значения свойств существующего COMComponentOptions
объект с помощью записи через точку. Например, включите многословный выход.
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);
Создайте 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}
Используйте COMComponentOptions
возразите как вход против compiler.build.comComponent
функционируйте, чтобы создать COM-компонент.
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'
— Версия компонента
(значение по умолчанию) | вектор символов | строковый скалярВерсия компонента в виде вектора символов или строкового скаляра. Для получения информации об управлении версиями с помощью 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
объект.
1. Если смысл перевода понятен, то лучше оставьте как есть и не придирайтесь к словам, синонимам и тому подобному. О вкусах не спорим.
2. Не дополняйте перевод комментариями “от себя”. В исправлении не должно появляться дополнительных смыслов и комментариев, отсутствующих в оригинале. Такие правки не получится интегрировать в алгоритме автоматического перевода.
3. Сохраняйте структуру оригинального текста - например, не разбивайте одно предложение на два.
4. Не имеет смысла однотипное исправление перевода какого-то термина во всех предложениях. Исправляйте только в одном месте. Когда Вашу правку одобрят, это исправление будет алгоритмически распространено и на другие части документации.
5. По иным вопросам, например если надо исправить заблокированное для перевода слово, обратитесь к редакторам через форму технической поддержки.