Миграция репозиториев 2025 года на новую версию ZMK
В 2026 году ZMK выпустило ломающее обновление, которое сделало невозможным сборку новых прошивок на базе репозиториев, созданных до конца 2025 года.
Расскажем, как мигрировать на новую версию, в этой статье.
Мы тоже мигрировали
Старый репозиторий, из которого вы создавали форки, больше не актуален. Это сделано намеренно, чтобы изменить формат поставки обновлений главного репозитория и не создавать коллизий при миграции у наших новых пользователей.
Новый репозиторий будет включать в себя сборки сразу для всех наших продуктов, чтобы упростить документацию, развитие периферии и переход между разными клавиатурами, а также иметь возможность быстро и атомарно реагировать на критические изменения.
Как мигрировать вам
Прошивка
Мы рекомендуем создать новый форк от нашего нового репозитория или, если вы способны сделать это самостоятельно, можете просто перенести все содержимое из нашего репозитоирия напрямую в ваш.
Если у вас много изменений в keymap и конфигурации, вы можете сохранить их. Для этого:
- Перенесите содержимое вашего старого название_клавиатуры.keymap файла в соответствующий в новом репозитории
- Перенесите из название_клавиатуры.conf файла все ваши флаги конфигурации кроме CONFIG_ZMK_STUDIO=y (при его наличии) в соответствующий файл конфигурации в новом репозитории
- Попробуйте создать коммит, прошивка должна собраться без ошибок
Если что-то пошло не так - обратитесь в наш чат поддержки, мы всегда поможем разобраться.
Web-конфигуратор прошивки
Если вы используете Keymap Editor от nickcoustos, то чтобы переключить его на новый репозиторий или даже обновить состояние для старого, нужно почистить cookie и кэш браузера для этого сайта. Для этого ознакомьтесь с инструкцией для вашего браузера. Если не получается - пишите нам.
Документация
С новым репозиторием пришла и обновленная документация о прошивке - обязательно перечитайте ее.