Студия плагинов в кабинете

Открыть студию

1. Войдите в личный кабинет сайта под своим аккаунтом. Для первого входа подтвердите почту; при требовании смены стартового пароля завершите её в разделе безопасности.
2. Выберите «Студия плагинов» в боковой навигации. На телефоне раздел отмечен значком кода.
3. Нажмите «Новый плагин» или откройте сохранённый проект из списка. Поиск фильтрует названия ваших проектов.
4. Проект принадлежит текущему аккаунту. Ссылка на страницу редактора не открывает доступ другому пользователю и не публикует исходники в магазине.

Выбрать заготовку

1. Задайте понятное название, например «Контроль температуры». Его можно изменить позднее, независимо от ID пакета.
2. Введите собственный ID вида io.example.temperature: строчные латинские буквы, цифры и разделители точки или дефисы. Для настоящего продукта используйте пространство имён, которым управляете.
3. Выберите «Подписка USEPI» для обработки событий источника и публикации числового результата. В стартовой логике результат равен input * scale + offset.
4. Выберите «Жизненный цикл» для минимального процесса без разрешений на данные. Он подключается к менеджеру, сообщает готовность и корректно завершается по сигналу остановки.
5. Нажмите «Создать». Проект сохраняется в кабинете, а редактор открывает src/main.rs. Вставлять ключи, пароли оборудования или реальные секреты в исходники не нужно.

Рабочее место автора

Слева находится дерево файлов, сверху открытые вкладки, в центре редактор с подсветкой Rust, JSON, TOML и Markdown. Нижняя панель показывает предварительные ошибки структуры. Строка состояния содержит позицию курсора, кодировку и размер шрифта.

1. Выберите файл в дереве. Переключение вкладок сохраняет текст; закрытие вкладки не удаляет сам файл.
2. Раскрывайте папки стрелками. Значок панели в начале вкладок скрывает дерево, освобождая место для кода, в том числе на телефоне.
3. Используйте обычное редактирование, выделение, отмену и повтор. Поиск в открытом файле доступен через Ctrl+F или Cmd+F.
4. Поменяйте размер шрифта внизу редактора. Длинные строки прокручиваются внутри области кода, а не растягивают всю страницу.
5. Наведите указатель на значок действия: подсказка показывает назначение. Действия над текущим файлом находятся справа над кодом; действия над всем проектом расположены в верхней панели.

Какие файлы менять

В редакторе показан ваш crate плагина. После экспорта эти файлы находятся в starter/, а публичные библиотеки SDK лежат рядом в crates/. Если добавляете модуль src/processing.rs, подключите его из Rust-кода через mod processing; наличие файла само по себе не включает модуль в сборку.

Добавить, переименовать и удалить файл

1. Нажмите значок файла с плюсом над деревом. Введите относительный путь, например src/processing.rs или tests/transform.rs.
2. Для переименования откройте файл и нажмите значок карандаша над кодом. Новое имя не может совпадать с существующим путём, в том числе при отличии только регистра.
3. Не используйте абсолютные пути, .., обратные слеши, каталоги .git, target или node_modules. Файл и папка не могут занимать один путь.
4. Для удаления откройте файл, нажмите корзину над редактором и подтвердите. Последний файл проекта удалить нельзя. Удаление обязательного файла отмечается в проверке структуры.
5. Для JSON и TOML доступно форматирование значком волшебной палочки. Сначала исправьте синтаксис; при ошибке форматирование не заменяет ваш текст.

Сохранение без потери новых правок

После паузы в редактировании студия автоматически отправляет изменения. Кнопка сохранения или Ctrl+S / Cmd+S позволяет отправить их сразу. Надпись «Сохранено» появляется только после ответа сервера. Экспорт скачивает текущий текст, включая ещё не подтверждённые изменения.

1. Дождитесь «Сохранено», прежде чем закрывать вкладку или переходить к другому проекту.
2. Если отображается «Не сохранено», проверьте сообщение и соединение. При неопределённом результате нажмите «Повторить»: студия повторит тот же запрос, не создавая дубликат.
3. Можно продолжать печатать во время отправки. Запоздалое подтверждение не заменяет новые правки старой копией; последующие изменения отправляются отдельно.
4. После исправления слишком большого или некорректного файла повторите сохранение. Студия не устраивает непрерывный цикл повторов при ошибке.
5. Для возврата позднее откройте проект в том же аккаунте. В браузерном localStorage исходники не хранятся; подтверждённая версия находится на сервере.

Если проект открыт в двух вкладках

1. Сохранение проверяет версию проекта. Только одна из конкурирующих записей принимается; другая вкладка показывает конфликт.
2. Не обновляйте страницу сразу, если в ней есть нужные изменения. Сначала скачайте текущие исходники или нажмите «Сохранить копию».
3. Чтобы принять серверную версию, выберите «Загрузить актуальную» и подтвердите отказ от локальных несохранённых правок.
4. Сверьте версии и перенесите необходимые изменения вручную. Совместного редактирования и автоматического слияния в студии пока нет.

Что проверяется в браузере

Предварительная проверка обнаруживает непереносимые и конфликтующие пути, превышение лимитов, ошибки JSON/TOML, отсутствие основных файлов, неверный plugin.id, расхождение версий и базовые требования к корневой схеме конфигурации. Выбор сообщения открывает соответствующий файл, если он существует.

Проверить, протестировать и собрать

Задания доступны только владельцу проекта и выполняются в отдельной изолированной среде с ограничениями ресурсов, без доступа к оборудованию и сети. Это не процесс веб-сервера и не ваш рабочий экземпляр плагина.

Сборочная среда работает offline и использует подготовленные зависимости SDK/заготовки. Произвольная новая зависимость, Git-репозиторий или скачивание из build script могут быть недоступны. Для собственного набора зависимостей экспортируйте исходники и используйте локальную сборку; не включайте токены реестров в проект.

1. Сначала дождитесь подтверждённого сохранения проекта. Задание относится к неизменяемому снимку конкретной сохранённой версии.
2. Нажмите нужную кнопку и следите за состоянием очереди, журналом и итогом задания.
3. Можно продолжать редактирование: результат старого задания не подтверждает новые несохранённые правки. После изменений запустите проверку новой версии.
4. Отмените ненужное задание. При ошибке прочитайте журнал, исправьте источник проблемы и создайте новое задание.
5. Скачайте готовый артефакт в течение 24 часов. Если срок хранения истёк, соберите его снова.
6. Перед рабочим использованием установите BTP на отдельный совместимый стенд и выполните проверку запуска, данных и остановки.

Зависимости удалённой сборки

Сборочная среда использует публичный SDK 1.2.1 и зафиксированный набор vendored-зависимостей. Прямые зависимости заготовки: bluetraktor-plugin-sdk, serde с derive, serde_json и tokio; в тестах также toml и tokio/test-util. Транзитивные зависимости не скачиваются для каждого задания. Перед проверкой среда создаёт Cargo.lock через cargo generate-lockfile --offline только из подготовленного набора, затем компилирует с --frozen.

В Cargo.toml сохраняйте package.name = community-starter и путь SDK ../crates/bluetraktor-plugin-sdk. Собственное имя продукта задаётся plugin.id в manifest, а не переименованием исполняемого файла заготовки. Версию плагина можно менять, но она должна совпадать в Cargo.toml и package/plugin.toml. Новые crates, неподдержанные версии и git-зависимости требуют локальной сборки либо отдельного обновления поддержанного набора.

«Проверить» компилирует все цели, включая тесты, для x86_64-unknown-linux-musl, но не выполняет их. «Тесты» запускает тесты вашего проекта на x86_64-unknown-linux-gnu; обе команды включают bluetraktor-plugin-sdk/test-host. Это не запуск всех тестов библиотеки SDK: добавьте собственные проверки, потому что проект может содержать ноль тестов.

Ниже показаны основные команды внутри подготовленной среды студии, не универсальная инструкция для запуска на macOS. «Собрать BTP» отдельно создаёт static musl-пакет. Успешные GNU-тесты не доказывают работу этого бинарника на целевой установке. Не рассчитывайте на доступ к HTTP, MQTT, файлам сервера или реальному менеджеру во время теста.

cargo generate-lockfile --offline --manifest-path starter/Cargo.toml
cargo check --frozen --jobs 1 --manifest-path starter/Cargo.toml --target x86_64-unknown-linux-musl --all-targets --features bluetraktor-plugin-sdk/test-host
cargo test --frozen --jobs 1 --manifest-path starter/Cargo.toml --target x86_64-unknown-linux-gnu --all-targets --features bluetraktor-plugin-sdk/test-host

Скачать и собрать BTP

Для первой сборки нужны Rust 1.91+, Python 3.11+, zstd и выбранная среда Linux-сборки. По умолчанию build.py использует cross и локальный Docker. SOURCE-MANIFEST.json в экспорте содержит хеши именно этой выгруженной версии и признак производного проекта; это не подпись доверенного издателя.

1. Нажмите «Скачать исходники с SDK». Получится ZIP с текущими файлами плагина, публичным SDK, lockfile и локальными инструментами сборки. Это не готовый BTP.
2. Распакуйте ZIP в отдельный каталог. Сохраняйте взаимное расположение starter/, crates/, Cargo.toml и build.py.
3. Запустите проверки из корня распакованного проекта. Работайте только с доверенными исходниками: Cargo и тесты исполняют код на вашей машине.
4. Выберите точный platform ID целевой установки. Для сервера Ubuntu 24 x86_64 используйте linux-x86_64-ubuntu24; для другой системы смотрите список поддержанных платформ.
5. После сборки проверьте BTP и загрузите его на отдельную тестовую установку. Установка, лицензия, grants и запуск экземпляра требуют самостоятельного подтверждения администратора.

cargo test --workspace --locked
python3 -m unittest test_build.py test_btp.py
python3 btp.py doctor
python3 build.py --platform linux-x86_64-ubuntu24
python3 btp.py inspect dist/io.example.temperature-0.1.0-linux-x86_64-ubuntu24.btp

Копия, удаление и приватность

1. Значок копирования создаёт отдельный проект с текущими исходниками. Оригинал сохраняется, даже если в нём возник конфликт.
2. Корзина в верхней панели удаляет весь проект после подтверждения. Корзина над кодом удаляет только текущий файл.
3. Удаление также проверяет версию: если проект изменился в другой вкладке, сначала загрузите актуальное состояние.
4. Проекты не попадают в общий магазин автоматически. Просмотр SDK, экспорт ZIP и собственная подпись не предоставляют право добавлять системные виджеты или разделы.
5. При удалении аккаунта его проекты удаляются из активного хранилища сайта. Срок хранения резервных копий зависит от политики владельца сервиса.