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

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

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

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

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

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

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

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

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

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

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

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

mkdir build
cd build
cmake ..

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

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

cmake --build . --target plugify-module-golang

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

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

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

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

После сборки модуля вы можете интегрировать его в вашу установку 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. Процесс аналогичен, но содержит гораздо больше информации.

Редактировать на GitHub
Импорт функций
Узнайте, как импортировать функции из других плагинов, написанных на разных языках, и использовать их в своем собственном.
Использование классов
Узнайте, как использовать обертки классов для более чистых API плагинов, основанных на объектно-ориентированном программировании, в Go.