compiler.build.standaloneApplication

Создайте автономное приложение для развертывания вне MATLAB

Описание

пример

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

пример

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

пример

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

пример

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

Примеры

свернуть все

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

Запишите функцию MATLAB, которая генерирует магический квадрат. Сохраните функцию в файле с именем mymagic.m.

function out = mymagic(in)

if ischar(in)
    in=str2double(in);
end
out = magic(in)

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

compiler.build.standaloneApplication('mymagic.m');

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

  • mymagic.exe или mymagic.sh— Исполняемый файл, который имеет .exe расширение, если скомпилировано в системе Windows® или .sh расширение, если скомпилировано на Linux® или macOS.

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

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

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

Запускать mymagic с входным параметром 4, выполните !mymagic 4 в окне команды MATLAB от mymagicstandaloneApplication папка, mymagic.exe 4 в окне MS-DOS или ./mymagic.sh 4 в Linux или macOS окне терминала.

Приложение выводит 4- 4 магический квадрат.

    16     2     3    13
     5    11    10     8
     9     7     6    12
     4    14    15     1

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

Запишите функцию MATLAB, которая использует подфункцию, чтобы вычислить диагональные компоненты магического квадрата. Сохраните функции в файлы с именем mymagicdiag.m и mydiag.m.

function out = mymagicdiag(in)
X = magic(in);
out = mydiag(X)
function out = mydiag(in)
out = [diag(in)]';

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

compiler.build.standaloneApplication('mymagicdiag.m',...
    'ExecutableName','MagicDiagApp','ExecutableVersion','1.1',...
    'AdditionalFiles','mydiag.m',...
    'TreatInputsAsNumeric','On')

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

  • MagicDiagApp.exe

  • mccExcludedFiles.log

  • readme.txt

  • requiredMCRProducts.txt

Запускать MagicDiagApp.exe с входным параметром 4, выполните !MagicDiagApp.exe 4 в окне команды MATLAB от MagicDiagAppstandaloneApplication папка или выполняет MagicDiagApp.exe 4 в окне MS-DOS.

Приложение выводит диагональные элементы 4- 4 магический квадрат.

    16     11     6    1

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

Запишите функцию MATLAB, которая генерирует магический квадрат. Сохраните функцию в файле с именем mymagic.m.

% mymagic.m
function out = mymagic(in)
out = magic(in)

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

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

  StandaloneApplicationOptions with properties:

            ExecutableName: 'mymagic'
        CustomHelpTextFile: 'D:\Documents\MATLAB\work\helpfile.txt'
              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: 'D:\Documents\MATLAB\work\mymagic.m'
      TreatInputsAsNumeric: off
           AdditionalFiles: {}
       AutoDetectDataFiles: on
                   Verbose: on
                 OutputDir: 'D:\Documents\MATLAB\work\MagicBatch'

Передайте StandaloneApplicationOptions возразите как вход против функции сборки.

compiler.build.standaloneApplication(opts);

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

opts.AppFile = 'mymagic2.m';

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

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

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

results = compiler.build.standaloneApplication('mymagic.m')
results = 

  Results with properties:

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

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

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

свернуть все

Путь к основному файлу раньше создавал приложение в виде вектора символов строки или строкового скаляра. Файлом должна быть функция 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 ложь). Значение '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

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

Примечание

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

Пример: '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 объект.

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