Exponenta Banner
exponenta event banner

compiler.build.productionServerArchive

Создание архива для развертывания на производственном сервере MATLAB

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

Синтаксис

compiler.build.prodityServerArchive (FuncterFiles)
compiler.build.prodityServerArchive (функциональные файлы, имя, значение)
compiler.build.prodityServerArchive (параметры)
results = compiler.build.prodityServerArchive (___)

Описание

пример

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\examples\compiler.

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

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

compiler.build.productionServerArchive(appFile);

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

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

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

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

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

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

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

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

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

Создать 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 argument и recompiling, можно скомпилировать несколько архивов, используя один и тот же объект options.

Создание архива производственного сервера и сохранение информации о типе сборки, архивном файле и параметрах сборки в 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'
              Options: [1×1 compiler.build.ProductionServerArchiveOptions]

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

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

свернуть все

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

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

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

Параметры построения архива производственного сервера, указанные как compiler.build.ProductionServerArchiveOptions(Производственный сервер MATLAB).

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

Укажите дополнительные пары, разделенные запятыми 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. Таким образом, можно использовать значение этого свойства в качестве логического значения. Значение сохраняется как логическое значение типа вкл/выкл matlab.lang.OnOffSwitchState.

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

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

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

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

Путь к файлу JSON, в котором содержатся подписи всех функций, перечисленных в FunctionFiles, задается как вектор символов или строковый скаляр. Сведения об указании сигнатур функций см. в разделе Сигнатуры функций MATLAB в 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. Таким образом, можно использовать значение этого свойства в качестве логического значения. Значение сохраняется как логическое значение типа вкл/выкл matlab.lang.OnOffSwitchState.

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

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

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

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

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

свернуть все

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

  • Тип построения, который является 'productionServerArchive'

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

  • Параметры построения, указанные как ProductionServerArchiveOptions объект

См. также

| | (производственный сервер MATLAB)

Представлен в R2020b

Документация по SDK компилятора MATLAB

Поддержка