compiler.build.standaloneWindowsApplication

Создайте автономное приложение для развертывания вне MATLAB, которое не запускает командный интерпретатор Windows

Описание

пример

Внимание

Эта функция поддерживается только в Windows® операционные системы.

compiler.build.standaloneWindowsApplication(AppFile) создает автономное приложение Windows только с помощью MATLAB® функция, класс или приложение, заданное с помощью AppFile. Приложение не открывает командный интерпретатор Windows при выполнении, и в результате выход консоли не отображается. Сгенерированный исполняемый файл имеет .exe расширение файла и не включает MATLAB Runtime или инсталлятор.

пример

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

пример

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

пример

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

Примеры

свернуть все

Создайте графическое автономное приложение в системе Windows, которая отображает график.

Написание функции MATLAB, которая строит графики значений 1 на 10. Сохраните функцию в файле с именем myPlot.m.

function myPlot()
plot(1:10)

Создайте автономное приложение Windows с помощью compiler.build.standaloneWindowsApplication команда.

compiler.build.standaloneWindowsApplication('myPlot.m');

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

  • myPlot.exe - Исполняемый файл.

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

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

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

  • splash.png - Файл, содержащий изображение брызг, которое отображается при запуске приложения.

  • unresolvedSymbols.txt - Текстовый файл, содержащий нерешенные символы.

Чтобы запустить myPlot.exe, перейдите к myPlotstandaloneApplication папка и дважды кликните myPlot.exe из браузера файлов выполните !myPlot в командном окне MATLAB или выполните myPlot.exe в командном интерпретаторе Windows.

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

Рисунок 1 (myPlot.exe)

Figure 1

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

Создание xVal как вектор линейно разнесенных значений от 0 до 2, Используйте шаг π/40 между значениями. Создание yVal как значения синуса x. Сохраните обе переменные в MAT-файле с именем myVars.mat.

xVal = 0:pi/40:2*pi;
yVal = sin(xVal);
save('myVars.mat','xVal','yVal');

Создайте файл функции с именем myPlot.m чтобы создать линейный график xVal и yVal переменные.

function myPlot()
load('myVars.mat');
plot(xVal,yVal)

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

compiler.build.standaloneWindowsApplication('myPlot.m',...
    'ExecutableName','SineWaveApp',...
    'ExecutableVersion','2.0')

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

  • SineWaveApp.exe

  • mccExcludedFiles.log

  • readme.txt

  • requiredMCRProducts.txt

  • splash.png

  • unresolvedSymbols.txt

Чтобы запустить SineWaveApp.exe, перейдите к myPlotstandaloneApplication папка и дважды кликните SineWaveApp.exe из браузера файлов выполните !SineWaveApp.exe в командном окне MATLAB или выполните SineWaveApp.exe в командной строке Windows.

Приложение отображает изображение брызг, за которым следует фигура MATLAB синусоиды.

Рисунок 1 (SineWaveApp.exe)

Figure 1

Создайте несколько графических автономных приложений в системе Windows с помощью compiler.build.StandaloneApplicationOptions объект.

Написание функции MATLAB, которая строит графики значений 1 на 10. Сохраните функцию в файле с именем myPlot.m.

function myPlot()
plot(1:10)

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

opts = compiler.build.StandaloneApplicationOptions('myPlot.m',...
    'OutputDir','D:\Documents\MATLAB\work\WindowsApps',...
    'Verbose','On')
opts =

  StandaloneApplicationOptions with properties:

            ExecutableName: 'myPlot'
        CustomHelpTextFile: ''
              EmbedArchive: on
            ExecutableIcon: 'C:\Program Files\MATLAB\R2021a\toolbox\compiler\resources\default_icon_48.png'
    ExecutableSplashScreen: 'C:\Program Files\MATLAB\R2021a\toolbox\toolbox\compiler\resources\default_splash.png'
         ExecutableVersion: '1.0.0.0'
                   AppFile: 'myPlot.m'
      TreatInputsAsNumeric: on
           AdditionalFiles: {}
       AutoDetectDataFiles: on
                 OutputDir: 'D:\Documents\MATLAB\work\WindowsApps'
                   Verbose: on

Создайте графическое автономное приложение путем передачи StandaloneApplicationOptions объект как вход в функцию сборки.

compiler.build.standaloneWindowsApplication(opts);

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

opts.AppFile = 'example2.m';
compiler.build.standaloneWindowsApplication(opts);

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

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

Скомпилируйтесь с использованием файловой Mortgage.mlapp расположен в matlabroot\ примеры\matlab\main.

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

  Results with properties:

            BuildType: 'standaloneWindowsApplication'
                Files: {3×1 cell}
              Options: [1×1 compiler.build.StandaloneApplicationOptions]

The Files свойство содержит пути к следующим файлам:

  • Mortgage.exe

  • splash.png

  • readme.txt

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

свернуть все

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

Пример: 'mymagic.m'

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

Автономные опции сборки приложения, заданные как compiler.build.StandaloneApplicationOptions объект.

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

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

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

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

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

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

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

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

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

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

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

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

Пример: 'CustomHelpTextFile','D:\Documents\MATLAB\work\help.txt'

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

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

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

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

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

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

Путь к изображению значка, заданный как вектор символов или строковый скаляр. Это изображение используется в качестве значка для независимого исполняемого файла. Путь может быть относительно текущей рабочей директории или абсолютным. Принятые типы изображений .ico, .jpg, .jpeg, .png, .bmp, и .gif.

Путь по умолчанию:

'matlabroot\toolbox\compiler\resources\default_icon_48.png'

Пример: 'ExecutableIcon','D:\Documents\MATLAB\work\images\myIcon.png'

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

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

Пример: 'ExecutableName','MagicSquare'

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

Путь к изображению заставки, заданный как вектор символов или строковый скаляр. Путь может быть относительно текущей рабочей директории или абсолютным. Принятые типы изображений .jpg, .jpeg, .png, .bmp, и .gif. Размер изображения изменяется до 400 пикселей на 400 пикселей.

Путь по умолчанию:

'matlabroot\toolbox\toolbox\compiler\resources\default_splash.png'

Примечание

Это используется только в приложениях Windows, созданных с использованием compiler.build.standaloneWindowsApplication.

Пример: 'ExecutableSplashScreen','D:\Documents\MATLAB\work\images\mySplash.png'

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

Исполняемая версия, заданная как вектор символов или строковый скаляр.

Примечание

Это используется только в операционных системах Windows.

Пример: 'ExecutableVersion','4.0'

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

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

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

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

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

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

  • Если вы задаете это свойство равным 'on', затем входы командной строки обрабатываются как числа MATLAB с двойной точностью.

  • Если вы задаете это свойство равным 'off'затем входы командной строки обрабатываются как векторы символов MATLAB.

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

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

Флаг для управления подробностями сборки, заданный как '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 объект содержит:

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

  • Пути к следующим файлам:

    • ExecutableName.exe

    • splash.png

    • readme.txt

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

Ограничения

  • Эта функция поддерживается только в операционных системах Windows.

  • Приложение не открывает командный интерпретатор Windows при выполнении, и в результате выход консоли не отображается.

Совет

  • Чтобы создать автономное приложение Windows из системной командной строки с помощью этой функции, используйте matlab функция со -batch опция. Для примера:

    matlab -batch compiler.build.standaloneWindowsApplication('myapp.mlapp')

Введенный в R2020b