compiler.build.JavaPackageOptions

Опции для создания пакетов Java

Описание

пример

opts = compiler.build.JavaPackageOptions(Files) создает JavaPackageOptions объект с помощью MATLAB® функции заданы Files. Используйте JavaPackageOptions возразите как вход против compiler.build.javaPackage функция.

пример

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

пример

opts = compiler.build.JavaPackageOptions(ClassMap) создает JavaPackageOptions объект с классом, сопоставляющим заданное использование container.Map объект ClassMap.

пример

opts = compiler.build.JavaPackageOptions(ClassMap,Name,Value) создает JavaPackageOptions объект с классом, сопоставляющим заданное использование ClassMap и опции задали использование одних или нескольких аргументов name-value.

Примеры

свернуть все

Создайте JavaPackageOptions объект с помощью файла вводится.

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

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

  JavaPackageOptions with properties:

                 ClassMap: [1×1 containers.Map]
               DebugBuild: off
              PackageName: 'example.magicsquare'
    SampleGenerationFiles: {}
          AdditionalFiles: {}
      AutoDetectDataFiles: on
        SupportPackages: {'autodetect'}
                  Verbose: off
                OutputDir: '.\magicsquarejavaPackage'

   Class Map Information
         magicsquareClass: {'C:\Program Files\MATLAB\R2021b\extern\examples\compiler'}

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

opts.Verbose = 'on'
opts = 

  JavaPackageOptions with properties:

                 ClassMap: [1×1 containers.Map]
               DebugBuild: off
              PackageName: 'example.magicsquare'
    SampleGenerationFiles: {}
          AdditionalFiles: {}
      AutoDetectDataFiles: on
        SupportPackages: {'autodetect'}
                  Verbose: on
                OutputDir: '.\magicsquarejavaPackage'

   Class Map Information
         magicsquareClass: {'C:\Program Files\MATLAB\R2021b\extern\examples\compiler'}

Используйте JavaPackageOptions возразите как вход против compiler.build.javaPackage функционируйте, чтобы создать Java® пакет.

buildResults = compiler.build.javaPackage(opts);

Создайте JavaPackageOptions возразите и настройте его с помощью аргументов name-value.

В данном примере используйте файл magicsquare.m расположенный в matlabroot\extern\examples\compiler. Используйте аргументы name-value, чтобы задать выходную директорию и отключить автоматическое обнаружение файлов данных.

appFile = fullfile(matlabroot,'extern','examples','compiler','magicsquare.m');
opts = compiler.build.JavaPackageOptions(appFile,...
    'OutputDir','D:\Documents\MATLAB\work\MagicJavaPackage',...
    'AutoDetectDataFiles','off')
opts = 

  JavaPackageOptions with properties:

                 ClassMap: [1×1 containers.Map]
               DebugBuild: off
              PackageName: 'example.magicsquare'
    SampleGenerationFiles: {}
          AdditionalFiles: {}
      AutoDetectDataFiles: off
        SupportPackages: {'autodetect'}
                  Verbose: off
                OutputDir: 'D:\Documents\MATLAB\work\MagicJavaPackage'

   Class Map Information
         magicsquareClass: {'C:\Program Files\MATLAB\R2021b\extern\examples\compiler'}

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

opts.Verbose = 'on'
opts = 

  JavaPackageOptions with properties:

                 ClassMap: [1×1 containers.Map]
               DebugBuild: off
              PackageName: 'example.magicsquare'
    SampleGenerationFiles: {}
          AdditionalFiles: {}
      AutoDetectDataFiles: off
        SupportPackages: {'autodetect'}
                  Verbose: on
                OutputDir: 'D:\Documents\MATLAB\work\MagicJavaPackage'

   Class Map Information
         magicsquareClass: {'C:\Program Files\MATLAB\R2021b\extern\examples\compiler'}

Используйте JavaPackageOptions возразите как вход против compiler.build.javaPackage функционируйте, чтобы создать пакет Java.

buildResults = compiler.build.javaPackage(opts);

Создайте JavaPackageOptions объект с помощью карты класса.

Создайте containers.Map возразите, чьи ключи являются именами классов и чьи значения являются файлами функции MATLAB.

cmap = containers.Map;
cmap('Class1') = {'exampleFcn1.m','exampleFcn2.m'};
cmap('Class2') = {'exampleFcn3.m','exampleFcn4.m'};

Создайте JavaPackageOptions объект с помощью класса сопоставляет cmap.

opts = compiler.build.JavaPackageOptions(cmap)
opts = 

  JavaPackageOptions with properties:

                 ClassMap: [1×1 containers.Map]
               DebugBuild: off
              PackageName: 'example.magicsquare'
    SampleGenerationFiles: {}
          AdditionalFiles: {}
      AutoDetectDataFiles: on
        SupportPackages: {'autodetect'}
                  Verbose: off
                OutputDir: '.\magicsquarejavaPackage'

  Class Map Information
                   Class1: {2×1 cell}
                   Class2: {2×1 cell}

Можно также создать JavaPackageOptions объект с помощью аргументов name-value или изменяет существующий объект с помощью записи через точку. В данном примере задайте выходную директорию, включите многословный выход и отключите автоматическое обнаружение файлов данных.

opts = compiler.build.JavaPackageOptions(cmap,...
    'OutputDir','D:\Documents\MATLAB\work\MagicJavaPackage',...
    'Verbose','On');
opts.AutoDetectDataFiles = 'off';
opts = 

  JavaPackageOptions with properties:

                 ClassMap: [1×1 containers.Map]
               DebugBuild: off
              PackageName: 'example.magicsquare'
    SampleGenerationFiles: {}
          AdditionalFiles: {}
      AutoDetectDataFiles: off
          SupportPackages: {'autodetect'}
                  Verbose: on
                OutputDir: 'D:\Documents\MATLAB\work\MagicJavaPackage'

  Class Map Information
                   Class1: {2×1 cell}
                   Class2: {2×1 cell}

Используйте JavaPackageOptions возразите как вход против compiler.build.javaPackage функционируйте, чтобы создать пакет Java.

buildResults = compiler.build.javaPackage(opts);

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

свернуть все

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

Пример: ["myfunc1.m","myfunc2.m"]

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

Карта класса в виде containers.Map объект. Ключи карты являются именами классов, и каждое значение является набором файлов, сопоставленных с соответствующим классом. Файлы должны иметь .m расширение.

Пример: cmap

Аргументы name-value

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

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

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

Пример: 'AdditionalFiles',["myvars.mat","data.txt"]

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

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

  • Если вы устанавливаете это свойство на 'on', затем файлы данных, которые вы предоставляете как входные параметры определенным функциям (такой как load и fopen) автоматически включены в пакет Java.

  • Если вы устанавливаете это свойство на 'off', затем необходимо добавить файлы данных в пакет с помощью AdditionalFiles свойство.

Пример: 'AutoDetectDataFiles','off'

Типы данных: логический

Имя класса Java в виде вектора символов или строкового скаляра. Вы не можете задать эту опцию, если вы используете ClassMap входной параметр. Имена классов должны удовлетворить требования имени класса Java.

Значением по умолчанию является имя первого файла, перечисленного в Files аргумент добавлен с Class.

Пример: 'ClassName','magicsquareClass'

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

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

  • Если вы устанавливаете это свойство на 'on', затем скомпилированный пакет содержит отладочные символы.

  • Если вы устанавливаете это свойство на 'off', затем скомпилированный пакет не содержит отладочные символы.

Пример: 'DebugBuild','on'

Типы данных: логический

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

Имя по умолчанию папки сборки является именем пакета, добавленным с javaPackage.

Пример: 'OutputDir','D:\Documents\MATLAB\work\mymagicjavaPackage'

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

Имя пакета Java в виде вектора символов или строкового скаляра. Задайте 'PackageName' как пространство имен, которое является разделенным от периода списком, таким как companyname.groupname.component. Имя сгенерированного пакета определяется к последней записи разделенного от периода списка. Имя должно начаться с буквы и содержать только буквенные символы и периоды.

Пример: 'PackageName','mathworks.javapackage.mymagic'

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

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

Пример: 'SampleGenerationFiles',["sample1.m","sample2.m"]

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

Пакеты поддержки, чтобы включать в виде одной из следующих опций:

  • 'autodetect' (значение по умолчанию) — Процесс анализа зависимостей обнаруживает и включает необходимые пакеты поддержки автоматически.

  • 'none' — Никакие пакеты поддержки не включены. Используя эту опцию может вызвать ошибки периода выполнения.

  • Строковый скаляр, вектор символов или массив ячеек из символьных векторов — Только заданные пакеты поддержки включены. Чтобы перечислить установленные пакеты поддержки или используемых определенным файлом, смотрите compiler.codetools.deployableSupportPackages.

.

Пример: 'SupportPackages',{'Deep Learning Toolbox Converter for TensorFlow Models','Deep Learning Toolbox Model for Places365-GoogLeNet Network'}

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

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

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

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

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

Типы данных: логический

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

свернуть все

Пакет Java создает опции, возвращенные как JavaPackageOptions объект.

Смотрите также

Введенный в R2021a