Exponenta Banner
exponenta event banner

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) создает развертываемый архив с дополнительными опциями, заданными как одна или несколько пар "имя-значение". Опции включают архивное имя, подписи функции JSON, и выводят директорию.

пример

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

пример

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

Примеры

свернуть все

Создайте развертываемый архив сервера на операционной системе Windows®.

Запишите функцию MATLAB, которая генерирует магический квадрат. Сохраните функцию в файле с именем mymagic.m.

% mymagic.m
function out = mymagic(in)

if ischar(in)
    in=str2double(in);
end
out = magic(in)

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

compiler.build.productionServerArchive('mymagic.m');

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

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

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

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

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

Настройте архив рабочего сервера использование пар "имя-значение" в системе Windows.

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

compiler.build.productionServerArchive(["mymagic.m","myfunc.m"],...
    'ArchiveName','MagicApp',...
    'FunctionSignatures','signatures.json',)

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

Создайте ProductionServerArchiveOptions объект.

opts = compiler.build.ProductionServerArchiveOptions('example.m',...    
    'OutputDir','D:\Documents\MATLAB\work\ProductionServerBatch',...
    'AutoDetectDataFiles','Off',...
    'Verbose','on');
opts = 

  ProductionServerArchiveOptions with properties:

            ArchiveName: 'example'
          FunctionFiles: {'D:\Documents\MATLAB\work\example.m'}
     FunctionSignatures: ''
        AdditionalFiles: {}
    AutoDetectDataFiles: off
                Verbose: on
              OutputDir: 'D:\Documents\MATLAB\work\ProductionServerBatch'

Передайте ProductionServerArchiveOptions возразите как вход против функции сборки.

compiler.build.productionServerArchive(opts);

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

opts.FunctionFiles = 'example2.m';

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

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

Сохраните compiler.build.productionServerArchive информация к Results объект путем объявления выходной переменной.

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

  Results with properties:

            BuildType: 'productionServerArchive'
                Files: 'D:\Documents\MATLAB\work\mymagicproductionServerArchive\mymagic.ctf'
              Options: [1×1 compiler.build.ProductionServerArchiveOptions]

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

свернуть все

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

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

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

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

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

Задайте дополнительные разделенные запятой пары 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, который детализирует подписи JSON всех функций, перечисленных в FunctionFiles. Для получения информации о том, как задать функциональные подписи, смотрите Подписи функции MATLAB в JSON (MATLAB Production Server).

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

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

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

Если никакой путь не задан, папка сборки создается в текущей рабочей директории с именем ArchiveNameproductionServerArchive.

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

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

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

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

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

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

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

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

свернуть все

Создайте результаты, возвращенные как compiler.build.Results объект. Results объект содержит тип сборки ('productionServerArchive'), путь к развертываемому архивному файлу (.ctf), и опции сборки в виде ProductionServerArchiveOptions объект.

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

(MATLAB Production Server)

Введенный в R2020b

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

Поддержка