Библиотека не найдена: решение в один клик

Скачали чужой проект, нажали «Собрать» — и сборка упала со словами про отсутствующий файл «.h»? Проекту не хватает библиотеки. В классических средах дальше начинались поиски по форумам; в Trema IDE это чинится одним кликом — программа сама знает, чего не хватает и где это взять.

Ошибка появляется на самой первой строке — там, где скетч просит библиотеку, которой на компьютере ещё нет:

#include <iarduino_OLED_txt.h>  // библиотека ещё не установлена

iarduino_OLED_txt display(0x3C);

void setup() {
  display.begin();
  display.print("Привет");
}

void loop() {
}

Компилятор скажет fatal error: iarduino_OLED_txt.h: No such file or directory и остановится: без библиотеки остальной код проверять бессмысленно.

Что делает Trema IDE сама

Среда видит, какую библиотеку просит код, находит её в российском каталоге libraries.trema.ru и показывает окно «Не хватает библиотеки» с кнопкой установки. Один клик — библиотека скачивается с проверкой целостности, ставится вместе со своими зависимостями, и сборка продолжается. Если каталог давно не обновлялся, программа сама обновит его и поищет ещё раз.

Если библиотеки нет в каталоге

Такое бывает с редкими или самодельными библиотеками. Поставьте её вручную: менеджер библиотек принимает ZIP-архив и собственные источники. Пошагово — в инструкции «Как установить библиотеку».

Частные случаи

• Имя файла в ошибке не совпадает с именем библиотеки. Нормально: одна библиотека может содержать несколько файлов «.h». Программа разбирается в этом сама.
• Библиотека стоит, а ошибка осталась. Проверьте имя в #include — оно чувствительно к регистру и должно точно совпадать с файлом из библиотеки.
• Школьный компьютер. Установка может быть закрыта замком учителя: в окне есть кнопка для PIN-кода — учитель вводит его, и сборка продолжается сама.

Про то, как проект «помнит» свои библиотеки и сам просит их на новом компьютере, — статья про аккаунт и облако.

Частые вопросы

Читайте также

• Ошибка stray: невидимые русские символы в кодеКлассика после копирования из Word: «умные» кавычки, тире и русские буквы ломают сборку.
• Сборка прошла, а прошивка — нетКод в порядке, но в плату не заливается: чек-лист загрузки от кабеля до выбора платы.
• Неизвестное устройство: ставим драйверЖёлтый значок в диспетчере устройств — значит, Windows не хватает драйвера CH340 или CP2102.
• Медленно качаются библиотеки или платыНаши серверы в России и обычно отдают пакеты за секунды. Если ползёт — вот что проверить.

• Как установить библиотеку