compiler.build.webAppArchive

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

Описание

пример

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

пример

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

пример

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

пример

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 в вашей текущей рабочей директории:

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

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

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

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

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

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

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

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

appFile = fullfile(matlabroot,'examples','matlab','main','Mortgage.mlapp');
compiler.build.webAppArchive(appFile, ...
    'ArchiveName','MyWebApp', ...
    'OutputDir','D:\Documents\MATLAB\work\WebApps', ...
    'Verbose','on')

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

  • includedSupportPackages.txt

  • Mortgage.ctf

  • mccExcludedFiles.log

  • requiredMCRProducts.txt

  • unresolvedSymbols.txt

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

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

appFile = fullfile(matlabroot,'examples','matlab','main','Mortgage.mlapp');
opts = compiler.build.WebAppArchiveOptions(appFile, ...
    'OutputDir','D:\Documents\MATLAB\work\WebAppBatch', ...
    'AutoDetectDataFiles','off')
opts = 

  WebAppArchiveOptions with properties:

                AppFile: 'D:\Documents\MATLAB\work\Mortgage.mlapp'
            ArchiveName: 'Mortgage'
        AdditionalFiles: {}
    AutoDetectDataFiles: off
        SupportPackages: {'autodetect'}
                Verbose: off
              OutputDir: 'D:\Documents\MATLAB\work\WebAppBatch'

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

compiler.build.webAppArchive(opts);

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

opts.AppFile = 'ExampleApp2.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'}
IncludedSupportPackages: {}
                Options: [1×1 compiler.build.WebAppArchiveOptions]

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

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

свернуть все

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

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

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

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

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

Задайте дополнительные разделенные запятой пары 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

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

  • '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','On'

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

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

свернуть все

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

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

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

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

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

Введенный в R2020b