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 объект, использующий любую из комбинаций входных аргументов в предыдущих синтаксисах. Информация о сборке состоит из типа сборки, пути к скомпилированному архиву и опций сборки.

Примеры

свернуть все

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

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

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

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

compiler.build.productionServerArchive(appFile);

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

  • mymagic.ctf - Развертываемый файл архива производственного сервера.

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

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

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

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

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

compiler.build.productionServerArchive(["myfunc1.m","myfunc2.m"],...
    'ArchiveName','MagicApp',...
    'FunctionSignatures','signatures.json');

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

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

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

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

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

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

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

Скомпилируйтесь с использованием файловой magicsquare.m расположен в matlabroot\ extern\примеры\компилятор.

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

  Results with properties:

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

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

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

свернуть все

Файлы, реализующие функции 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 (false). Значение 'on' эквивалентно true, и 'off' эквивалентно false. Таким образом, можно использовать значение этого свойства как логическое значение. Значение сохранено в виде логического значения on/off типа matlab.lang.OnOffSwitchState.

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

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

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

Типы данных: logical

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

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

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

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

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

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

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

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

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

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

Типы данных: logical

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

свернуть все

Результаты построения, возвращенные как compiler.build.Results объект. The Results объект состоит из:

  • Тип сборки, который 'productionServerArchive'

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

  • Опции сборки, заданные как ProductionServerArchiveOptions объект

См. также

| | (MATLAB Production Server)

Введенный в R2020b

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

Поддержка