compiler.build.productionServerArchive

Создайте архив для развертывания на MATLAB Production Server

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

Синтаксис

compiler.build.productionServerArchive(FunctionFiles)
compiler.build.productionServerArchive(FunctionFiles,Name,Value)
compiler.build.productionServerArchive(opts)
results = compiler.build.productionServerArchive(___)

Описание

пример

compiler.build.productionServerArchive(FunctionFiles) создает развертываемый архив с помощью MATLAB® функции заданы FunctionFiles.

пример

compiler.build.productionServerArchive(FunctionFiles,Name,Value) создает развертываемый архив с дополнительными опциями, заданными с помощью одних или нескольких аргументов name-value. Опции включают архивное имя, подписи функции JSON, и выводят директорию.

пример

compiler.build.productionServerArchive(opts) создает развертываемый архив с опциями, заданными с помощью compiler.build.ProductionServerArchiveOptions объект opts. Вы не можете задать никакие другие опции с помощью аргументов name-value.

пример

results = compiler.build.productionServerArchive(___) возвращает информацию о сборке как compiler.build.Results объект с помощью любой из комбинаций входных аргументов в предыдущих синтаксисах. Информация о сборке состоит из типа сборки, пути к скомпилированному архиву и опций сборки.

Примеры

свернуть все

Создайте развертываемый архив сервера.

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

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

Создайте архив рабочего сервера использование compiler.build.productionServerArchive команда.

compiler.build.productionServerArchive(appFile);

Этот синтаксис генерирует следующие файлы в папке под названием mymagicproductionServerArchive в вашей текущей рабочей директории:

  • includedSupportPackages.txt — Текстовый файл, который перечисляет все файлы поддержки, включенные в архив.

  • mymagic.ctf — Развертываемый архивный файл рабочего сервера.

  • mccExcludedFiles.log — Файл журнала, который содержит список любых функций тулбокса, которые не были включены в приложение. Для получения информации о неподдерживаемых функциях смотрите Ограничения MATLAB Compiler.

  • readme.txt — Файл Readme, который содержит информацию о необходимых условиях развертывания и списке файлов к пакету для развертывания.

  • requiredMCRProducts.txt — Текстовый файл, который содержит идентификаторы продукта продуктов, требуемых MATLAB Runtime запустить приложение.

Создайте рабочий сервер, архивируют и настраивают его с помощью аргументов name-value.

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

addFile = fullfile(matlabroot,'extern','examples','compilersdk','c_cpp','matrix','addmatrix.m');
subFile = fullfile(matlabroot,'extern','examples','compilersdk','c_cpp','matrix','subtractmatrix.m');

Создайте архив рабочего сервера использование compiler.build.productionServerArchive команда. Используйте аргументы name-value, чтобы задать архивное имя и включить многословный выход.

compiler.build.productionServerArchive({addFile,subFile},...
    'ArchiveName','MatrixArchive',...
    'Verbose','on');

Этот синтаксис генерирует следующие файлы в папке под названием MatrixArchiveproductionServerArchive в вашей текущей рабочей директории:

  • includedSupportPackages.txt — Текстовый файл, который перечисляет все файлы поддержки, включенные в архив.

  • MatrixArchive.ctf — Развертываемый архивный файл рабочего сервера.

  • mccExcludedFiles.log — Файл журнала, который содержит список любых функций тулбокса, которые не были включены в приложение. Для получения информации о неподдерживаемых функциях смотрите Ограничения MATLAB Compiler.

  • readme.txt — Файл Readme, который содержит информацию о необходимых условиях развертывания и списке файлов к пакету для развертывания.

  • requiredMCRProducts.txt — Текстовый файл, который содержит идентификаторы продукта продуктов, требуемых MATLAB Runtime запустить приложение.

Настройте несколько архивов рабочего сервера с помощью compiler.build.ProductionServerArchiveOptions Объект (MATLAB Production Server).

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

functionFile = fullfile(matlabroot,'extern','examples','compiler','hello.m');

Создайте ProductionServerArchiveOptions объект. Используйте аргументы name-value, чтобы задать общую выходную директорию, отключить автоматическое включение файлов данных и включить многословный выход.

opts = compiler.build.ProductionServerArchiveOptions(functionFile,...    
    'OutputDir','D:\Documents\MATLAB\work\ProductionServerBatch',...
    'AutoDetectDataFiles','off',...
    'Verbose','on')
opts = 

  ProductionServerArchiveOptions with properties:

            ArchiveName: 'hello'
          FunctionFiles: {'C:\Program Files\MATLAB\R2021b\extern\examples\compiler\hello.m'}
     FunctionSignatures: ''
        AdditionalFiles: {}
    AutoDetectDataFiles: off
        SupportPackages: {'autodetect'}
                Verbose: on
              OutputDir: 'D:\Documents\MATLAB\work\ProductionServerBatch'

Создайте архив рабочего сервера использование ProductionServerArchiveOptions объект.

compiler.build.productionServerArchive(opts);

Скомпилировать использование файла функции houdini.m с теми же опциями используйте запись через точку, чтобы изменить FunctionFiles из существующего ProductionServerArchiveOptions объект прежде, чем запустить сборку функционирует снова.

opts.FunctionFiles = 'houdini.m';
compiler.build.productionServerArchive(opts);

Путем изменения FunctionFiles аргумент и рекомпиляция, можно скомпилировать несколько архивов с помощью того же объекта опций.

Создайте рабочий сервер, архивируют и сохраняют информацию о типе сборки, архивном файле, включал пакеты поддержки и опции сборки к compiler.build.Results объект.

Компиляция с помощью файла magicsquare.m расположенный в matlabroot\extern\examples\compiler.

results = compiler.build.productionServerArchive(magicsquare.m')
results = 

  Results with properties:

                  BuildType: 'productionServerArchive'
                      Files: {'D:\Documents\MATLAB\work\magicsquareproductionServerArchive\magicsquare.ctf'}
    IncludedSupportPackages: {}
                    Options: [1×1 compiler.build.ProductionServerArchiveOptions]

Files свойство содержит путь к развертываемому архивному файлу magicsquare.ctf.

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

свернуть все

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

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

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

Архив рабочего сервера создает опции в виде compiler.build.ProductionServerArchiveOptions Объект (MATLAB Production Server).

Аргументы name-value

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

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

Имя развертываемого архива в виде вектора символов или строкового скаляра. Имя по умолчанию сгенерированного архива является первой записью FunctionFiles аргумент.

Пример: 'ArchiveName','MyMagic'

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

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

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

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

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

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

Путь к файлу JSON, который детализирует подписи всех функций, перечисленных в FunctionFilesВ виде вектора символов или строкового скаляра. Для получения информации об определении функциональных подписей смотрите Подписи функции MATLAB в JSON (MATLAB Production Server).

Пример: 'FunctionSignatures','D:\Documents\MATLAB\work\magicapp\signatures.json'

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

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

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

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

Пакеты поддержки, чтобы включать в виде одной из следующих опций:

  • 'autodetect' (значение по умолчанию) — Процесс анализа зависимостей обнаруживает и включает необходимые пакеты поддержки автоматически.

  • 'none' — Никакие пакеты поддержки не включены. Используя эту опцию может вызвать ошибки периода выполнения.

  • Строковый скаляр, вектор символов или массив ячеек из символьных векторов — Только заданные пакеты поддержки включены. Чтобы перечислить установленные пакеты поддержки или используемых определенным файлом, смотрите compiler.codetools.deployableSupportPackages.

.

Пример: 'SupportPackages',{'Deep Learning Toolbox Converter for TensorFlow Models','Deep Learning Toolbox Model for Places365-GoogLeNet Network'}

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

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

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

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

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

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

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

свернуть все

Создайте результаты, возвращенные как compiler.build.Results объект. Results объект состоит из:

  • Создайте тип, который является 'productionServerArchive'

  • Путь к развертываемому архивному файлу

  • Список включенных пакетов поддержки

  • Создайте опции в виде ProductionServerArchiveOptions объект

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

| | (MATLAB Production Server)

Введенный в R2020b

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

Поддержка

Для просмотра документации необходимо авторизоваться на сайте