Менеджер библиотек: установка в один клик

Библиотеку для датчика DHT я в первый раз ставил по инструкции с форума: скачать ZIP с GitHub, распаковать, а папку — «куда-нибудь к библиотекам». Я догадался закинуть её в Program Files, куда установилась среда, и ещё не убрал суффикс -master из имени папки. Компилятор не нашёл ничего: строка подключения к несуществующему имени падала, и я трижды проверял провод, прежде чем заподозрил, что дело не в железе. Вечер закончился на официальной странице про установку библиотек — где всё то же самое делается одним окном без единого архива.

Менеджер библиотек — это когда вместо ручного копирования папок вы ищете библиотеку по имени, нажимаете «Установить» и получаете проверенную версию в правильное место. Обновления — отдельной кнопкой, старые версии — из выпадающего списка, зависимости — одним диалогом. ZIP-путь остаётся для случаев, когда на машине нет интернета или библиотека нигде не опубликована, но в девяти случаях из десяти менеджер быстрее, а главное — не оставляет после себя файлов в случайных местах.

Здесь разберём: где открыть менеджер, как читать карточку библиотеки, что делать с версиями и зависимостями, куда файлы падают на диске и как не поймать поломку от необдуманного обновления. Ручная установка из ZIP-архива — тема отдельного урока, сегодня же — штатная дорога, по которой я хожу сам и советую каждому.

В IDE 2 менеджер живёт на панели слева — иконка с книгами — и дублируется в меню «Инструменты — Управлять библиотеками». Вверху строка поиска, рядом фильтры по типу и теме. Типы честно отражают происхождение: официальные библиотеки от команды Arduino, партнёрские от крупных производителей плат, и всё остальное — от сообщества. Поиск по названию датчика часто находит даже больше, чем вы искали: наберите dht — увидите и библиотеки сенсора, и обёртки над ним.

Карточка библиотеки — это резюме: версия, автор, лицензия, дата последнего обновления и размер индекса установок. README под карточкой показывает, как библиотека выглядит в коде, ещё до установки. Моя привычка после одной неудачной покупки времени: смотреть на дату обновления. Библиотека, которую не трогали пять лет, может конфликтовать со свежим ядром — но и обратное бывает: старичок-стабильный живёт лучше вчерашнего релиза с новым API. Смотрите на оба числа и на текст карточки, а не только на кнопку.

Кнопка «Установить» — единственное обязательное действие. Среда скачает архив из индекса, распакует его в sketchbook/libraries и через мгновение библиотека видна в меню примеров и доступна в коде. Ничего перезапускать не нужно — я по привычке перезапускал среду первые два раза, пока не убедился, что это лишнее.

Поиск в менеджере умеет больше, чем точное совпадение, и этим стоит пользоваться. Забыли имя — наберите предмет: «ds18b20», «oled», «servo». Видите у знакомой библиотеки чужую карточку с похожим описанием — посмотрите на автора и количество установок: у популярных названий встречаются двойники с почти тем же именем, и я однажды поставил такую подделку-обёртку, полчаса разбирался, почему API не совпадает с документацией. Имя автора в карточке — лучшая страховка от этой путаницы.

Рядом с кнопкой «Установить» — выпадающий список версий. Зачем нужна старая версия: туториалы и готовые проекты пишут под конкретный API, а авторы библиотек иногда ломают совместимость между крупными версиями. Если проект из статьи собирается с ошибками на свежей библиотеке, откат на версию из статьи занимает десять секунд и часто спасает вечер. Число установок в карточке при этом честно подсказывает, какой вариант выбирало большинство.

Второе, о чём молчат многие инструкции, — зависимости. Ставите библиотеку, которой нужна другая, — среда покажет диалог и предложит установить всё сразу. Соглашайтесь: это не ошибка, а экономия трёх заходов в поиск. Я однажды отказался «чтобы не тащить лишнее», потом ставил недостающую вручную и забыл, какую именно просила первая, — итог тот же, только дольше. С обновлениями та же вежливость: у установленных библиотек появляется пометка о доступной новой версии, и кнопка обновления живёт в той же карточке.

Один нюанс связывает библиотеки с платформой: среда обновляет не только библиотеки, но и ядро платы, и после обновления платформы старые версии библиотек иногда перестают собираться — или наоборот, свежая библиотека требует свежее ядро. Если после обновления всего сразу что-то сломалось, подозревайте не код, а эту пару: откатите то или другое и проверьте. Больше одной перемены за раз я не делаю ещё и поэтому: невозможно понять, что именно изменило поведение.

После установки откройте sketchbook/libraries и найдите подпапку с именем библиотеки: внутри исходники, ключевые слова для подсветки и папка examples. Строку подключения в начало скетча удобно добавлять меню «Скетч — Подключить библиотеку»: среда впишет include сама, и вы не ошибётесь в регистре букв — а регистр в этих именах имеет значение, и dht вместо DHT ловится не сразу. Сам include пишется по имени библиотеки в уголках-скобках, как в коде выше.

Три первые ошибки после установки я собрал из своих вечеров. Скомпилировали скетч до установки библиотеки — компилятор честно скажет, что не нашёл такой файл; возвращайтесь в менеджер, а не в гугл. Написали имя в другом регистре — ошибка будет выглядеть загадочнее, чем стоит. Скачали форк с суффиксом в имени папки и подключаете его как оригинал — имена не совпадут. Все три лечатся за минуту, если помнить, что include ссылается ровно на то имя, которое видит среда в папке libraries, а как читать сам текст ошибки, — уже знакомая работа из урока про первый скетч в среде.

Библиотеки из менеджера — материал половины этого самоучителя: дисплей на I2C ставится за полминуты, экран OLED — тем же способом, а сервопривод SG90 из скетча выше поедет на настоящей плате после того, как вы подключите его к пину 9 и внешнему питанию. Даже термометр DHT11, с которого я когда-то начал свой ZIP-детектив, из менеджера ставится в два клика.

История, которая научила меня читать changelog: я обновил одну библиотеку кнопкой Update прямо перед показом поливалки заказчику — и скетч перестал собираться, потому что в новой версии переименовали класс. Откат версии вернул всё за минуту, но показ я спасал уже с чужим сердцебиением в ушах. Теперь обновления ставлю не в день их появления: сначала заглядываю в карточку и читаю, что изменилось, потом обновляю и сразу жму «Проверить» на всех проектах, которые эту библиотеку трогают.

Когда ZIP всё же нужен: библиотека самописная, скачана из чьего-то репозитория мимо индекса или машина offline. Порядок и типовые грабли пути — в уроке про ручную установку; главное на память — папка внутри sketchbook/libraries и без суффиксов вида -master. И держите в голове структуру из урока про папки Arduino: менеджер, ZIP и вкладки проекта — три способа разложить чужой код по одним и тем же полкам, а не три конкурирующие религии.