Опции для создания блоков.NET
создает opts
= compiler.build.DotNETAssemblyOptions(Files
)DotNETAssemblyOptions
объект с помощью MATLAB® функции заданы Files
. Используйте DotNETAssemblyOptions
возразите как вход против compiler.build.dotNETAssembly
функция.
создает opts
= compiler.build.DotNETAssemblyOptions(Files
,Name,Value
)DotNETAssemblyOptions
объект с опциями, заданными с помощью одних или нескольких аргументов name-value. Опции включают имя класса, выводят директорию и дополнительные файлы, чтобы включать.
создает opts
= compiler.build.DotNETAssemblyOptions(ClassMap
,Name,Value
)DotNETAssemblyOptions
объект с классом, сопоставляющим заданное использование ClassMap
и опции задали использование одних или нескольких аргументов name-value. Опции включают имя сборки, выводят директорию и дополнительные файлы, чтобы включать.
Создайте DotNETAssemblyOptions
объект с помощью файла вводится.
В данном примере используйте файл magicsquare.m
расположенный в
.matlabroot
\extern\examples\compiler
appFile = fullfile(matlabroot,'extern','examples','compiler','magicsquare.m'); opts = compiler.build.DotNETAssemblyOptions(appFile)
opts =
DotNETAssemblyOptions with properties:
AssemblyName: 'example.magicsquare'
AssemblyVersion: '1.0.0.0'
ClassMap: [1×1 containers.Map]
DebugBuild: off
EmbedArchive: on
EnableRemoting: off
SampleGenerationFiles: {}
StrongNameKeyFile: ''
AdditionalFiles: {}
AutoDetectDataFiles: on
SupportPackages: {'autodetect'}
Verbose: off
OutputDir: '.\magicsquaredotNETAssembly'
Class Map Information
magicsquareClass: {'C:\Program Files\MATLAB\R2021b\extern\examples\compiler\magicsquare.m'}
Можно изменить значения свойств существующего DotNETAssemblyOptions
объект с помощью записи через точку.
opts.Verbose = 'on'
opts =
DotNETAssemblyOptions with properties:
AssemblyName: 'example.magicsquare'
AssemblyVersion: '1.0.0.0'
ClassMap: [1×1 containers.Map]
DebugBuild: off
EmbedArchive: on
EnableRemoting: off
SampleGenerationFiles: {}
StrongNameKeyFile: ''
AdditionalFiles: {}
AutoDetectDataFiles: on
SupportPackages: {'autodetect'}
Verbose: on
OutputDir: '.\magicsquaredotNETAssembly'
Class Map Information
magicsquareClass: {'C:\Program Files\MATLAB\R2021b\extern\examples\compiler\magicsquare.m'}
Используйте DotNETAssemblyOptions
возразите как вход против compiler.build.dotNETAssembly
функционируйте, чтобы создать блок.NET.
buildResults = compiler.build.dotNETAssembly(opts);
Создайте DotNETAssemblyOptions
возразите и настройте его с помощью аргументов name-value.
В данном примере используйте файл magicsquare.m
расположенный в
. Используйте аргументы name-value, чтобы задать выходную директорию и отключить автоматическое обнаружение файлов данных.matlabroot
\extern\examples\compiler
opts = compiler.build.DotNETAssemblyOptions('magicsquare.m',... 'OutputDir','D:\Documents\MATLAB\work\MagicDotNET',... 'AutoDetectDataFiles','off')
opts =
DotNETAssemblyOptions with properties:
AssemblyName: 'example.magicsquare'
AssemblyVersion: '1.0.0.0'
ClassMap: [1×1 containers.Map]
DebugBuild: off
EmbedArchive: on
EnableRemoting: off
SampleGenerationFiles: {}
StrongNameKeyFile: ''
AdditionalFiles: {}
AutoDetectDataFiles: off
SupportPackages: {'autodetect'}
Verbose: off
OutputDir: 'D:\Documents\MATLAB\work\MagicDotNET'
Class Map Information
magicsquareClass: {'C:\Program Files\MATLAB\R2021b\extern\examples\compiler\magicsquare.m'}
Можно изменить значения свойств существующего DotNETAssemblyOptions
объект с помощью записи через точку. Например, включите многословный выход.
opts.Verbose = 'on'
opts =
DotNETAssemblyOptions with properties:
AssemblyName: 'example.magicsquare'
AssemblyVersion: '1.0.0.0'
ClassMap: [1×1 containers.Map]
DebugBuild: off
EmbedArchive: on
EnableRemoting: off
SampleGenerationFiles: {}
StrongNameKeyFile: ''
AdditionalFiles: {}
AutoDetectDataFiles: off
SupportPackages: {'autodetect'}
Verbose: on
OutputDir: 'D:\Documents\MATLAB\work\MagicDotNET'
Class Map Information
magicsquareClass: {'C:\Program Files\MATLAB\R2021b\extern\examples\compiler\magicsquare.m'}
Используйте DotNETAssemblyOptions
возразите как вход против compiler.build.dotNETAssembly
функционируйте, чтобы создать блок.NET.
buildResults = compiler.build.dotNETAssembly(opts);
Создайте DotNETAssemblyOptions
объект с помощью карты класса.
Создайте containers.Map
возразите, чьи ключи являются именами классов и чьи значения являются файлами функции MATLAB.
cmap = containers.Map; cmap('Class1') = {'exampleFcn1.m','exampleFcn2.m'}; cmap('Class2') = {'exampleFcn3.m','exampleFcn4.m'};
Создайте DotNETAssemblyOptions
объект с помощью класса сопоставляет cmap
.
opts = compiler.build.DotNETAssemblyOptions(cmap)
opts = DotNETAssemblyOptions with properties: AssemblyName: 'example.exampleFcn1' AssemblyVersion: '1.0.0.0' ClassMap: [2×1 containers.Map] DebugBuild: off EmbedArchive: on EnableRemoting: off SampleGenerationFiles: {} StrongNameKeyFile: '' AdditionalFiles: {} AutoDetectDataFiles: on SupportPackages: {'autodetect'} Verbose: off OutputDir: '.\exampleFcn1dotNETAssembly' Class Map Information Class1: {2×1 cell} Class2: {2×1 cell}
Можно также создать DotNETAssemblyOptions
объект с помощью аргументов name-value или изменяет существующий объект с помощью записи через точку. В данном примере задайте выходную директорию, включите многословный выход и отключите автоматическое обнаружение файлов данных.
opts = compiler.build.DotNETAssemblyOptions(cmap,... 'OutputDir','D:\Documents\MATLAB\work\MagicDotNET',... 'Verbose','On'); opts.AutoDetectDataFiles = 'off'
opts = DotNETAssemblyOptions with properties: AssemblyName: 'example.exampleFcn1' AssemblyVersion: '1.0.0.0' ClassMap: [2×1 containers.Map] DebugBuild: off EmbedArchive: on EnableRemoting: off SampleGenerationFiles: {} StrongNameKeyFile: '' AdditionalFiles: {} AutoDetectDataFiles: off SupportPackages: {'autodetect'} Verbose: on OutputDir: 'D:\Documents\MATLAB\work\MagicDotNET' Class Map Information Class1: {2×1 cell} Class2: {2×1 cell}
Используйте DotNETAssemblyOptions
возразите как вход против compiler.build.dotNETAssembly
функционируйте, чтобы создать блок.NET.
buildResults = compiler.build.dotNETAssembly(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
.
'Verbose','on'
AdditionalFiles
— Дополнительные файлыДополнительные файлы, чтобы включать в блок.NET в виде вектора символов, строкового скаляра, массива строк или массива ячеек из символьных векторов. Пути к файлам могут быть относительно текущей рабочей директории или абсолюта.
Пример: 'AdditionalFiles',["myvars.mat","data.txt"]
Типы данных: char |
string
| cell
AssemblyName
— Имя блока.NETИмя блока.NET в виде вектора символов или строкового скаляра. Задайте 'AssemblyName'
как пространство имен, которое является разделенным от периода списком, таким как companyname.groupname.component
. Имя сгенерированной библиотеки определяется к последней записи разделенного от периода списка. Имя должно начаться с буквы и содержать только буквенные символы и периоды.
Пример: 'AssemblyName','mathworks.dotnet.mymagic'
Типы данных: char |
string
AssemblyVersion
— Версия блока
(значение по умолчанию) | вектор символов | строковый скалярВерсия блока в виде вектора символов или строкового скаляра. Для получения информации об управлении версиями с помощью MATLAB Compiler SDK™ смотрите Управление версиями.
Пример: 'AssemblyVersion','4.0'
Типы данных: char |
string
AutoDetectDataFiles
— Отметьте, чтобы автоматически включать файлы данных'on'
(значение по умолчанию) | логическое значение включения - выключенияОтметьте, чтобы автоматически включать файлы данных в виде 'on'
или 'off'
, или как числовой или логический 1
TRUE
) или 0
ложь
). Значение 'on'
эквивалентно true
, и 'off'
эквивалентно false
. Таким образом можно использовать значение этого свойства как логическое значение. Значение хранится как логическое значение включения - выключения типа matlab.lang.OnOffSwitchState
.
Если вы устанавливаете это свойство на 'on'
, затем файлы данных, которые вы предоставляете как входные параметры определенным функциям (такой как load
и fopen
) автоматически включены в блок.NET.
Если вы устанавливаете это свойство на 'off'
, затем необходимо добавить файлы данных в блок с помощью AdditionalFiles
опция.
Пример: 'AutoDetectDataFiles','off'
Типы данных: логический
ClassName
— Имя класса.NETИмя класса.NET в виде вектора символов или строкового скаляра. Вы не можете задать эту опцию, если вы используете ClassMap
входной параметр. Имена классов должны удовлетворить требования имени класса.NET.
Значением по умолчанию является имя первого файла, перечисленного в Files
аргумент добавлен с Class
.
Пример: 'ClassName','magicsquareClass'
Типы данных: char |
string
DebugBuild
— Отметьте, чтобы включить отладочные символы'off'
(значение по умолчанию) | логическое значение включения - выключенияОтметьте, чтобы включить отладочные символы в виде 'on'
или 'off'
, или как числовой или логический 1
TRUE
) или 0
ложь
). Значение 'on'
эквивалентно true
, и 'off'
эквивалентно false
. Таким образом можно использовать значение этого свойства как логическое значение. Значение хранится как логическое значение включения - выключения типа matlab.lang.OnOffSwitchState
.
Если вы устанавливаете это свойство на 'on'
, затем скомпилированный блок содержит отладочные символы.
Если вы устанавливаете это свойство на 'off'
, затем скомпилированный блок не содержит отладочные символы.
Пример: 'DebugBuild','on'
Типы данных: логический
EmbedArchive
— Отметьте, чтобы встроить архив блока'on'
(значение по умолчанию) | логическое значение включения - выключенияОтметьте, чтобы встроить архив блока в виде 'on'
или 'off'
, или как числовой или логический 1
TRUE
) или 0
ложь
). Значение 'on'
эквивалентно true
, и 'off'
эквивалентно false
. Таким образом можно использовать значение этого свойства как логическое значение. Значение хранится как логическое значение включения - выключения типа matlab.lang.OnOffSwitchState
.
Если вы устанавливаете это свойство на 'on'
, затем функция встраивает архив блока в блок.NET.
Если вы устанавливаете это свойство на 'off'
, затем функция генерирует архив блока как отдельный файл.
Пример: 'EmbedArchive','off'
Типы данных: логический
EnableRemoting
— Отметьте, чтобы управлять типом дистанционной работы'off'
(значение по умолчанию) | логическое значение включения - выключенияОтметьте, чтобы управлять типом дистанционной работы блока в виде 'on'
или 'off'
, или как числовой или логический 1
TRUE
) или 0
ложь
). Значение 'on'
эквивалентно true
, и 'off'
эквивалентно false
. Таким образом можно использовать значение этого свойства как логическое значение. Значение хранится как логическое значение включения - выключения типа matlab.lang.OnOffSwitchState
.
Если вы устанавливаете это свойство на 'on'
, затем функция создает доступный удаленно блок.
Если вы устанавливаете это свойство на 'off'
, затем функция создает блок, который не доступен удаленно.
Пример: 'EnableRemoting','on'
Типы данных: логический
OutputDir
— Путь, чтобы вывести директориюПуть к выходной директории, где файлы типа "build" сохранены в виде вектора символов или строкового скаляра. Путь может быть относительно текущей рабочей директории или абсолюта.
Имя по умолчанию папки сборки является именем сборки, добавленным с dotNETAssembly
.
Пример: 'OutputDir','D:\Documents\MATLAB\work\mymagicdotNETAssembly'
Типы данных: char |
string
SampleGenerationFiles
— Файлы примера MATLABФайлы примера MATLAB раньше генерировали демонстрационные файлы драйвера.NET для функций, включенных в рамках блока в виде вектора символов, строкового скаляра, массива строк или массива ячеек из символьных векторов. Пути к файлам могут быть относительно текущей рабочей директории или абсолюта. Файлы должны иметь .m
расширение. Для получения дополнительной информации и ограничения, смотрите Демонстрационное Создание Файла Драйвера.
Пример: 'SampleGenerationFiles',["sample1.m","sample2.m"]
Типы данных: char |
string
| cell
StrongNameKeyFile
— Путь к ключу шифрованияПуть к файлу ключа шифрования раньше подписывал совместно используемую сборку в виде вектора символов или строкового скаляра. Если значение пусто, функция создает приватную сборку. Путь к файлу может быть относительно текущей рабочей директории или абсолюта.
Пример: 'StrongNameKeyFile','sgKey.snk'
Типы данных: char |
string
SupportPackages
— Пакеты поддержки'autodetect'
(значение по умолчанию) | 'none'
| строковый скаляр | массив ячеек из символьных векторов | массив строкПакеты поддержки, чтобы включать в виде одной из следующих опций:
'autodetect'
(значение по умолчанию) — Процесс анализа зависимостей обнаруживает и включает необходимые пакеты поддержки автоматически.
'none'
— Никакие пакеты поддержки не включены. Используя эту опцию может вызвать ошибки периода выполнения.
Строковый скаляр, вектор символов или массив ячеек из символьных векторов — Только заданные пакеты поддержки включены. Чтобы перечислить установленные пакеты поддержки или используемых определенным файлом, смотрите compiler.codetools.deployableSupportPackages
.
.
Пример: 'SupportPackages',{'Deep Learning Toolbox Converter for TensorFlow Models','Deep Learning Toolbox Model for Places365-GoogLeNet Network'}
Типы данных: char |
string
| cell
Verbose
— Отметьте, чтобы управлять многословием сборки'off'
(значение по умолчанию) | логическое значение включения - выключенияОтметьте, чтобы управлять многословием сборки в виде 'on'
или 'off'
, или как числовой или логический 1
TRUE
) или 0
ложь
). Значение 'on'
эквивалентно true
, и 'off'
эквивалентно false
. Таким образом можно использовать значение этого свойства как логическое значение. Значение хранится как логическое значение включения - выключения типа matlab.lang.OnOffSwitchState
.
Если вы устанавливаете это свойство на 'on'
, затем окно команды MATLAB отображает информацию о прогрессе, указывающую на выход компилятора во время процесса сборки.
Если вы устанавливаете это свойство на 'off'
, затем командное окно не отображает информацию о прогрессе.
Пример: 'Verbose','on'
Типы данных: логический
opts
—. СЕТЕВЫЕ опции сборки блокаDotNETAssemblyOptions
объектБлок.NET создает опции, возвращенные как DotNETAssemblyOptions
объект.
1. Если смысл перевода понятен, то лучше оставьте как есть и не придирайтесь к словам, синонимам и тому подобному. О вкусах не спорим.
2. Не дополняйте перевод комментариями “от себя”. В исправлении не должно появляться дополнительных смыслов и комментариев, отсутствующих в оригинале. Такие правки не получится интегрировать в алгоритме автоматического перевода.
3. Сохраняйте структуру оригинального текста - например, не разбивайте одно предложение на два.
4. Не имеет смысла однотипное исправление перевода какого-то термина во всех предложениях. Исправляйте только в одном месте. Когда Вашу правку одобрят, это исправление будет алгоритмически распространено и на другие части документации.
5. По иным вопросам, например если надо исправить заблокированное для перевода слово, обратитесь к редакторам через форму технической поддержки.