compiler.build.StandaloneApplicationOptions

Опции для создания автономных приложений

Описание

пример

opts = compiler.build.StandaloneApplicationOptions(AppFile) создает объект автономных опций приложения по умолчанию с помощью MATLAB® функция, класс или приложение, заданное с помощью AppFile. Используйте StandaloneApplicationOptions объект как вход в compiler.build.standaloneApplication и compiler.build.standaloneWindowsApplication функций.

пример

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

Примеры

свернуть все

Создайте StandaloneApplicationOptions объект с использованием ввода файла.

В данном примере используйте файл magicsquare.m расположен в matlabroot\ extern\примеры\компилятор.

appFile = fullfile(matlabroot,'extern','examples','compiler','magicsquare.m');
opts = compiler.build.StandaloneApplicationOptions(appFile)
opts =

  StandaloneApplicationOptions with properties:

        CustomHelpTextFile: ''
              EmbedArchive: on
            ExecutableIcon: 'C:\Program Files\MATLAB\R2021a\toolbox\compiler\resources\default_icon_48.png'
            ExecutableName: 'magicsquare'
    ExecutableSplashScreen: 'C:\Program Files\MATLAB\R2021a\toolbox\toolbox\compiler\resources\default_splash.png'
         ExecutableVersion: '1.0.0.0'
                   AppFile: 'C:\Program Files\MATLAB\R2021a\extern\examples\compiler\magicsquare.m'
      TreatInputsAsNumeric: off
           AdditionalFiles: {}
       AutoDetectDataFiles: on
                   Verbose: off
                 OutputDir: '.\magicsquarestandaloneApplication'

Можно изменять значения свойств существующей StandaloneApplictionOptions объект с использованием записи через точку. Для примера включите подробные выходы.

opts.Verbose = 'on'
opts =

  StandaloneApplicationOptions with properties:

        CustomHelpTextFile: ''
              EmbedArchive: on
            ExecutableIcon: 'C:\Program Files\MATLAB\R2021a\toolbox\compiler\resources\default_icon_48.png'
            ExecutableName: 'magicsquare'
    ExecutableSplashScreen: 'C:\Program Files\MATLAB\R2021a\toolbox\toolbox\compiler\resources\default_splash.png'
         ExecutableVersion: '1.0.0.0'
                   AppFile: 'C:\Program Files\MATLAB\R2021a\extern\examples\compiler\magicsquare.m'
      TreatInputsAsNumeric: off
           AdditionalFiles: {}
       AutoDetectDataFiles: on
                   Verbose: on
                 OutputDir: '.\magicsquarestandaloneApplication'

Используйте StandaloneApplicationOptions объект как вход в compiler.build.standaloneApplication функция для создания автономного приложения.

compiler.build.standaloneApplication(opts);

Создайте StandaloneApplictionOptions объект и настройте его с помощью аргументов имя-значение.

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

opts = compiler.build.StandaloneApplicationOptions('mymagic.m',...
    'OutputDir','D:\Documents\MATLAB\work\MagicApp',...
    'ExecutableIcon','D:\Documents\MATLAB\work\images\magicicon.png',...
    'ExecutableVersion','2.0',...
    'TreatInputsAsNumeric','On')
opts =

  StandaloneApplicationOptions with properties:

        CustomHelpTextFile: ''
              EmbedArchive: on
            ExecutableIcon: 'D:\Documents\MATLAB\work\images\magicicon.png'
            ExecutableName: 'mymagic'
    ExecutableSplashScreen: 'C:\Program Files\MATLAB\R2021a\toolbox\toolbox\compiler\resources\default_splash.png'
         ExecutableVersion: '2.0'
                   AppFile: 'D:\Documents\MATLAB\work\mymagic.m'
      TreatInputsAsNumeric: on
           AdditionalFiles: {}
       AutoDetectDataFiles: on
                   Verbose: off
                 OutputDir: 'D:\Documents\MATLAB\work\MagicApp'

Можно изменять значения свойств существующей StandaloneApplictionOptions объект с использованием записи через точку. Для примера включите подробные выходы.

opts.Verbose = 'on'
opts =

  StandaloneApplicationOptions with properties:


        CustomHelpTextFile: ''
              EmbedArchive: on
            ExecutableIcon: 'D:\Documents\MATLAB\work\images\magicicon.png'
            ExecutableName: 'mymagic'
    ExecutableSplashScreen: 'C:\Program Files\MATLAB\R2021a\toolbox\toolbox\compiler\resources\default_splash.png'
         ExecutableVersion: '2.0'
                   AppFile: 'D:\Documents\MATLAB\work\mymagic.m'
      TreatInputsAsNumeric: on
           AdditionalFiles: {}
       AutoDetectDataFiles: on
                   Verbose: on
                 OutputDir: 'D:\Documents\MATLAB\work\MagicApp'

Используйте StandaloneApplicationOptions объект как вход в compiler.build.standaloneApplication функция для создания автономного приложения.

compiler.build.standaloneApplication(opts);

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

свернуть все

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

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

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

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

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

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

свернуть все

Автономные опции сборки приложений, возвращенные как StandaloneApplictionOptions объект.

Введенный в R2020b