compiler.build.webAppArchive

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

Описание

пример

compiler.build.webAppArchive(AppFile) создает архив веб-приложения использование приложения MATLAB®, заданного AppFile.

пример

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

пример

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

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

Примеры

свернуть все

Создайте архив веб-приложения из приложения MATLAB под названием Mortgage.mlapp.

В данном примере компиляция с помощью файла Mortgage.mlapp расположенный в matlabroot\examples\matlab\main.

appFile = fullfile(matlabroot,'examples','matlab','main','Mortgage.mlapp');

Создайте архив веб-приложения использование compiler.build.webAppArchive команда.

compiler.build.webAppArchive(appFile);

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

  • Mortgage.ctf — Файл технологии компонентов, который содержит развертываемый архив.

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

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

  • unresolvedSymbols.txt — Текстовый файл, который содержит информацию о неразрешенных символах.

Для получения информации о развертывании веб-приложений смотрите, Развертывают Веб-приложение.

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

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

compiler.build.webAppArchive('Mortgage.mlapp',...
    'ArchiveName','MyWebApp',...
    'OutputDir','D:\Documents\MATLAB\work\WebApps',...
    'Verbose','on')

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

  • Mortgage.ctf

  • mccExcludedFiles.log

  • requiredMCRProducts.txt

  • unresolvedSymbols.txt

Создайте несколько архивов веб-приложения с помощью compiler.build.WebAppArchiveOptions объект.

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

opts = compiler.build.WebAppArchiveOptions('example1.mlapp',...
    'AdditionalFiles','myvars.mat',...    
    'OutputDir','D:\Documents\MATLAB\work\WebAppBatch',...
    'AutoDetectDataFiles','off',...)
opts = 

  WebAppArchiveOptions with properties:

            ArchiveName: 'example1'
                AppFile: 'D:\Documents\MATLAB\work\example1.mlapp'
        AdditionalFiles: {'D:\Documents\MATLAB\work\myvars.mat'}
    AutoDetectDataFiles: off
              OutputDir: 'D:\Documents\MATLAB\work\WebAppBatch'
                Verbose: off

Создайте архив веб-приложения использование WebAppArchiveOptions объект.

compiler.build.webAppArchive(opts);

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

opts.AppFile = 'example2.m';

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

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

Компиляция с помощью файла Mortgage.mlapp расположенный в matlabroot\examples\matlab\main.

results = compiler.build.webAppArchive('Mortgage.mlapp')
results = 

  Results with properties:

    BuildType: 'webAppArchive'
        Files: {'D:\Documents\MATLAB\work\MortgagewebAppArchive\Mortgage.ctf'}
      Options: [1×1 compiler.build.WebAppArchiveOptions]

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

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

свернуть все

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

Пример: 'mywebapp.mlapp'

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

Опции сборки веб-приложения в виде compiler.build.WebAppArchiveOptions объект.

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

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

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

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

Пример: 'AdditionalFiles',["myvars.mat","myfunc.m"]

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

Имя веб-приложения архивирует в виде вектора символов или строкового скаляра. Значением по умолчанию является имя файла AppFile.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

свернуть все

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

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

  • Путь к скомпилированному архивному файлу веб-приложения

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

Введенный в R2020b