Arduino:Знакомство с Arduino/Установка дополнительных библиотек: различия между версиями

Материал из Онлайн справочника
Перейти к навигацииПерейти к поиску
Нет описания правки
Нет описания правки
 
Строка 87: Строка 87:


<references />
<references />
{{Навигационная таблица/Портал/Arduino}}

Текущая версия от 12:31, 8 июля 2023

Перевод: Максим Кузьмин
Проверка/Оформление/Редактирование: Мякишев Е.А.


Установка дополнительных библиотек[1]

Освоившись с IDE Arduino и встроенными функциями, вы, возможно, захотите расширить возможности Arduino при помощи дополнительных библиотек.

Что такое «библиотеки»?

Библиотеки – это набор программ, упрощающих подключение к Arduino различных датчиков, дисплеев, модулей и т.д. К примеру, встроенная библиотека LiquidCrystal упрощает «общение» между Arduino и символьным LCD-дисплеем. В сети можно найти множество дополнительных библиотек. К примеру, встроенные библиотеки и некоторые из дополнительных библиотек можно найти тут. Перед тем, как использовать дополнительные библиотеки, их нужно установить.

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

Библиотеку можно установить двумя способами – через «Менеджер библиотек», импортирование ZIP-файла или ручную установку.

Установка через «Менеджер библиотек»

Это меню появилось в IDE Arduino версии 1.6.2., и оно открывается через пункт Скетч > Подключить библиотеку > Управлять библиотеками... (Sketch > Include Library > Manage Libraries…).

После этого откроется, собственно, «Менеджер библиотек», где будет список уже установленных библиотек и тех, что готовы к установке. В этом примере мы попробуем установить библиотеку AudioZero. Найдите ее, а затем выберите нужную версию. Иногда для библиотек доступна лишь одна версия. Если при выборе библиотеки не появляется меню для выбора версии – не беспокойтесь, это нормально.

Затем кликните по кнопке «Установка» и подождите, пока IDE Arduino будет устанавливать новую библиотеку. Время загрузки зависит, как правило, от скорости интернет-соединения. По завершении загрузки рядом с названием библиотеки должна появиться надпись INSTALLED («Установлено»). Теперь «Менеджер библиотек» можно закрывать.

Теперь новую библиотеку можно наблюдать в меню «Подключить библиотеку». Если вы хотите добавить собственную библиотеку, откройте новую задачу на GitHub.

Импорт ZIP-файла

Библиотеки часто распространяются в виде ZIP-архивов или просто папок с файлами. Название папки соответствует названию библиотеки. Внутри этой папки находятся файл *.cpp, файл *.h, зачастую файл keywords.txt, подпапка с примерами и др. Начиная с версии 1.0.5 в IDE Arduino можно устанавливать сторонние библиотеки. Распаковывать ZIP-библиотеку не нужно, оставьте как есть.

Теперь зайдите в IDE Arduino и откройте пункт Скетч > Подключить библиотеку (Sketch > Include Library). В верхней части выпадающего списка будет пункт «Добавить .ZIP библиотеку...» – выберите его.

Далее откроется окно, где вам будет предложено выбрать нужную библиотеку. Найдите ZIP-файл и откройте его.

Теперь вернитесь к меню Скетч > Подключить библиотеку. Выбранная вами библиотека должна появиться в самом низу выпадающего списка. Она уже готова для использования в вашем скетче. ZIP-файл будет распакован в папке libraries, находящейся в папке со скетчами.

Примечание: Хотя добавленную библиотеку можно будет использовать в скетчах, примеры появятся в меню Файл > Примеры (File > Examples) только при перезагрузке IDE Arduino.

Ручная установка

Перед тем, как устанавливать библиотеку, выйдите из IDE Arduino. Теперь распакуйте ZIP-файл с библиотекой. Например, если вы устанавливаете библиотеку под названием ArduinoParty, распакуйте архив ArduinoParty.zip. В результате у вас должна получиться папка ArduinoParty, внутри которой будут файлы вроде ArduinoParty.cpp и ArduinoParty.h. Если этих файлов внутри не будет, их надо туда положить. То есть создаем папку ArduinoParty и перемещаем туда все файлы, находящиеся в ZIP-файле – вроде ArduinoParty.cpp и ArduinoParty.h.

Теперь перемещаем папку ArduinoParty в папку libraries. В операционных системах Windows она расположена, как правило, по маршруту ''My Documents\Arduino\libraries''. Для Mac-пользователей это будет Documents/Arduino/libraries. На Linux это будет подпапка libraries в папке со скетчами.

Таким образом, на Windows ваша папка c библиотеками должна выглядеть следующим образом:

My Documents\Arduino\libraries\ArduinoParty\ArduinoParty.cpp
My Documents\Arduino\libraries\ArduinoParty\ArduinoParty.h
My Documents\Arduino\libraries\ArduinoParty\examples
....

А вот так на Mac и Linux:

Documents/Arduino/libraries/ArduinoParty/ArduinoParty.cpp
Documents/Arduino/libraries/ArduinoParty/ArduinoParty.h
Documents/Arduino/libraries/ArduinoParty/examples
....

В архиве могут быть не только файлы с расширением *.cpp и *.h, но и другие. Кроме того, если поместить эти файлы прямо в папку с библиотеками или в дополнительную папку, то работать они не будут. То есть, например, вот это...

Documents\Arduino\libraries\ArduinoParty.cpp and Documents\Arduino\libraries\ArduinoParty\ArduinoParty\ArduinoParty.cpp

...работать не будет.

Перезапустите IDE Arduino. Убедитесь, что новая библиотека появилась в меню Скетч > Подключить библиотеку. Вот и все, библиотека установлена!

См.также

Внешние ссылки