Сборка модуля

Подробные инструкции по сборке и упаковке языкового модуля C++.

Языковой модуль C++ (plugify-module-cpp) является основным компонентом Plugify, который обеспечивает создание и управление плагинами на C++. Это руководство проведет вас через процесс сборки модуля из исходного кода.

Предварительные требования

Перед сборкой языкового модуля C++ убедитесь, что у вас установлено следующее:

  • CMake (версия 3.14 или новее)
  • Компилятор C++ с поддержкой C++23. Релизы собираются:
    • GCC 14 (Linux)
    • MSVC 2022 (Windows)
    • Apple Clang (macOS)
  • Git: ядро Plugify подключено к репозиторию сабмодулем, поэтому клонируйте его с --recursive. Отдельно собирать ядро не нужно.

Шаги по сборке языкового модуля C++

Клонируйте репозиторий

Клонируйте репозиторий plugify-module-cpp на ваш локальный компьютер:

git clone https://github.com/untrustedmodders/plugify-module-cpp.git --recursive
cd plugify-module-cpp

Сгенерируйте файлы сборки

Создайте каталог build и сгенерируйте файлы сборки с помощью CMake:

mkdir build
cd build
cmake ..

Соберите модуль

Соберите модуль, используя следующую команду. Имя цели - plugify-module-cpp.

cmake --build . --target plugify-module-cpp

Проверьте сборку

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

  • plugify-module-cpp.dll (Windows)
  • libplugify-module-cpp.so (Linux)
  • libplugify-module-cpp.dylib (macOS)

Интеграция языкового модуля C++

После сборки модуля вы можете интегрировать его в вашу установку Plugify:

  1. Установите релизный пакет модуля, как описано в разделе Установка. В нём есть манифест и файлы рантайма, которые нужны модулю.
  2. Замените библиотеку в его папке bin на собранную из папки build.
  3. Выполните plg load и проверьте, что plg modules показывает модуль.

Устранение неполадок

Распространенные проблемы

  1. Сборка не удалась:
    • Убедитесь, что у вас установлена правильная версия CMake и совместимый компилятор C++.
    • Проверьте, что сабмодули склонированы: git submodule update --init --recursive.
  2. Модуль не загружается:
    • Убедитесь, что файл модуля помещен в правильный каталог (envs).
    • Проверьте логи Plugify на наличие ошибок, связанных с загрузкой модуля.
  3. Отсутствующие символы:
    • Собирайте модуль из релизного тега, чтобы встроенное ядро совпадало с версией Plugify, которую вы запускаете.

Расширенная конфигурация

Для получения более подробных инструкций по сборке языковых модулей (например, настройка опций CMake, включение тестов или сборка документации) обратитесь к руководству Сборка Plugify. Процесс аналогичен, но содержит гораздо больше информации.