compiler.build.standaloneWindowsApplication

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

Описание

пример

Внимание

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

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

пример

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

пример

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

пример

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.

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

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

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

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

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

Figure 1

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

Создайте 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(1:10)

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

compiler.build.standaloneWindowsApplication('myPlot.m',...
    'AutoDetectDataFiles','On',...
    'ExecutableName','SineWaveApp')

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

  • SineWaveApp.exe

  • mccExcludedFiles.log

  • readme.txt

  • requiredMCRProducts.txt

  • splash.png

Запускать SineWaveApp.exe, дважды кликните SineWaveApp.exe от файлового браузера выполните !SineWaveAppstandaloneApplication\SineWaveApp.exe в окне команды MATLAB, или выполняют SineWaveApp.exe в командной строке Windows.

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

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

Figure 1

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

Запишите функцию 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\R2020b\toolbox\compiler\resources\default_icon_48.png'
    ExecutableSplashScreen: 'C:\Program Files\MATLAB\R2020b\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);

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

opts.AppFile = 'myPlot2.m';

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

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

Сохраните compiler.build.standaloneWindowsApplication информация к Results объект путем объявления выходной переменной.

results = compiler.build.standaloneWindowsApplication('mymagic.m','AdditionalFiles',["myvars.mat","mysubfunction.m"])
results = 

  Results with properties:

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

Files свойство содержит пути к сгенерированному независимому исполняемому файлу, изображению всплеска и readme файлам.

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

свернуть все

Путь к основному файлу раньше создавал приложение в виде вектора символов строки или строкового скаляра. Файлом должна быть функция MATLAB, класс или приложение одного из следующих типов: .mP, .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 ложь). Значение 'on' эквивалентно true, и 'off' эквивалентно false. Таким образом можно использовать значение этого свойства как логическое значение. Значение хранится как логическое значение включения - выключения типа matlab.lang.OnOffSwitchState.

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

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

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

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

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

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

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

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

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

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

Примечание

Это свойство проигнорировано для библиотек Java.

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

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

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

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

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

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

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

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

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

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

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

Выполняемая версия в виде вектора символов или строкового скаляра.

Примечание

Это используется только в системах Windowsoperating.

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

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

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

Если никакой путь не задан, папка сборки под названием ExecutableNamestandaloneApplication создается в текущей рабочей директории.

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

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

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

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

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

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

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

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

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

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

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

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

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

свернуть все

Создайте результаты, возвращенные как compiler.build.Results объект. Results объект содержит тип сборки, пути к скомпилированным файлам и опции сборки в виде StandaloneApplicationOptions объект.

Ограничения

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

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

Введенный в R2020b
Для просмотра документации необходимо авторизоваться на сайте