exponenta event banner

compiler.build.standaloneWindowsApplication

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

Описание

пример

Внимание

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

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

пример

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.

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

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

  • 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 аргумент и перекомпиляция, можно скомпилировать несколько приложений, используя один и тот же объект options.

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

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

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

  Results with properties:

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

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. Таким образом, можно использовать значение этого свойства в качестве логического значения. Значение сохраняется как логическое значение типа вкл/выкл 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. Таким образом, можно использовать значение этого свойства в качестве логического значения. Значение сохраняется как логическое значение типа вкл/выкл 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. Таким образом, можно использовать значение этого свойства в качестве логического значения. Значение сохраняется как логическое значение типа вкл/выкл matlab.lang.OnOffSwitchState.

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

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

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

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

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

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

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

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

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

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

свернуть все

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

  • Тип построения, который является 'standaloneApplication

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

    • ExecutableName.exe

    • splash.png

    • readme.txt

  • Параметры построения, указанные как StandaloneApplicationOptions объект

Ограничения

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

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

Совет

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

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

Представлен в R2020b