Файл XML дополнения

Содержит метаданные Дополнения, описание поддерживаемых форматов и имена команд, которыми Мастер дополнений вызывает <Translator>.exe.

Корневая структура.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Collection>
    <CADTranslators>
        <TranslatorName>Alibre</TranslatorName>
        <TranslatorComposition AddinConnected="-1" ToolbarConnected="-1"/>
        <IsExternal>-1</IsExternal>
        <WantAdmin>0</WantAdmin>
        <Enabled>0</Enabled>
        <HideWinow>-1</HideWinow>
        <TranslatorPath>C:\ProgramData\Название_компании\Название_продукта\Версия_продукта\AddIns\Alibre\AlibreTranslator.exe</TranslatorPath>
        <OutputExtension>IGS</OutputExtension>
        <InputExtensions>AD_PRT.AD_ASM</InputExtensions>
        <CommandLine>$(InFile) $(OutFile)</CommandLine>
        <CommandLineIsAppInst>IsInstalled</CommandLineIsAppInst>
        <CmdLnInstall>Install</CmdLnInstall>
        <CmdLnUnInstall>UnInstall</CmdLnUnInstall>
        <HostApplication>Alibre</HostApplication>
        <DeprecatedHostApplications>
            <Item>GeoMagic</Item>
        </DeprecatedHostApplications>        
        <MinimalVersion>v12</MinimalVersion>
        <CADPlatform>xAny</CADPlatform>
        <Description>
            <Item LangCode="1033">Addin and toolbar for Alibre Design™</Item>
            <Item LangCode="1049">Дополнение и панель инструментов для Alibre Design™</Item>
        </Description>
        <Copyright>Название компании</Copyright>
        <HostCopyright>© Alibre, LLC</HostCopyright>
        <BuildInfo PackageID="" PackageVersion="" BuildNumber=""/>
    </CADTranslators>
</Collection>

Описание тегов. Особое внимание следует обратить на HostApplication — его значение используется Панелью инструментов при передаче геометрии в CAM-систему.

Имя тега	Описание	Значение
`TranslatorName`	Имя Дополнения, отображаемое в списке Мастера дополнений.	—
`TranslatorComposition`	Атрибуты `AddinConnected` и `ToolbarConnected` показывают какие сценарии импорта будут доступны.	`AddinConnected="-1"` — доступен импорт из CAM-системы (см. Импорт CAD-файла в CAM-систему); `ToolbarConnected="-1"` — доступен импорт из CAD-системы (см. Импорт из CAD-системы в CAM-систему).
`IsExternal`	Показывает, что это внешний импортер.	Должен быть равен `-1`.
`WantAdmin`	Показывает, нужно ли запускать установщик с правами администратора.	`0` — False; `-1` — True.
`WantAdminForInstallation`	Показывает, нужны ли права администратора для установки.	`0` — False; `-1` — True.
`Enabled`	Показывает состояние установки приложения.	По умолчанию `0`. Назначается автоматически.
`HideWinow`	Показывает, нужно ли запускать установщик в скрытом режиме.	`0` — False; `-1` — True.
`TranslatorPath`	Путь к исполняемому файлу Транслятора.	По умолчанию пустой. Назначается автоматически.
`OutputExtension`	Формат файла, в который будет конвертирована геометрия CAD-системы.	Указывается расширение (например, `SGF`, `IGS`, `STEP`).
`InputExtensions`	Форматы файлов, которые умеет импортировать Транслятор. При импорте файла CAM-система по этому тегу ищет нужное Дополнение.	Обычно тут указываются родные расширения проектов CAD-системы. Несколько расширений задаются через `.` (например, `CDW.FRW.A3D`).
`CommandLine`	Команда для импорта. Ранее предполагалось, что количество элементов может быть разным, но в итоге остановились на двух.	Должен быть равен `$(InFile) $(OutFile)`.
`CommandLineIsAppInst`	Команда на проверку возможности установки.	Обычно `IsInstalled`.
`CmdLnInstall`	Команда на установку Дополнения.	Обычно `Install`.
`CmdLnUnInstall`	Команда на удаление Дополнения.	Обычно `UnInstall`.
`HostApplication`	Строковый идентификатор CAD-системы. Используется Панелью инструментов при передаче геометрии в CAM-систему — по нему CAM-система находит зарегистрированное Дополнение.	Обычно значение дублируется из тега `TranslatorName`. Главное — должен быть уникальным среди других Дополнений.
`DeprecatedHostApplications`	Старые идентификаторы для обратной совместимости с проектами, созданными в более ранних версиях CAM-системы.	Список `<Item>` с прежними значениями `HostApplication`.
`MinimalVersion`	Минимальная версия CAD-системы, на которую можно установить Дополнение.	Строка свободного формата (например, `v12`, `20+ x64`).
`CADPlatform`	Не используется.	По умолчанию `xAny`.
`Description`	Блок с описанием, отображаемый в окне Мастера дополнений. Разбит на подблоки с `LangCode` (locale, номер кодировки) для отображения на разных языках.	`<Item LangCode="1033">` — EN; `<Item LangCode="1049">` — RU.
`Copyright`	Авторские права владельца Дополнения.	—
`HostCopyright`	Авторские права CAD-системы.	—
`BuildInfo`	Метаданные сборки (атрибуты `PackageID`, `PackageVersion`, `BuildNumber`).	Опционально.