exponenta event banner

compiler.package. InstallerOptions

Параметры создания установщиков пакетов компилятора MATLAB

Описание

пример

opts = compiler.package.InstallerOptions(results) создает значение по умолчанию InstallerOptions объект opts с использованием compiler.build.Results объект results генерируется из compiler.build функция. InstallerOptions объект передается как вход в compiler.package.installer функция.

пример

opts = compiler.package.InstallerOptions(results,Name,Value) создает InstallerOptions объект opts с использованием compiler.build.Results объект results с дополнительными параметрами, заданными с помощью одного или нескольких аргументов «имя-значение». InstallerOptions объект передается как вход в compiler.package.installer функция.

пример

opts = compiler.package.InstallerOptions('ApplicationName',appName) создает значение по умолчанию InstallerOptions объект opts с именем приложения, указанным appName. InstallerOptions объект передается как вход в compiler.package.installer функция.

пример

opts = compiler.package.InstallerOptions('ApplicationName',appName,Name,Value) создает InstallerOptions объект opts с именем приложения, указанным appName и дополнительные настройки, указанные аргументами «имя-значение». InstallerOptions объект передается как вход в compiler.package.installer функция.

Примеры

свернуть все

Создание InstallerOptions с использованием результатов из compiler.build.standaloneApplication и дополнительные параметры, указанные в качестве аргументов «имя-значение».

Для этого примера создайте автономное приложение с помощью файла magicsquare.m расположен в matlabroot\extern\examples\compiler.

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

  Results with properties:

            BuildType: 'standaloneApplication'
                Files: {2×1 cell}
              Options: [1×1 compiler.build.StandaloneApplicationOptions]
opts = compiler.package.InstallerOptions(results,'AuthorName','Frog')
opts = 

  InstallerOptions with properties:

           RuntimeDelivery: 'web'
           InstallerSplash: 'C:\Program Files\MATLAB\R2021a\toolbox\toolbox\compiler\resources\default_splash.png'
             InstallerIcon: 'C:\Program Files\MATLAB\R2021a\toolbox\compiler\resources\default_icon_48.png'
             InstallerLogo: 'C:\Program Files\MATLAB\R2021a\toolbox\compiler\resources\default_logo.png'
                AuthorName: 'Frog'
               AuthorEmail: ''
             AuthorCompany: ''
                   Summary: ''
               Description: ''
         InstallationNotes: ''
                  Shortcut: ''
                   Version: ''
             InstallerName: 'MyAppInstaller'
           ApplicationName: 'magicsquare'
                 OutputDir: '.\magicsquare'
    DefaultInstallationDir: 'C:\Program Files\magicsquare'

Можно изменить значения свойств существующего InstallerOptions с использованием точечной нотации. Например, задайте для имени программы установки значение MyMagicInstaller.

opts.InstallerName = 'MyMagicInstaller'

Чтобы создать программу установки для автономного приложения, используйте Results и InstallerOptions объекты в качестве входных данных для compiler.package.installer функция.

compiler.package.installer(results,'Options',opts);
Функция создает установщик с именем MyMagicInstaller.exe в папке с именем magicsquareinstaller.

Создание InstallerOptions с именем приложения и дополнительными параметрами, указанными в качестве аргументов «имя-значение».

opts = compiler.package.InstallerOptions('ApplicationName','MagicSquare_Generator',...
    'AuthorCompany','Boston Common',...
    'AuthorName','Frog',...
    'InstallerName','MagicSquare_Installer',...
    'Summary','Generates a magic square.')
opts = 

  InstallerOptions with properties:

           RuntimeDelivery: 'web'
           InstallerSplash: 'C:\Program Files\MATLAB\R2021a\toolbox\toolbox\compiler\resources\default_splash.png'
             InstallerIcon: 'C:\Program Files\MATLAB\R2021a\toolbox\compiler\resources\default_icon_48.png'
             InstallerLogo: 'C:\Program Files\MATLAB\R2021a\toolbox\compiler\resources\default_logo.png'
                AuthorName: 'Frog'
               AuthorEmail: ''
             AuthorCompany: 'Boston Common'
                   Summary: 'Generates a magic square.'
               Description: ''
         InstallationNotes: ''
                  Shortcut: ''
                   Version: '1.0'
             InstallerName: 'MagicSquare_Installer'
           ApplicationName: 'MagicSquare_Generator'
                 OutputDir: '.\MagicSquare_Generator'
    DefaultInstallationDir: 'C:\Program Files\MagicSquare_Generator'

Можно изменить значения свойств существующего InstallerOptions с использованием точечной нотации. Например, задайте для примечаний по установке значение Windows installer.

opts.InstallationNotes = 'Windows installer'

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

свернуть все

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

Имя установленного приложения, указанное как вектор символов или скаляр строки.

Пример: 'MagicSquare_Generator'

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

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

Укажите дополнительные пары, разделенные запятыми Name,Value аргументы. Name является именем аргумента и Value - соответствующее значение. Name должен отображаться внутри кавычек. Можно указать несколько аргументов пары имен и значений в любом порядке как Name1,Value1,...,NameN,ValueN.

Пример: 'Version','9.5' указывает версию установленного приложения.

Имя установленного приложения, указанное как вектор символов или скаляр строки.

Пример: 'MagicSquare_Generator'

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

Имя компании, создавшей приложение, указанное как вектор символов или строковый скаляр.

Пример: 'Boston Common'

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

Адрес электронной почты автора приложения, указанный как вектор символов или скаляр строки.

Пример: 'frog@bostoncommon.com'

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

Имя автора приложения, указанное как вектор символов или скаляр строки.

Пример: 'Frog'

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

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

Если путь не указан, путь по умолчанию для каждой операционной системы:

Операционная системаКаталог установки по умолчанию
Windows ®C:\Program Files\appName
Linux ®/usr/appName
macOS/Applications/appName

Пример: В Windows: C:\Program Files\MagicSquare_Generator

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

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

Пример: 'The MagicSquare_Generator application generates an n-by-n matrix constructed from the integers 1 through n2 with equal row and column sums.'

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

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

Пример: 'This is a Linux installer.'

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

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

Путь по умолчанию:

'matlabroot\toolbox\compiler\resources\default_icon_48.png'

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

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

Путь по умолчанию:

'matlabroot\toolbox\compiler\resources\default_logo.png'

Пример: 'D:\Documents\MATLAB\work\images\myLogo.png'

Имя файла установщика, указанное как вектор символов или скаляр строки. Расширение определяется операционной системой, в которой выполняется функция.

Пример: 'MagicSquare_Installer'

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

Путь по умолчанию:

'matlabroot\toolbox\toolbox\compiler\resources\default_splash.png'

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

Путь к папке, в которой сохраняется программа установки, указанный как вектор символов или скаляр строки.

Если путь не указан, путь по умолчанию для каждой операционной системы:

Операционная системаКаталог установки по умолчанию
Windows.\appNameinstaller
Linux./appNameinstaller
macOS./appNameinstaller

. в указанных выше каталогах представляет текущий рабочий каталог.

Пример: 'D:\Documents\MATLAB\work\MagicSquare'

Выбор способа доступности среды выполнения MATLAB для установленного приложения.

  • 'web'- Возможность загрузки программы установки MATLAB Runtime с веб-сайта MathWorks ® во время установки приложения. Это параметр по умолчанию.

  • 'installer'- Возможность включения среды выполнения MATLAB в программу установки, чтобы ее можно было установить во время установки приложения без подключения к веб-сайту MathWorks. Используйте этот параметр, если вы считаете, что ваш конечный пользователь может не иметь доступа к Интернету.

Пример: 'installer'

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

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

Пример: '.\mymagic.exe'

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

Краткое описание приложения, указанное как символьный вектор или строковый скаляр.

Пример: 'Generates a magic square.'

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

Номер версии установленного приложения, указанный как символьный вектор или строковый скаляр.

Пример: '2.0'

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

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

свернуть все

Параметры установщика, возвращенные как InstallerOptions объект.

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