compiler.build.DotNETAssemblyOptions

Опции для создания блоков.NET

Описание

пример

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

пример

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

пример

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

пример

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

Примеры

свернуть все

Создайте 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
                  Verbose: off
                OutputDir: '.\magicsquaredotNETAssembly'

   Class Map Information
         magicsquareClass: {'C:\Program Files\MATLAB\R2021a\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
                  Verbose: on
                OutputDir: '.\magicsquaredotNETAssembly'

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

Используйте DotNETAssemblyOptions возразите как вход против compiler.build.dotNETAssembly функционируйте, чтобы создать блок.NET.

buildResults = compiler.build.dotNETAssembly(opts);

Создайте DotNETAssemblyOptions возразите и настройте его с помощью аргументов значения имени.

В данном примере используйте файл magicsquare.m расположенный в 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
                  Verbose: off
                OutputDir: 'D:\Documents\MATLAB\work\MagicDotNET'

   Class Map Information
         magicsquareClass: {'C:\Program Files\MATLAB\R2021a\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
                  Verbose: on
                OutputDir: 'D:\Documents\MATLAB\work\MagicDotNET'

   Class Map Information
         magicsquareClass: {'C:\Program Files\MATLAB\R2021a\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
                  Verbose: off
                OutputDir: '.\exampleFcn1dotNETAssembly'

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

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

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
                  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);

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

свернуть все

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

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

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

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

Пример: cmap

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

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

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

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

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

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

Имя блока.NET в виде вектора символов или строкового скаляра. Задайте 'AssemblyName' как пространство имен, которое является разделенным от периода списком, таким как companyname.groupname.component. Имя сгенерированной библиотеки определяется к последней записи разделенного от периода списка. Имя должно начаться с буквы и содержать только буквенные символы и периоды.

Пример: 'AssemblyName','mathworks.dotnet.mymagic'

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

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

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

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

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

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

  • Если вы устанавливаете это свойство на 'off', затем необходимо добавить файлы данных в блок с помощью AdditionalFiles опция.

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

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

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

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

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

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

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

  • Если вы устанавливаете это свойство на 'on', затем скомпилированный блок содержит отладочные символы.

  • Если вы устанавливаете это свойство на 'off', затем скомпилированный блок не содержит отладочные символы.

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

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

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

  • Если вы устанавливаете это свойство на 'on', затем функция встраивает архив блока в блок.NET.

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

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

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

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

  • Если вы устанавливаете это свойство на 'on', затем функция создает доступный удаленно блок.

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

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

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

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

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

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

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

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

Пример: 'SampleGenerationFiles',["sample1.m","sample2.m"]

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

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

Пример: 'StrongNameKeyFile','sgKey.snk'

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

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

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

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

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

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

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

свернуть все

Блок.NET создает опции, возвращенные как DotNETAssemblyOptions объект.

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

Введенный в R2021a