Урок 3 — подключение SDK к проекту C++ через систему сборки

Цели

• Создать простое работающее расширение на C++;
• Подключить SDK к проекту C++ через систему сборки.

Практическая часть

Порядок действий:

• Откройте репозиторий GitVerse и клонируйте его.
• Найдите каталог ExtensionEmptyCpp — он послужит основой нового расширения.
• Обратите внимание на следующие настройки:
  • ExtensionEmptyCpp/.stbuild/build/stbuild.csproj — версия системы сборки. Для доступа к новым возможностям системы сборки может потребоваться её обновление.
  • ExtensionEmptyCpp/.stbuild/build/build.cs:
    • Свойства RestorerNugetProps, где указана версия SprutTechnology.CAMAPI.SDK.tlb;
    • Свойства BuilderMsCppProps, где указан путь к MSBuild.exe. Используется версия из Microsoft Visual Studio;
  • ExtensionEmptyCpp\project\main\ExtensionEmptyCpp.settings.json — подпись пункта меню, подсказка и путь к значку относительно DLL;
• При необходимости измените main.cpp. Вы можете использовать API без ограничений; пример упрощён, чтобы показать общий процесс создания расширения.
• Для выполнения кода проект должен экспортировать функцию CreateInstanceOfExtension. Она принимает значение id из ExtensionEmptyCpp.settings.json и возвращает ссылку на созданный объект.
• Соберите проект, чтобы проверить его работоспособность.
• Создайте файл установки расширения с помощью команды ExtensionEmptyCpp/commands/pack.cmd;
• При успешной упаковке появится файл ExtensionEmptyCpp/project/main/x64/Release/ExtensionEmptyCpp.dext. Его можно установить на этом или другом компьютере с соответствующей версией CAM-системы.
• Дважды щёлкните файл, чтобы установить расширение.
• Запустите CAM-систему, откройте меню утилит и выберите Empty extension on C++. Название пункта должно соответствовать значению caption в JSON.
• Убедитесь, что открылся Блокнот со сведениями о проекте.