Сборка и публикация
📦 Сборка вашего аддона
Чтобы скомпилировать ваш аддон в JAR-файл, который можно установить на сервер Pano:
- Откройте терминал в корневой папке проекта.
- Запустите команду сборки:bash
./gradlew build - Скомпилированный плагин будет находиться в:
build/libs/your-plugin-id-version.jar
TIP
Если вы используете внешние зависимости, не предоставляемые Pano, убедитесь, что вы используете задачу shadowJar для их упаковки.
🚀 Публикация
Версионирование
Перед сборкой убедитесь, что в файле gradle.properties указан правильный номер версии.
Распространение
В настоящее время аддоны Pano распространяются через:
- GitHub Releases
- Официальный маркетплейс Pano
Чтобы выпустить релиз на GitHub:
- Создайте тег для вашего коммита.
- Создайте новый Release.
- Загрузите JAR-файл из
build/libs.
🤖 Автоматизация
Вы можете автоматизировать процесс сборки и выпуска с помощью GitHub Actions.
GitHub Actions
Pano Boilerplate Plugin поставляется с предварительно настроенным файлом .github/workflows/release.yml. Этот рабочий процесс автоматически собирает ваш плагин и создает релиз.
Pano Deploy API Token
Чтобы автоматизировать развертывание в Pano Marketplace, вам понадобится Pano Deploy API Token.
- Войдите на веб-сайт Pano.
- Перейдите в Профиль -> Настройки -> API Tokens.
- Нажмите Создать, чтобы сгенерировать новый токен.
ВАЖНО
Токен API будет показан только один раз в модальном окне сразу после создания. Храните этот токен в безопасном месте, например, в GitHub Secrets или переменных окружения. Никогда не публикуйте его в общедоступном репозитории.
Semantic Releases
Развертывание осуществляется с помощью Semantic Releases. Вы можете ознакомиться с репозиторием Pano Plugin Pages для реального примера того, как настроить .releaserc.json для развертывания.
Пример конфигурации использует плагин @PanoMC/semantic-release-pano для обработки загрузки в Pano.