Exponenta Banner
exponenta event banner

compiler.build. StandaloneApplicationOptions

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

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

Синтаксис

opts = compiler.build.StandaloneStartOptions (AppFile)
opts = compiler.build.standalObjectOptions (AppFile, Name, Value)

Описание

пример

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\examples\compiler.

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

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

свернуть все

Параметры построения автономного приложения, возвращенные в виде StandaloneApplictionOptions объект.

См. также

| | |

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

Документация по компилятору MATLAB

Поддержка