Exponenta Banner
exponenta event banner

compiler.build.webAppArchive

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

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

Синтаксис

compiler.build.webAppArchive(AppFile)
compiler.build.webAppArchive(AppFile,Name,Value)
compiler.build.webAppArchive(opts)
results = compiler.build.webAppArchive(___)

Описание

пример

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\ примеры\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\ примеры\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]

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

свернуть все

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

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

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

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

См. также

| |

Темы

Введенный в R2020b

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

Поддержка