Внесите свой вклад в дальнейшее развитие.
Все, что связано с ioBroker, находится в открытом доступе на GitHub . Это не мелочь для разработчиков, а скорее причина, по которой любой может внести свой вклад: нет закрытой версии, нет внутренних веток и нет места, где нужно запрашивать разрешение, прежде чем вносить предложения.
Как разделен проект
| Часть | Что внутри? |
|---|---|
ioBroker.js-controller | Основные компоненты: базы данных, управление экземплярами,iobroker -команды. |
ioBroker.admin | Интерфейс описан в главе «Администрирование» данного руководства. |
ioBroker.<name> | Для каждого адаптера требуется один репозиторий, обычно управляемый одним человеком. |
ioBroker/ioBroker | Скрипты установки Linux, включая средство для исправления ошибок при установке. |
ioBroker.docs | Данная документация. |
Адаптеры независимы. Любой, кто хочет улучшить адаптер, обращается к тому, кто его поддерживает, а не к центральному комитету. В случае, если сопровождающий адаптера больше не активен, его поддерживают участники сообщества iobroker .
С чего начать?
Знания программирования не требуются. Переводы практически повсеместно отсутствуют. Каждый адаптер имеет файл, содержащий текст для его интерфейса конфигурации; добавление поддержки отсутствующего языка — это выполнимая и четко определенная задача. Также требуется документация; см. статью о ее написании .
Требуются навыки программирования. Самый простой способ начать — не разрабатывать собственный адаптер, а использовать существующий: найдите сообщение об ошибке, которое вы можете понять, и отправьте предложение. Таким образом, вы изучите структуру, не принимая все решения самостоятельно.
Пользовательский адаптер. Это полезно, если какое-либо устройство или служба еще отсутствуют. Процесс его создания описан в разделе «Разработка адаптеров» , а правила включения в официальный репозиторий — в разделе «Публикация адаптеров» .
Прежде чем начать работу над новым адаптером: спросите на форуме , не работает ли кто-нибудь над ним уже. Бывает, что два человека независимо друг от друга собирают одно и то же устройство.
Как работает процесс подачи предложения
- Создайте форк репозитория.
- Создайте ветку для изменений.
- Вносите изменения как можно меньше и ограничьтесь одним пунктом.
- Отправьте запрос на слияние (pull request) и объясните, почему это изменение необходимо, а не просто что оно делает.
- Ответьте на дополнительные вопросы. Любое предложение, оставшееся без ответа после первого дополнительного вопроса, не будет принято.
Небольшие, но четко обоснованные изменения внедряются быстро. Крупные ремонтные работы следует обсуждать заранее; в противном случае большая часть работы будет потрачена впустую на то, что не планировалось.
Что включает в себя проект
Помимо исходного кода, ioBroker нужны люди, которые отвечают на вопросы на форуме, тестируют бета-версии и четко описывают ошибки. Это менее заметно, чем работа над адаптером, но без этой работы остальное не будет функционировать.