{"draftJsState":{"blocks":[{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Добрый день, уважаемые читатели!","type":"unstyled","key":"et9cb"},{"data":{},"depth":0,"entityRanges":[{"key":0,"length":19,"offset":84}],"inlineStyleRanges":[{"length":11,"offset":127,"style":"ITALIC"}],"text":"В этой статье обсудим, каким образом можно добавлять к вашему проекту, созданному в VSCode + PlatformIO, какие-либо “внешние” (и не только) библиотеки. Причем в контексте данной статьи не так уж и важно – для какого микроконтроллера и на какой платформе вы создаете свой код – принципы работы менеджера библиотек PlatformIO одинаковы. Я буду приводить примеры для ESP32 и платформы ESP-IDF, но то же самое можно производить и для платформы Arduino, и для других микроконтроллеров. Одно ограничение – все нижесказанное относится к языку Си / С++ в применении к программированию микроконтроллеров.","type":"unstyled","key":"75vol"},{"data":{"image":{"id":"65f099ae6394ec4f457032c7"}},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"atomic:image","key":"699q9"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"unstyled","key":"cobki"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":14,"offset":0,"style":"ITALIC"}],"text":"Предупреждения","type":"unstyled","key":"98vr7"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":233,"offset":0,"style":"ITALIC"}],"text":"Я работаю в ОС Windows, поэтому все пути и “слеши” записаны применительно к этой операционной системе – C:\\dir\\subdir1\\subdir2\\… Если вы используете любую ОС семейства Linux – учитывайте особенности вашей ОС, в них я не “специалист”.","type":"ordered-list-item","key":"4965h"},{"data":{},"depth":0,"entityRanges":[{"key":1,"length":19,"offset":85},{"key":2,"length":27,"offset":107}],"inlineStyleRanges":[{"length":548,"offset":0,"style":"ITALIC"}],"text":"Статья является художественным пересказом справочной системы PlatformIO, посвященной менеджеру библиотек и системе поиска зависимостей. Разумеется, в данной статье содержится только малая толика информации, но я постарался донести её до вас в более понятной форме. Все ссылки в тесте статьи ведут на соответствующие разделы справочной системы PlatformIO. Рекомендую вам кроме моего текста, ознакомиться с оригиналами – кроме того, там нет рекламы. Со временем, возможно, ссылки могут устареть и перестать работать. Да и я могу чего-нибудь напутать.","type":"ordered-list-item","key":"c3m0m"},{"data":{},"depth":0,"entityRanges":[{"key":3,"length":21,"offset":110},{"key":4,"length":15,"offset":170}],"inlineStyleRanges":[{"length":185,"offset":0,"style":"ITALIC"}],"text":"Эта статья рассчитана на начинающих и в ней я не буду рассматривать управление библиотеками вручную с помощью PlatformIO Core (CLI) и инструментов командной строки вроде pio pkg install.","type":"ordered-list-item","key":"c8k22"},{"data":{},"depth":0,"entityRanges":[{"key":5,"length":27,"offset":69}],"inlineStyleRanges":[{"length":236,"offset":0,"style":"ITALIC"}],"text":"Dzen - не лучшая платформа для таких вот статей. Вы можете прочитать данную статью на моем сайте в несколько лучшем оформлении, к тому же я исправлю статьи только на сайте (здесь статья останется уже без изменений с момента публикации).","type":"ordered-list-item","key":"8g0s6"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"unstyled","key":"4reho"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Как всегда немного пустых теоретических разглагольствований","type":"header-two","key":"5brk5"},{"data":{},"depth":0,"entityRanges":[{"key":6,"length":8,"offset":534}],"inlineStyleRanges":[{"length":8,"offset":534,"style":"BOLD"}],"text":"Современные программные проекты редко работают изолированно. В большинстве случаев любой проект опирается на повторно используемые функциональные возможности в виде библиотек или разбивается на отдельные компоненты для создания модульной системы. Если вы работали хотя бы с одним, самым маленьким и простым проектом Arduino, то наверняка уже поняли, что без добавления стороннего кода к вашему проекту не обойтись никак. Как минимум вы подключаете к вашему коду какие-либо системные или платформенные библиотеки посредством директивы #include. Для взаимодействия с периферийным оборудованием и датчиками почти всегда используются сторонние библиотеки от производителя или других разработчиков. Ну и наконец, когда ваших проектов станет несколько, вы неизбежно столкнетесь с необходимостью “вынести” повторяющийся в разных проектах код в свои личные библиотеки.","type":"unstyled","key":"5ok18"},{"data":{},"depth":0,"entityRanges":[{"key":7,"length":31,"offset":133}],"inlineStyleRanges":[{"length":35,"offset":0,"style":"BOLD"},{"length":71,"offset":133,"style":"BOLD"}],"text":"При компиляции проекта в PlatformIO поиском и подключением к вашему проекту необходимых библиотек занимается специальный компонент – Library Dependency Finder (LDF) (система поиска зависимостей библиотек) — это основная часть системы сборки PlatformIO, которая работает с исходными файлами C/C++ и ищет директивы #include, чтобы узнать, какие каталоги заголовков включить для компилятора. Её функционал мы подробнее рассмотрим ниже.","type":"unstyled","key":"4f7p5"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Дабы внести ясность в дальнейший текст, условно разделим все включаемые в проект библиотеки на несколько условных групп. Я отнюдь не претендую на академичность названий, но предложенная классификация, на мой взгляд, позволит проще понять суть дальнейшего словоблудия.","type":"unstyled","key":"b7s19"},{"data":{},"depth":0,"entityRanges":[{"key":8,"length":8,"offset":345},{"key":9,"length":17,"offset":460}],"inlineStyleRanges":[{"length":36,"offset":0,"style":"ITALIC"},{"length":36,"offset":0,"style":"BOLD"},{"length":8,"offset":345,"style":"BOLD"}],"text":"Системные и платформенные библиотеки – то есть те, которые уже изначально включены в тот framework, который вы используете. Например ESP-IDF или Arduino32. Они устанавливаются автоматически при установке платформы в вашу IDE и не требуют отдельной установки – вам требуется только подключить их к вашему коду с помощью соответствующий директивы #include. Однако при этом в VSCode бывают проблемы с IntelliSense с платформенными библиотеками, как это исправить я уже писал ранее.","type":"unordered-list-item","key":"cai5m"},{"data":{},"depth":0,"entityRanges":[{"key":10,"length":8,"offset":327},{"key":11,"length":16,"offset":628}],"inlineStyleRanges":[{"length":20,"offset":0,"style":"BOLD"},{"length":8,"offset":327,"style":"BOLD"},{"length":44,"offset":454,"style":"BOLD"},{"length":39,"offset":647,"style":"BOLD"},{"length":45,"offset":749,"style":"BOLD"},{"length":20,"offset":0,"style":"ITALIC"},{"length":44,"offset":454,"style":"ITALIC"},{"length":39,"offset":647,"style":"ITALIC"},{"length":45,"offset":749,"style":"ITALIC"}],"text":"Сторонние библиотеки – то есть файлы, которые вы разрабатывали не сами и не производитель программной платформы (framework-а). Это могут быть драйвера дисплеев, датчиков, устройств, библиотеки для работы с различными протоколами передачи и форматами данных. Прежде чем вы подключите такую библиотеку к вашему проекту с помощью #include, вам потребуется вначале скачать и установить её в вашу IDE. Сделать это можно обычно разными способами, например так:из стандартного каталога библиотек вашей IDE, используя соответствующий графический или командный интерфейс. Для Aduino IDE это “Управление библиотеками…”, для PlatformIO – “Реестр библиотек“.\nиз архива .zip, *.rar, *.tar (и других), который вы скачали с сайта разработчика или иного источника.\nиз репозитория систем управления версиями VCS (Git, Hg, SVN). Менеджер библиотек PlatformIO позволяет автоматически скачивать и устанавливать необходимые библиотеки прямиком из репозиториев, что несомненно, очень удобно. Но об этом чуть позже.\n","type":"unordered-list-item","key":"70fst"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":20,"offset":0,"style":"BOLD"},{"length":26,"offset":432,"style":"BOLD"},{"length":13,"offset":794,"style":"BOLD"},{"length":26,"offset":870,"style":"BOLD"},{"length":20,"offset":0,"style":"ITALIC"},{"length":137,"offset":232,"style":"ITALIC"},{"length":26,"offset":432,"style":"ITALIC"},{"length":26,"offset":870,"style":"ITALIC"}],"text":"Локальные библиотеки – под этим термином я называю свои библиотеки, которые написал я и использую в своих проектах. Они “лежат” в определенных папках на диске моего компьютера, и мне только нужно указать компилятору, где их искать. Разумеется, сторонние библиотеки, скачанные в виде готовых архивов и (или) файлов, так же полностью можно считать локальными библиотеками. Локальные библиотеки можно условно разделить на два подвида: частные библиотеки проекта – часть кода, вынесенного из общей кодовой базы проекта в отдельные файлы для более удобного редактирования и управления ими. На самом деле в PlatformIO гораздо удобнее работать с 10 небольшими файлами кода, чем с одним файлом в 65535 строк – листать его то ещё удовольствие. В проектах PlatformIO такие библиотеки расположены в папке \\lib проекта и дополнительно подключать их к проекту не требуется.\nобщие локальные библиотеки – общая кодовая база, которая используется (или планируется к использованию) в нескольких проектах одновременно. Как правило, они физически (на диске) расположены вне каталога проекта и доступны всем проектам сразу.\n","type":"unordered-list-item","key":"2rvco"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Настройки проекта PlatformIO","type":"header-two","key":"6a3eu"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":133,"offset":0,"style":"BOLD"}],"text":"Все настройки проекта PlatformIO, в том числе и сведения о подключаемых библиотеках, осуществляются и хранятся в файле platformio.ini. Иного способа, насколько я знаю, не существует. Файл этот расположен в корневом каталоге вашего проекта.","type":"unstyled","key":"270jq"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":15,"offset":2,"style":"BOLD"}],"text":"В platformio.ini имеется 2 раздела, в которых можно объявить зависимости от используемых библиотек:","type":"unstyled","key":"9rcgv"},{"data":{},"depth":0,"entityRanges":[{"key":12,"length":18,"offset":0}],"inlineStyleRanges":[{"length":5,"offset":13,"style":"BOLD"}],"text":"Общий раздел [env] — объявляет общие параметры для всех рабочих сред, если их несколько.","type":"ordered-list-item","key":"a8mfe"},{"data":{},"depth":0,"entityRanges":[{"key":13,"length":25,"offset":0}],"inlineStyleRanges":[{"length":10,"offset":15,"style":"BOLD"}],"text":"Рабочий раздел [env:NAME] — объявляет конкретные параметры для выбранной рабочей среды с именем NAME.","type":"ordered-list-item","key":"ac10b"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Например вы можете объявить две рабочих среды [env:esp32debug] и [env:esp32release] с разными параметрами. В том числе, например, использовать различные версии библиотек. Или другие опции сборки. А можно создать несколько разных рабочих сред под разные версии микроконтроллера – здесь всё зависит от ваших конкретных задач и фантазии.","type":"unstyled","key":"3q9mk"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"В тестовом проекте, который вы найдете на GitHub, настроен общий раздел и одна рабочая среда [esp32dev]:","type":"unstyled","key":"5vu79"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"; Общие параметры для всех рабочих сред проекта\n[env]\n\n; Рабочие параметры для платы esp32dev и фреймворка espidf\n[env:esp32dev]\nplatform = espressif32\nboard = esp32dev\nframework = espidf","type":"unstyled","key":"dhjpp"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":14,"offset":22,"style":"BOLD"}],"text":"В этих самых разделах platformio.ini, в том числе, хранятся и параметры зависимостей от библиотек, использованных в вашем проекте. Параметров управления библиотеками не много, а очень много, поэтому осваивать их будем постепенно, по мере прочтения статьи. А начать, наверное, стоит с того, где хранятся эти самые библиотеки.","type":"unstyled","key":"e6nhe"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"unstyled","key":"6lu7f"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Хранилища библиотек","type":"header-two","key":"218mc"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Как я уже сказал, прежде чем вы сможете использовать ту или иную библиотеку в проекте, вы должны её вначале скачать и установить в вашу систему. Все скачанные библиотеки (или созданные вами локальные библиотеки) могут находиться в одном из нескольких хранилищ. Хранилище по своей сути – это просто папка на диске вашего компьютера. Эти хранилища (папки) имеют приоритет и LDF работает с ними в следующем порядке:","type":"unstyled","key":"dmk0e"},{"data":{},"depth":0,"entityRanges":[{"key":14,"length":7,"offset":0}],"inlineStyleRanges":[{"length":7,"offset":0,"style":"BOLD"},{"length":13,"offset":116,"style":"BOLD"}],"text":"lib_dir — собственное/частное хранилище библиотек, индивидуальных для каждого проекта . По умолчанию это подкаталог \\lib вашего проекта.","type":"ordered-list-item","key":"6bcee"},{"data":{},"depth":0,"entityRanges":[{"key":15,"length":11,"offset":0},{"key":16,"length":18,"offset":56},{"key":17,"length":13,"offset":254},{"key":18,"length":11,"offset":322}],"inlineStyleRanges":[{"length":11,"offset":0,"style":"BOLD"},{"length":21,"offset":254,"style":"BOLD"},{"length":30,"offset":281,"style":"BOLD"},{"length":11,"offset":322,"style":"BOLD"},{"length":22,"offset":350,"style":"BOLD"},{"length":52,"offset":182,"style":"ITALIC"}],"text":"libdeps_dir — хранилище библиотек проекта, используемое Library Manager-ом. Менеджер библиотек помещает сюда библиотеки, подключенные к проекту по ссылкам в сети Интернет, например (как конкретно это сделать, подробнее рассмотрим ниже). По умолчанию это workspace_dir\\libdeps, где workspace_dir = \\.pio, то есть libdeps_dir это подкаталоги \\.pio\\libdeps.","type":"ordered-list-item","key":"321q3"},{"data":{},"depth":0,"entityRanges":[{"key":19,"length":8,"offset":0}],"inlineStyleRanges":[{"length":12,"offset":0,"style":"BOLD"}],"text":"core_dir\\lib — глобальное хранилище библиотек для всех проектов. Справочная система PlatformIO, однако, говорит о том, что эта возможность устарела и они не рекомендуют использование глобальных библиотек. В этом я с ними согласен – не слишком хорошая идея пихать в один каталог библиотеки для разных платформ и микроконтроллеров.","type":"ordered-list-item","key":"9c8h"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":52,"offset":0,"style":"BOLD"}],"text":"Библиотечные хранилища, встроенные в фреймворки, SDK и т.д. Здесь всё будет зависеть от того, какую SDK или платформу вы используете. PlatformIO автоматически находит библиотеки платформ и SDK при компиляции, дополнительно их подключать к проекту не требуется.","type":"ordered-list-item","key":"ehtep"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":115,"offset":0,"style":"ITALIC"}],"text":"Все описанные ниже каталоги хранения (хранилища библиотек) можно перенастроить через различные опции platformio.ini.","type":"unstyled","key":"emjla"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Частное хранилище библиотек проекта","type":"header-three","key":"5b3lm"},{"data":{},"depth":0,"entityRanges":[{"key":20,"length":7,"offset":149}],"inlineStyleRanges":[{"length":13,"offset":56,"style":"BOLD"},{"length":7,"offset":149,"style":"BOLD"},{"length":13,"offset":271,"style":"BOLD"},{"length":14,"offset":312,"style":"BOLD"},{"length":12,"offset":332,"style":"BOLD"}],"text":"Частные библиотеки проекта находятся в папке (каталоге) \\lib вашего проекта. Изменить это поведение при необходимости можно с помощью опции lib_dir, поместив его в одну из упомянутых выше секций. Например если мне не нравиться имя каталога в единственном числе \\lib, то я могу поменять его на \\libs так: lib_dir=libs. На самом деле, я никогда этой опцией не пользуюсь – слишком много настроек, отличных от “стандартных” усложняют работу над проектом, всё хорошо в меру.","type":"unstyled","key":"ddcvg"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":48,"offset":0,"style":"ITALIC"}],"text":"LDF автоматически находит все частные библиотеки, и вам ничего не нужно указывать и настраивать дополнительно. Частные библиотеки, расположенные в одном проекте, будут не доступны для другого проекта, но на то они и частные. Частные библиотеки отлично походят для структуризации кода больших проектов на более мелкие функциональные составляющие.","type":"unstyled","key":"6refr"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":26,"offset":28,"style":"BOLD"}],"text":"Хранилище библиотек проекта PlatformIO Library Manager","type":"header-three","key":"bpgi2"},{"data":{},"depth":0,"entityRanges":[{"key":21,"length":26,"offset":146}],"inlineStyleRanges":[],"text":"Условно назовём это хранилище системным, так как мы сами, своими шаловливыми ручками, помещать в него ничего не должны. Этим хранилищем управляет PlatformIO Library Manager, целиком и полностью. В него он поместит библиотеки, которые мы подключили к проекту с помощью ссылок на GitHub и другие источники библиотек в сети интернет. Как это сделать, я расскажу ниже.","type":"unstyled","key":"15ln1"},{"data":{},"depth":0,"entityRanges":[{"key":22,"length":11,"offset":160},{"key":23,"length":13,"offset":181}],"inlineStyleRanges":[{"length":22,"offset":69,"style":"BOLD"},{"length":11,"offset":160,"style":"BOLD"},{"length":13,"offset":181,"style":"BOLD"}],"text":"По умолчанию менеджер библиотек использует под это хранилище каталог \\.pio\\libdeps вашего проекта. Но вы можете изменить это поведение с помощью опций libdeps_dir и (или) workspace_dir. Вопрос только в том – а надо ли?","type":"unstyled","key":"1ghfd"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Глобальное хранилище библиотек","type":"header-three","key":"1a3lk"},{"data":{},"depth":0,"entityRanges":[{"key":24,"length":8,"offset":107},{"key":25,"length":8,"offset":127},{"key":26,"length":15,"offset":521}],"inlineStyleRanges":[{"length":12,"offset":107,"style":"BOLD"},{"length":8,"offset":127,"style":"BOLD"},{"length":25,"offset":249,"style":"BOLD"},{"length":14,"offset":297,"style":"BOLD"},{"length":29,"offset":370,"style":"BOLD"},{"length":18,"offset":405,"style":"BOLD"},{"length":15,"offset":521,"style":"BOLD"}],"text":"Глобальное хранилище используется для всех проектов сразу. По умолчанию глобальное хранилище настроено как core_dir/lib. Здесь core_dir – это каталог, куда был установлен PlatformIO. Если ваш профиль в Windows записан латиницей, то это скорее всего %USERPROFILE%\\.platformio, иначе это может быть C:\\.platformio. Соответственно глобальное хранилище библиотек – это либо %USERPROFILE%\\.platformio\\lib либо C:\\.platformio\\lib. Сюда вы можете поместить все свои глобальные библиотеки. Это же хранилище используется командой pio pkg install с опцией -g.","type":"unstyled","key":"e2mah"},{"data":{},"depth":0,"entityRanges":[{"key":27,"length":13,"offset":33}],"inlineStyleRanges":[{"length":13,"offset":33,"style":"BOLD"}],"text":"Управляется это хранилище опцией globallib_dir. Однако, если вы перейдете по данной ссылке на справочную систему, по наверняка заметите такое вот предупреждение:","type":"unstyled","key":"5mj3r"},{"data":{},"depth":0,"entityRanges":[{"key":28,"length":8,"offset":248}],"inlineStyleRanges":[{"length":8,"offset":10,"style":"BOLD"}],"text":"Эта опция УСТАРЕЛА. Мы не рекомендуем использовать глобальные библиотеки для новых проектов. Пожалуйста, используйте декларативный подход для критически важной для безопасности встроенной разработки и объявляйте зависимости проекта с помощью опции lib_deps.","type":"blockquote","key":"cqmrk"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Штош… Не очень-то и хотелось!","type":"unstyled","key":"7g47f"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Библиотечные хранилища, встроенные в фреймворки, SDK","type":"header-three","key":"b57km"},{"data":{},"depth":0,"entityRanges":[{"key":29,"length":8,"offset":243}],"inlineStyleRanges":[{"length":8,"offset":243,"style":"BOLD"},{"length":22,"offset":347,"style":"BOLD"}],"text":"Тут на самом деле всё очень просто – PlatformIO сам разберется, где хранить платформы и фреймворки, и где потом искать те или иные “системные” библиотеки из них. Можно изменить корневой каталог platformio, если это необходимо, с помощью опции core_dir – в данный каталог и устанавливаются все платформы, frameworks и инструменты. По умолчанию это %HOMEPATH%\\.platformio. Но, учитывая, что данная опция может повлиять на все проекты сразу, вряд ли оптимально делать это в platformio.ini конкретного проекта.","type":"unstyled","key":"fg2kd"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"unstyled","key":"aas1v"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Как подключить локальные библиотеки к проекту","type":"header-two","key":"88rq1"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Теперь, когда мы разобрались с видами хранилищ библиотек, можно уже начинать пробовать подключать библиотеки к нашему тестовому проекту. Для начала стоит рассмотреть простейшие случаи, когда ваши библиотеки находятся на вашем же компьютере. Итак.","type":"unstyled","key":"bhgi0"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Частные библиотеки проекта","type":"header-three","key":"2pc2"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":13,"offset":49,"style":"BOLD"},{"length":71,"offset":115,"style":"ITALIC"}],"text":"Тут всё предельно просто – создаете внутри папки \\lib нужные вам подкаталоги и файлы и компилируете! Все! Никаких изменений в platformio.ini в данном случае вносить не требуется.","type":"unstyled","key":"7dbn7"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"И таки да, вы можете создавать внутри данного хранилища произвольное количество подкаталогов для различных модулей проекта, например так:","type":"unstyled","key":"1ve7u"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":13,"offset":20,"style":"BOLD"}],"text":"Библиотеки “внутри” \\lib могут ссылаться друг на друга, но старайтесь избегать циклических зависимостей.","type":"unstyled","key":"7kndf"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Общие локальные библиотеки","type":"header-three","key":"4bne5"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":26,"offset":230,"style":"BOLD"},{"length":240,"offset":341,"style":"ITALIC"}],"text":"А что если необходимо подключить к проекту общие локальные библиотеки, которые можно было бы использовать в различных проектах одновременно. Допустим, у меня есть парочка десятков собственных библиотек, которые “лежат” в каталоге C:\\PlatformIO\\libs_espidf\\ и я таки имею страстное желание использовать их в нескольких проектах одновременно. Примечание: в данном конкретном случае я пока что рассматриваю библиотеки, которые хранятся на дисках в виде обычных папок (каталогов) и файлов внутри них; подключение к проекта библиотек в виде скачанных и не только архивов рассмотрим ниже.","type":"unstyled","key":"abbgt"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":24,"offset":89,"style":"ITALIC"},{"length":5,"offset":186,"style":"STRIKE"}],"text":"Для этого существует как минимум несколько способов. В данном разделе я расскажу о двух (которыми и сам пользуюсь), а в следующем – ещё о нескольких. Почему так – станет понятно по ходу пьесы статьи.","type":"unstyled","key":"620op"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Способ 1. Используем глобальное хранилище библиотек","type":"header-three","key":"9m1k2"},{"data":{},"depth":0,"entityRanges":[{"key":30,"length":8,"offset":89}],"inlineStyleRanges":[{"length":12,"offset":89,"style":"BOLD"},{"length":37,"offset":224,"style":"ITALIC"}],"text":"Самый простой способ – переместить наши / ваши общие библиотеки в глобальное хранилище – core_dir/lib. Получается также просто, как и в предыдущем случае. Для примера я поместил в тестовый проект одну глобальную библиотеку (к сожалению, она на GitHub не попадет).","type":"unstyled","key":"1pc65"},{"data":{},"depth":0,"entityRanges":[{"key":31,"length":53,"offset":0}],"inlineStyleRanges":[],"text":"Но справочная система не рекомендует нам этого делать. И я с ней согласен. Хотя бы потому, что из этой одной единственной папки потянуться в проект самые разные библиотеки для разных платформ и микроконтроллеров – и нужные и ненужные. Конечно, компилятор умный, он их не будет включать без соответствующих #include, но как поведет себя система поиска зависимостей, написанная на питоне – вопрос. Не наш метод.","type":"unstyled","key":"8frtg"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Способ 2. Используем параметр lib_extra_dirs","type":"header-three","key":"30s29"},{"data":{},"depth":0,"entityRanges":[{"key":32,"length":14,"offset":54},{"key":33,"length":27,"offset":84}],"inlineStyleRanges":[{"length":14,"offset":4,"style":"BOLD"},{"length":14,"offset":54,"style":"BOLD"},{"length":38,"offset":202,"style":"BOLD"},{"length":38,"offset":243,"style":"BOLD"},{"length":15,"offset":31,"style":"ITALIC"},{"length":80,"offset":323,"style":"ITALIC"}],"text":"Для platformio.ini существует (пока существует) опция lib_extra_dirs, через которую системе поиска зависимостей можно указать, где искать наши локально-расшаренные библиотеки. Допустим, я поместил их в C:\\PlatformIO\\libs_espidf\\shared_lib_1 и C:\\PlatformIO\\libs_espidf\\shared_lib_2, как и в случае с частными библиотеками (эти библиотеки, расположенные “вне” каталога проекта, также не попадут на GitHub).","type":"unstyled","key":"13k0b"},{"data":{},"depth":0,"entityRanges":[{"key":34,"length":14,"offset":36}],"inlineStyleRanges":[{"length":14,"offset":2,"style":"BOLD"},{"length":14,"offset":36,"style":"BOLD"}],"text":"В platformio.ini добавляем параметр lib_extra_dirs, в котором указываем их расположение:","type":"unstyled","key":"4f4lo"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"; Общие параметры для всех рабочих сред проекта \n[env]\n; Каталог общих локальных библиотек\nlib_extra_dirs=C:\\PlatformIO\\libs_espidf\n\n; Рабочие параметры для платы esp32dev и фреймворка espidf\n[env:esp32dev]\nplatform = espressif32\nboard = esp32dev\nframework = espidf","type":"unstyled","key":"6ag50"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":166,"offset":92,"style":"BOLD"},{"length":166,"offset":92,"style":"ITALIC"}],"text":"После этого мы можем вполне успешно использовать их в проекте, как и частные, и глобальные. Я пока что использую данный метод в большинстве прежних проектов (просто создав разные наборы библиотек для разных платформ), но, походу, от него придется избавляться.","type":"unstyled","key":"eakrp"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":10,"offset":0,"style":"ITALIC"},{"length":395,"offset":12,"style":"ITALIC"},{"length":24,"offset":69,"style":"BOLD"}],"text":"Примечание: а данной опции указывать путь к библиотекам нужно только до предпоследнего уровня, то есть не нужно перечислять и указывать конкретные каталоги с библиотеками. В примере в общих экстра библиотеках у меня всего один уровень и два подкаталога. Но если структура ваших библиотек включает больше вложенных уровней – необходимо будет перечислить все уровни, но так же до предпоследнего, например так:","type":"unstyled","key":"8ci28"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":54,"offset":0,"style":"BOLD"},{"length":38,"offset":102,"style":"BOLD"},{"length":38,"offset":188,"style":"BOLD"},{"length":38,"offset":274,"style":"BOLD"},{"length":38,"offset":360,"style":"BOLD"}],"text":"lib_extra_dirs =\n C:\\PlatformIO\\libs32\\peripherals // внутри несколько папок с разными библиотеками\n C:\\PlatformIO\\libs32\\system // внутри несколько папок с разными библиотеками\n C:\\PlatformIO\\libs32\\sensors // внутри несколько папок с разными библиотеками\n C:\\PlatformIO\\libs32\\wifi // внутри несколько папок с разными библиотеками\n C:\\PlatformIO\\libs32\\clouds // внутри несколько папок с разными библиотеками","type":"unstyled","key":"c1p33"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Проверяем – проект успешно компилируется и работает:","type":"unstyled","key":"98n7t"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"LDF: Library Dependency Finder -> https://bit.ly/configure-pio-ldf\nLDF Modes: Finder ~ chain, Compatibility ~ soft\nFound 5 compatible libraries\nScanning dependencies...\nDependency Graph\n|-- global_lib_1\n|-- project_lib_1\n|-- project_lib_2\n|-- shared_lib_1\n|-- shared_lib_2\nBuilding in release mode\nRetrieving maximum program size .pio\\build\\esp32dev\\firmware.elf\nChecking size .pio\\build\\esp32dev\\firmware.elf\nAdvanced Memory Usage is available via \"PlatformIO Home > Project Inspect\"\nRAM: [ ] 3.2% (used 10604 bytes from 327680 bytes)\nFlash: [== ] 16.7% (used 175017 bytes from 1048576 bytes)","type":"unstyled","key":"dioir"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"unstyled","key":"596qo"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":129,"offset":0,"style":"BOLD"}],"text":"Но есть небольшая проблемка: опция lib_extra_dirs устарела с версии 6.0 и будет удалена в следующем основном выпуске PlatformIO. А это значит, от неё придется избавляться. Но – не страшно, у нас есть более универсальный и более удобный вариант, который мы и рассмотрим в следующем разделе.","type":"unstyled","key":"cuvsa"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"unstyled","key":"aie62"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Универсальный метод подключения библиотек к проекту","type":"header-two","key":"9dgdj"},{"data":{},"depth":0,"entityRanges":[{"key":35,"length":8,"offset":101}],"inlineStyleRanges":[{"length":8,"offset":101,"style":"BOLD"},{"length":14,"offset":133,"style":"BOLD"},{"length":22,"offset":194,"style":"ITALIC"},{"length":23,"offset":222,"style":"ITALIC"},{"length":44,"offset":382,"style":"ITALIC"}],"text":"Самый универсальный механизм подключения библиотек к вашему проекту PlatformIO – использовать опцию lib_deps в одной из двух секций platformio.ini. В терминологии PlatformIO это называется не “подключение библиотеки“, а “объявление зависимостей“. Эта опция управляет зависимостями вашего проекта от сторонних библиотек и позволяет подключить библиотеки из самых разных источников (окромя частных библиотек проекта, разумеется):","type":"unstyled","key":"853pr"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":46,"offset":0,"style":"ITALIC"},{"length":46,"offset":0,"style":"BOLD"}],"text":"из общих (для разных проектов) локальных папок","type":"unordered-list-item","key":"dc1a1"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":32,"offset":0,"style":"ITALIC"},{"length":32,"offset":0,"style":"BOLD"}],"text":"из локальных архивов zip или tar (имеется в виду без предварительной распаковки архива вручную)","type":"unordered-list-item","key":"cndej"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":41,"offset":0,"style":"ITALIC"},{"length":41,"offset":0,"style":"BOLD"}],"text":"из архивов zip или tar где-то в интернете без предварительного скачивания и распаковки","type":"unordered-list-item","key":"2j7qq"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":31,"offset":0,"style":"ITALIC"},{"length":31,"offset":0,"style":"BOLD"}],"text":"из реестра библиотек PlatformIO","type":"unordered-list-item","key":"cetm4"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":36,"offset":0,"style":"BOLD"},{"length":36,"offset":0,"style":"ITALIC"}],"text":"из репозиториев Git, GitHub, Hg, Svn (в том числе через самые разные протоколы – HTTPS и SSH и т.д.),","type":"unordered-list-item","key":"eee4i"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Эта опция может иметь сразу несколько значений одинаковых или разных типов, при этом каждое новое значение должно начинаться с новой строки.","type":"unstyled","key":"6f282"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":5,"offset":0,"style":"BOLD"}],"text":"[env] lib_deps =\n ; на основе только имени библиотеки (например это встроенная библиотека в framework)\n SPI\n ; на основе владельца и имени библиотеки (из реестра библиотек PlatformIO)\n knolleary/PubSubClient\n ; из локальной папки на вашем компьютере Windows\n file://C:/local/path/to/the/package/dir\n ; Внешний Git репозиторий, получаемый по HTTPS-протоколу \n https://github.com/gioblu/PJON.git\n ; ZIP-архив с дополнительным указанием имени библиотеки\n IRremoteESP8266=https://github.com/markszabo/IRremoteESP8266/archive/master.zip","type":"unstyled","key":"bo6lo"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":205,"offset":0,"style":"ITALIC"},{"length":81,"offset":228,"style":"ITALIC"},{"length":96,"offset":0,"style":"BOLD"}],"text":"Обязательным условием во всех случаях является наличие у подключаемой библиотеки файла манифеста, в котором как минимум должны быть объявлены имя библиотеки и её версия в формате Semantic Versioning 2.0.0 ... Этот файл и зачем он так необходим мы подробнее рассмотрим в следующих главах. Иначе вы рискуете получить сообщение вида:","type":"unstyled","key":"e9dp8"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"MissingPackageManifestError: Could not find one of 'library.json, library.properties, module.json' manifest files in the package","type":"unstyled","key":"178qk"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":27,"offset":221,"style":"BOLD"},{"length":26,"offset":249,"style":"BOLD"},{"length":22,"offset":346,"style":"BOLD"}],"text":"Если вы объявляете зависимость от удаленной библиотеки (не на вашем компьютере), то вам не требуется её скачивать – все необходимые действия будут выполнены автоматически. Скачанные и распакованные файлы будут помещены в хранилище библиотек проекта PlatformIO Library Manager, про которое я и рассказывал выше (а иначе зачем бы), то есть в папку \\.pio\\libdeps вашего проекта.","type":"unstyled","key":"151d3"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Все эти варианты мы и рассмотрим далее. Начнем с уже начатой темы – а именно подключения локальных общих библиотек.","type":"unstyled","key":"arknt"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Подключение локальной папки с библиотекой","type":"header-three","key":"bmsrk"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Для подключения к проекту общих локальных библиотек мы можем использовать два префикса:","type":"unstyled","key":"75o6o"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":7,"offset":9,"style":"BOLD"}],"text":"[=]file://C:/local/path/to/the/lib_directory","type":"unordered-list-item","key":"7e5p"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":10,"offset":9,"style":"BOLD"}],"text":"[=]symlink://C:/local/path/to/the/lib_directory","type":"unordered-list-item","key":"a3eep"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":15,"offset":0,"style":"ITALIC"},{"length":7,"offset":57,"style":"BOLD"},{"length":22,"offset":204,"style":"BOLD"},{"length":2,"offset":278,"style":"BOLD"}],"text":"В первом случае каталог, указанный после ключевого слова file://, рассматривается только как первоначальный источник библиотеки, после чего её содержимое копируется в хранилище библиотек проекта (каталог \\.pio\\libdeps). Последующее внесение изменений в исходную папку НЕ повлияет на уже установленный пакет библиотеки.","type":"unstyled","key":"f5hbs"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":16,"offset":0,"style":"ITALIC"},{"length":8,"offset":165,"style":"BOLD"}],"text":"Во втором случае библиотека никуда не копируется и не переносится, а используется “как есть”, то есть в исходной папке. Внесение изменений в исходную папку сразу же повлияет на установленный пакет.","type":"unstyled","key":"7idee"},{"data":{},"depth":0,"entityRanges":[{"key":36,"length":12,"offset":62}],"inlineStyleRanges":[{"length":137,"offset":0,"style":"ITALIC"},{"length":12,"offset":62,"style":"BOLD"},{"length":13,"offset":77,"style":"BOLD"},{"length":12,"offset":95,"style":"BOLD"}],"text":"В любом случае папка пакета должна содержать файл манифеста ( Library.json , platform.json или package.json) со свойствами имени и версии. Но в случае использования префикса file:// умный PlatformIO создаст манифест автоматически, а в случае с symlink:// – изругается самыми грязными выражениями.","type":"unstyled","key":"3fke5"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":14,"offset":109,"style":"ITALIC"}],"text":"Вы также можете переопределить имя папки пакета в хранилище диспетчера пакетов, используя синтаксис = (не обязательно). Если вы используете операционную систему семейства windows, то указывать пути можно как в windows-нотации, так и в linux-нотации, например это может выглядеть так:","type":"unstyled","key":"g3hg"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":5,"offset":0,"style":"BOLD"},{"length":7,"offset":26,"style":"BOLD"},{"length":10,"offset":76,"style":"BOLD"}],"text":"[env] \nlib_deps=\n MyLib1=file://C:/PlatformIO/libs_symlink/symlink_lib_1\n symlink://C:\\PlatformIO\\libs_symlink\\symlink_lib_2","type":"unstyled","key":"6rra4"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":120,"offset":0,"style":"BOLD"},{"length":135,"offset":0,"style":"ITALIC"},{"length":47,"offset":149,"style":"ITALIC"}],"text":"Главным недостатком такого подхода я считаю необходимость подключения к каждому проекту каждой вашей библиотеки отдельно, в отличие от lib_extra_dirs, которая позволяет грузить апельсины бочками. На текущий момент у меня используется несколько десятков библиотек, и все их придется подключать отдельной строкой. Поэтому я и не спешу переходить на этот способ.","type":"unstyled","key":"14ilc"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Подключение библиотек из архивов ZIP и TAR","type":"header-three","key":"bt5p1"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":13,"offset":0,"style":"BOLD"}],"text":"Спецификация: [=]file://C:/local/path/to/the/archive.zip","type":"unstyled","key":"b9038"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":7,"offset":275,"style":"BOLD"},{"length":10,"offset":287,"style":"BOLD"}],"text":"Ок, с папками разобрались. А что если мы где-то когда-то скачали файл библиотеки, и хотим применить в нашем проекте. Можно конечно, распаковать этот архив, содержимое поместить в какой-нибудь каталог и подключить к проекту одним из вышеперечисленных способов, например через file:// или symlink://.","type":"unstyled","key":"cjnj1"},{"data":{},"depth":0,"entityRanges":[{"key":37,"length":12,"offset":368}],"inlineStyleRanges":[{"length":7,"offset":197,"style":"BOLD"},{"length":12,"offset":368,"style":"BOLD"},{"length":13,"offset":383,"style":"BOLD"},{"length":12,"offset":401,"style":"BOLD"},{"length":93,"offset":351,"style":"ITALIC"}],"text":"Но настоящие программисты настолько суровы, что им лень распаковывать архив. Поэтому они подключают архив к проекту целиком и сразу – без распаковки. Делается это с помощью того же самого префикса file://, при этом расширение файла должно быть одно из .tar.gz, .tar, .tgz, или .zip. И “опять и снова” обязательное условие – внутри архива должен быть файл манифеста ( Library.json , platform.json или package.json) со свойствами имени и версии.","type":"unstyled","key":"bu93f"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":5,"offset":0,"style":"BOLD"},{"length":7,"offset":19,"style":"BOLD"},{"length":11,"offset":47,"style":"BOLD"}],"text":"[env] lib_deps =\n file://C:\\local\\path\\to\\the\\archive.zip","type":"unstyled","key":"csuqp"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":22,"offset":92,"style":"BOLD"}],"text":"PlatformIO распакует такой файл и поместит его содержимое в то же самое хранилище – каталог \\.pio\\libdeps.","type":"unstyled","key":"agikb"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"На самом деле, подключать библиотеки к проекты в виде локальных архивов – лично на мой взгляд дело сомнительной необходимости. Но вот подтянуть библиотеку в виде архива сразу из интернета с какого-то сайта – это то что доктор прописал.","type":"unstyled","key":"e2fh5"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":13,"offset":0,"style":"BOLD"}],"text":"Спецификация: [=]http(s)://remote/path/to/the/archive.zip","type":"unstyled","key":"56g40"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Например с GitHub:","type":"unstyled","key":"fg8p6"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":5,"offset":0,"style":"BOLD"},{"length":8,"offset":19,"style":"BOLD"},{"length":7,"offset":79,"style":"BOLD"}],"text":"[env] lib_deps =\n https://github.com/bblanchon/ArduinoJson/archive/refs/heads/6.x.zip","type":"unstyled","key":"fcv6c"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"PlatformIO сам скачает такой архив и распакует его, поместит куда нужно. Удобно? Конечно! Но есть способ лучше – клонировать репозиторий сам по себе, возможно с указанием дополнительных параметров.","type":"unstyled","key":"4secu"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Подключение библиотек из реестра PlatformIO","type":"header-three","key":"3slbj"},{"data":{},"depth":0,"entityRanges":[{"key":38,"length":29,"offset":87}],"inlineStyleRanges":[{"length":29,"offset":87,"style":"BOLD"}],"text":"Как и Arduino IDE, PlatformIO имеет собственный каталог библиотек и пакетов, именуемый реестром библиотек PlatformIO. В нем можно найти библиотеки для множества систем и платформ почти на все случаи жизни. Установить библиотеку из него можно двумя способами.","type":"unstyled","key":"6baco"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Способ 1. Интуитивно понятный, через меню и кнопочки","type":"header-three","key":"e3m1l"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":18,"offset":30,"style":"BOLD"},{"length":8,"offset":51,"style":"BOLD"},{"length":8,"offset":62,"style":"BOLD"},{"length":18,"offset":134,"style":"BOLD"},{"length":22,"offset":270,"style":"BOLD"},{"length":2,"offset":70,"style":"ITALIC"}],"text":"Перейти в него проще всего из Visual studio code → PIO Home → Librares. Там вы ищите и выбираете нужную вам библиотеку и жмете кнопку [ Add To Project ]. Это действие приводит к немедленной установке выбранной библиотеки куда? Правильно – в тот же самый грешный каталог \\.pio\\libdeps вашего проекта. То есть библиотека устанавливается не для всех проектов сразу, а только для текущего! При этом ничего дополнительно в platformio.ini не добавляется.","type":"unstyled","key":"83tg0"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Способ 2. Ручками, через platformio.ini","type":"header-three","key":"b7sgb"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":13,"offset":0,"style":"BOLD"}],"text":"Спецификация: /@","type":"unstyled","key":"5pu4i"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Если вам известны имя библиотеки и её владелец, то нет необходимости шарить по реестру библиотек, можно сделать это быстро и аккуратно, использовав все тот же самый механизм, например так:","type":"unstyled","key":"evhe8"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":5,"offset":0,"style":"BOLD"}],"text":"[env] lib_deps =\n kotyara12/rLed32 @ ^1.1.1","type":"unstyled","key":"fcie2"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":58,"offset":0,"style":"ITALIC"},{"length":44,"offset":80,"style":"ITALIC"}],"text":"Символы после @ определяют используемую версию библиотеки – я расскажу чуть ниже, потерпите немного. В этом случае выбранная библиотека будет автоматически скачана и установлена в хранилище при первой компиляции проекта. На мой взгляд этот способ несомненно удобнее, надежнее и практичнее – по крайней мере при клонировании проекта или переносе проекта с компьютера на компьютер вам не потребуется повторно устанавливать библиотеки вручную. Согласитесь – это ведь гораздо удобнее, чем в Arduino IDE?","type":"unstyled","key":"9hd85"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":3,"offset":56,"style":"BOLD"}],"text":"Клонирование библиотек из репозиториев Git, GitHub, Hg, Svn","type":"header-three","key":"vn36"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":13,"offset":0,"style":"BOLD"}],"text":"Спецификация: [=][://][[:]@][:][:][/][#]","type":"unstyled","key":"9lqdc"},{"data":{},"depth":0,"entityRanges":[{"key":39,"length":36,"offset":120}],"inlineStyleRanges":[],"text":"Ну и напоследок рассмотрим вариант автоматической загрузки библиотек из различных публичных и непубличных репозиториев. Поддерживаются Git, GitHub, Hg и Svn. Например на GitHub-е опубликованы большинство публичных библиотек для Arduino и ESP, там достаточно удобный поиск, поэтому имеет очень большой смысл тянуть их сразу оттуда. При загрузке можно использовать следующие схемы: http, https, git, git+http, git+https, git+ssh, hg+http, hg+https, hg+ssh, svn+http, svn+https, svn+ssh.","type":"unstyled","key":"fse3u"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Примеры подключения библиотеки с GitHub:","type":"unstyled","key":"efblj"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":5,"offset":0,"style":"BOLD"}],"text":"[env] lib_deps =\n https://github.com/kotyara12/rLog.git","type":"unstyled","key":"65npi"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"или так:","type":"unstyled","key":"22kgh"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":5,"offset":0,"style":"BOLD"}],"text":"[env] lib_deps =\n git@github.com:kotyara12/rLog.git","type":"unstyled","key":"b7ggq"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":22,"offset":153,"style":"BOLD"}],"text":"При первой компиляции PlatformIO сам клонирует указанный вами репозиторий и поместит его в хранилище проекта, то есть в тот же самый пресловутый каталог \\.pio\\libdeps. Вы можете указать имя пользователя и пароль, тем самым подключать библиотеки не только из публичных репозиторием; а также можно задать ветку или конкретный коммит при необходимости.","type":"unstyled","key":"c9vk3"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"unstyled","key":"21rsq"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Управление версиями библиотек","type":"header-two","key":"ak9n5"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":61,"offset":723,"style":"ITALIC"}],"text":"Теперь, когда мы рассмотрели основные варианты подключение библиотек, стоит отдельно упомянуть систему указания версий библиотек. Ничего не стоит на месте, и многие разработчики постоянно дорабатывают свои библиотеки – добавляют новые функции и устраняют найденные ошибки. Это, безусловно, очень неплохо, но иногда это может принести дополнительные проблемы. Собрали вы, скажем, свой проект с использованием чьей-то сторонней библиотеки или платформы, а она раз – и обновилась! И проект вдруг перестал компилироваться из-за новых функций или ещё каких-либо изменений. И вам потребуется дополнительное время, дабы привести вроде бы работающий уже проект под новые данные. И времени часто не хватает, а заказчик / начальник “руками сучит, ногами стучит, очами вращает, в обчем, стращает” (с) Леонид Филатов.","type":"unstyled","key":"7scsm"},{"data":{},"depth":0,"entityRanges":[{"key":40,"length":20,"offset":80},{"key":41,"length":84,"offset":171}],"inlineStyleRanges":[{"length":20,"offset":80,"style":"BOLD"},{"length":153,"offset":102,"style":"BOLD"},{"length":153,"offset":102,"style":"ITALIC"}],"text":"Разумеется, разработчики предусмотрели специальный механизм, который называется Version Requirements. Работает это не только для библиотек, но и для всех других пакетов – например так можно указывать версию платформы Arduino или ESP-IDF для вашего проекта.","type":"unstyled","key":"3vqkc"},{"data":{},"depth":0,"entityRanges":[{"key":42,"length":16,"offset":253}],"inlineStyleRanges":[],"text":"Если кратко, то заключается он в следующем – после указания ссылки на библиотеку или иной пакет вы можете дополнительно задать требуемую версию пакета или библиотеки. Версия указывается после символа @, и может быть записана в нескольких вариантах (см. шпаргалку Semver):","type":"unstyled","key":"279ko"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"^1.2.3 – любая совместимая версия (допускаются новые функции с обратной совместимостью и исправления, 1.xx).","type":"unordered-list-item","key":"d35aj"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"~1.2.3 – любая версия с одинаковыми основными и второстепенными версиями, а также равная или более высокая версия исправления","type":"unordered-list-item","key":"6e3lf"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":">1.2.3 – любая версия выше 1.2.3, вы также можете использовать другие операторы сравнения: >=, <, <=.","type":"unordered-list-item","key":"1noev"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":">0.1.0,!=0.2.0,<0.3.0 – совмещенная запись: любая версия больше 0.1.0, не равна 0.2.0 и меньше0.3.0","type":"unordered-list-item","key":"1g50b"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"1.2.3 – точный номер версии. PlatformIO попробует загрузить только эту точно заданную версию и ничто иное.","type":"unordered-list-item","key":"9nguu"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"То есть если я записал выше:","type":"unstyled","key":"44lk9"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":5,"offset":0,"style":"BOLD"}],"text":"[env] lib_deps =\n kotyara12/rLed32 @ ^1.1.1","type":"unstyled","key":"1jrnr"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"то это означает, что PlatformIO попытается установить любую совместимую версию указанной библиотеки. Осталось понять – откуда он знает эту самую. Верно – из того самого файла манифеста.","type":"unstyled","key":"864rb"},{"data":{},"depth":0,"entityRanges":[{"key":43,"length":14,"offset":272}],"inlineStyleRanges":[{"length":161,"offset":0,"style":"BOLD"},{"length":14,"offset":272,"style":"BOLD"},{"length":161,"offset":0,"style":"ITALIC"},{"length":109,"offset":163,"style":"ITALIC"},{"length":1,"offset":286,"style":"ITALIC"}],"text":"Необходимо отметить, что указанная версия скачивается один раз при первой компиляции проекта, и в последующем без особого указания с вашей стороны не обновляется. Для загрузки свежих версий библиотек, платформ, фреймворков и иных пакетов в последующем используйте команду pio pkg update.","type":"unstyled","key":"3f7qv"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Файл манифеста библиотеки PlatformIO","type":"header-two","key":"3f80r"},{"data":{},"depth":0,"entityRanges":[{"key":44,"length":14,"offset":101},{"key":45,"length":12,"offset":142}],"inlineStyleRanges":[{"length":14,"offset":101,"style":"BOLD"},{"length":12,"offset":142,"style":"BOLD"},{"length":13,"offset":157,"style":"BOLD"},{"length":12,"offset":175,"style":"BOLD"},{"length":3,"offset":154,"style":"ITALIC"},{"length":5,"offset":170,"style":"ITALIC"}],"text":"Каждая ваша или сторонняя библиотека, которую вы создали сами или загрузили со стороны, должна иметь файл манифеста, который должен иметь имя library.json , platform.json или package.json– как вы, наверное, уже догадались, для библиотеки, платформы или иного пакета соответственно. Это позволяет разработчикам сохранять структуру проекта и определять:","type":"unstyled","key":"88oh3"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"совместимые фреймворки и платформы","type":"unordered-list-item","key":"cqnk4"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"внешние зависимости от других библиотек","type":"unordered-list-item","key":"85iu7"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"расширенные настройки сборки.","type":"unordered-list-item","key":"94egt"},{"data":{},"depth":0,"entityRanges":[{"key":46,"length":10,"offset":61},{"key":47,"length":20,"offset":78},{"key":48,"length":20,"offset":194}],"inlineStyleRanges":[],"text":"Информация в файле library.json должна быть представлена в стиле JSON через ассоциативный массив (пары имя/значение). Порядок записей не имеет значения. Допустимые поля (имена из пар) описаны в справочной системе – особого смысла перечислять все из здесь я не вижу. Приведу только некоторые из них, которые могут относиться к нашим библиотекам:","type":"unstyled","key":"17bhg"},{"data":{},"depth":0,"entityRanges":[{"key":49,"length":4,"offset":0},{"key":50,"length":18,"offset":48}],"inlineStyleRanges":[{"length":4,"offset":0,"style":"BOLD"}],"text":"name – имя библиотеки. Должно быть уникальным в реестре PlatformIO. Может содержать AZ, цифры и тире (но не может начинаться или заканчиваться ими).","type":"unordered-list-item","key":"fi4bc"},{"data":{},"depth":0,"entityRanges":[{"key":51,"length":7,"offset":0},{"key":52,"length":36,"offset":119}],"inlineStyleRanges":[{"length":7,"offset":0,"style":"BOLD"}],"text":"version – версия текущего исходного кода библиотеки. Может содержать az, цифры, точки или тире и должен быть совместим с семантическим управлением версиями.","type":"unordered-list-item","key":"dg662"},{"data":{},"depth":0,"entityRanges":[{"key":53,"length":11,"offset":0}],"inlineStyleRanges":[],"text":"description – описание библиотеки. Поле помогает пользователям искать вашу библиотеку в каталоге.","type":"unordered-list-item","key":"fu0s5"},{"data":{},"depth":0,"entityRanges":[{"key":54,"length":8,"offset":0}],"inlineStyleRanges":[],"text":"keywords – ключевые слова. Помогает облегчить поиск вашей библиотеки, при этом людям не нужно знать ее название.","type":"unordered-list-item","key":"1nf9e"},{"data":{},"depth":0,"entityRanges":[{"key":55,"length":8,"offset":0},{"key":56,"length":11,"offset":68}],"inlineStyleRanges":[],"text":"homepage – домашняя страница библиотеки (если она отличается от URL репозитория).","type":"unordered-list-item","key":"94neq"},{"data":{},"depth":0,"entityRanges":[{"key":57,"length":10,"offset":0}],"inlineStyleRanges":[],"text":"repository – репозиторий, в котором можно найти исходный код","type":"unordered-list-item","key":"bs6n2"},{"data":{},"depth":0,"entityRanges":[{"key":58,"length":7,"offset":0}],"inlineStyleRanges":[],"text":"authors – контактная информация автора","type":"unordered-list-item","key":"2d520"},{"data":{},"depth":0,"entityRanges":[{"key":59,"length":10,"offset":0}],"inlineStyleRanges":[],"text":"frameworks – cписок совместимых фреймворков","type":"unordered-list-item","key":"4j04n"},{"data":{},"depth":0,"entityRanges":[{"key":60,"length":9,"offset":0}],"inlineStyleRanges":[],"text":"platforms – cписок совместимых платформ разработки","type":"unordered-list-item","key":"72bpe"},{"data":{},"depth":0,"entityRanges":[{"key":61,"length":4,"offset":83},{"key":62,"length":7,"offset":90}],"inlineStyleRanges":[],"text":"Для библиотек, которые вы создаете сами, вы должны указать хотя бы два параметра – name и version – они выделены жирным шрифтом. В качестве примера приведу один из своих файлов:","type":"unstyled","key":"4qu42"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"{\n \"name\": \"reSensor\",\n \"version\": \"3.2.0\",\n \"description\": \"Unified sensor base class used by sensor libraries\",\n \"keywords\": \"sensors\",\n \"authors\":\n [\n {\n \"name\": \"Alexander Razzhivin\",\n \"email\": \"kotyara12@yandex.ru\",\n \"url\": \"https://kotyara12.ru\"\n }\n ],\n \"license\": \"MIT\",\n \"frameworks\": [\"arduino\", \"espidf\"],\n \"platforms\": [\"espressif32\"]\n}","type":"unstyled","key":"1gkjg"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"unstyled","key":"9tqdv"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Опции поиска зависимостей библиотек","type":"header-two","key":"164nn"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Ни для кого не секрет, что библиотеки часто ссылаются друг на друга, то есть зависят друг от друга. И библиотеки, которые вы перечислили явным образом, могут тянуть за собой множество других библиотек и пакетов, от которых они зависят. Например многие библиотеки сенсоров от Adafruit требуют обязательного наличия базового класса Adafruit Unified Sensor Driver. В Arduino IDE вам пришлось бы устанавливать его вручную отдельно, PlatformIO же вполне может установить его в ваш проект неявно, без вашего активного вмешательства.","type":"unstyled","key":"au4g2"},{"data":{},"depth":0,"entityRanges":[{"key":63,"length":31,"offset":106},{"key":64,"length":7,"offset":441}],"inlineStyleRanges":[{"length":31,"offset":106,"style":"BOLD"},{"length":8,"offset":286,"style":"BOLD"},{"length":8,"offset":286,"style":"ITALIC"}],"text":"Здесь стоит немного остановиться на поиске зависимостей библиотек. Этим занимается специальный механизм – Library Dependency Finder (LDF). Средство поиска зависимостей библиотек — это основная часть системы сборки PlatformIO, которая работает с исходными файлами C/C++ и ищет директивы #include, чтобы узнать, какие из заголовков подключить к компилятору. Library Dependency Finder всегда начинает работу с анализа исходных файлов проекта ( src_dir ) и может работать в следующих режимах:","type":"unstyled","key":"9jspn"},{"data":{},"depth":0,"entityRanges":[{"key":65,"length":8,"offset":154},{"key":66,"length":12,"offset":183}],"inlineStyleRanges":[],"text":"off: «Ручной режим», не обрабатывает исходные файлы проекта и зависимости. Собирает только те библиотеки, которые явно указаны с использованием параметра lib_deps или их манифестах ( library.json , module.json).","type":"unordered-list-item","key":"f38v3"},{"data":{},"depth":0,"entityRanges":[{"key":67,"length":38,"offset":247}],"inlineStyleRanges":[{"length":5,"offset":0,"style":"BOLD"},{"length":13,"offset":234,"style":"BOLD"}],"text":"chain: Анализирует ВСЕ исходные файлы проекта на C/C++ и следует только по вложенным включениям (цепочкам) из библиотек. Он также анализирует файлы C, CC, CPP из библиотек, которые имеют то же имя, что и включенный заголовочный файл. Не оценивает условный синтаксис препроцессора C/C++ .","type":"unordered-list-item","key":"81ekr"},{"data":{},"depth":0,"entityRanges":[{"key":68,"length":38,"offset":146}],"inlineStyleRanges":[{"length":13,"offset":133,"style":"BOLD"}],"text":"deep: Анализирует ВСЕ исходные файлы C/C++ проекта и анализирует ВСЕ исходные файлы C/C++ каждой найденной зависимости (рекурсивно). Не оценивает условный синтаксис препроцессора C/C++ .","type":"unordered-list-item","key":"9vu8p"},{"data":{},"depth":0,"entityRanges":[{"key":69,"length":38,"offset":67}],"inlineStyleRanges":[{"length":10,"offset":57,"style":"BOLD"}],"text":"chain+: То же поведение, что и для chain, но при этом он учитывает условный синтаксис препроцессора C/C++ .","type":"unordered-list-item","key":"jbje"},{"data":{},"depth":0,"entityRanges":[{"key":70,"length":38,"offset":65}],"inlineStyleRanges":[{"length":10,"offset":55,"style":"BOLD"}],"text":"deep+: То же поведение, что и для deep, но при этом он учитывает условный синтаксис препроцессора C/C++ .","type":"unordered-list-item","key":"62mdt"},{"data":{},"depth":0,"entityRanges":[{"key":71,"length":12,"offset":37},{"key":72,"length":43,"offset":52}],"inlineStyleRanges":[{"length":12,"offset":37,"style":"BOLD"},{"length":45,"offset":97,"style":"BOLD"},{"length":14,"offset":227,"style":"BOLD"},{"length":6,"offset":272,"style":"BOLD"}],"text":"Режим можно изменить с помощью опции lib_ldf_mode в platformio.ini (файле конфигурации проекта). Значение по умолчанию установлено как chain. Поэтому, если вы, например, желаете отключить какие-то библиотеки с помощью макросов #if ... #endif, то вам желательно перейти на chain+. Но скажу сразу – работает это пока кривовато.","type":"unstyled","key":"24ikq"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Библиотеки и IntelliSence","type":"header-two","key":"dhjmn"},{"data":{},"depth":0,"entityRanges":[{"key":73,"length":14,"offset":38}],"inlineStyleRanges":[],"text":"Подключение библиотек к проекту через platformio.ini вовсе не означает, что у вас сразу же заработает подсветка синтаксиса и автодополнение кода для вновь подключенных библиотек. Скорее всего – наоборот – будет вагон и маленькая тележка разнообразных “псевдоошибок” от системы IntelliSence. Как с эти бороться?","type":"unstyled","key":"47c1j"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":1,"offset":74,"style":"BOLD"},{"length":8,"offset":112,"style":"BOLD"},{"length":10,"offset":121,"style":"BOLD"},{"length":16,"offset":134,"style":"BOLD"},{"length":39,"offset":153,"style":"BOLD"}],"text":"Во первых попробовать компилировать проект и обновить индексы IntelliSence. Сделать это можно с помощью команды VSCode → Menu: View → Command Palette… → PlatformIO: Rebuild C/C++ Project Index. Это перестроит индексы системы IntelliSence и, возможно, решит данную проблему.","type":"unstyled","key":"218c7"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":7,"offset":151,"style":"BOLD"},{"length":21,"offset":173,"style":"BOLD"},{"length":11,"offset":269,"style":"BOLD"}],"text":"Если предыдущий вариант не помогает, следует подсказать IntelliSence, где искать библиотеки и фреймворки, где искать ваши исходные файлы. Ищем каталог .vscode, а в нем файл c_cpp_properties.json. Открываем его с помощью любого тестового редактора. И добавляем в массив includePath все пути, которые вы используете. Дабы они обрабатывались рекурсивно, в конце пути должны быть символы **. Например у меня это выглядит так:","type":"unstyled","key":"erg7p"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":733,"offset":65,"style":"BOLD"}],"text":"{\n \"configurations\": [\n {\n \"name\": \"Win32\",\n \"includePath\": [\n \"${workspaceFolder}/**\",\n \"C:/PlatformIO/libs/**\",\n \"${env:USERPROFILE}/.platformio/packages/toolchain-xtensa-esp32/xtensa-esp32-elf/**\",\n \"${env:USERPROFILE}/.platformio/packages/toolchain-xtensa32/xtensa-esp32-elf/**\",\n \"${env:USERPROFILE}/.platformio/packages/framework-espidf/components/**\",\n \"${env:USERPROFILE}/.platformio/packages/toolchain-xtensa-esp32/lib/gcc/xtensa-esp32-elf/**\",\n \"${env:USERPROFILE}/.platformio/packages/toolchain-xtensa32/lib/gcc/xtensa-esp32-elf/**\",\n \"${env:USERPROFILE}/.platformio/packages/framework-espidf/components/driver/include\"\n ],\n \"defines\": [\n \"_DEBUG\",\n \"UNICODE\",\n \"_UNICODE\"\n ],\n \"cStandard\": \"c17\",\n \"cppStandard\": \"c++17\",\n \"intelliSenseMode\": \"windows-msvc-x64\",\n \"compileCommands\": \"${workspaceFolder}/.pio/build/esp32dev/compile_commands.json\"\n }\n ],\n \"version\": 4\n}","type":"unstyled","key":"15std"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"После этого не забываем заново перестроить индексы, как описано выше. После этого проблема самоликвидируется.","type":"unstyled","key":"arpoo"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"unstyled","key":"7lnf1"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Ссылки","type":"header-two","key":"a5n2j"},{"data":{},"depth":0,"entityRanges":[{"key":74,"length":43,"offset":0}],"inlineStyleRanges":[{"length":43,"offset":0,"style":"BOLD"}],"text":"Документация: менеджер библиотек PlatformIO","type":"unordered-list-item","key":"2t0of"},{"data":{},"depth":0,"entityRanges":[{"key":75,"length":27,"offset":0}],"inlineStyleRanges":[],"text":"Реестр библиотек PlatformIO","type":"unordered-list-item","key":"40hkp"},{"data":{},"depth":0,"entityRanges":[{"key":76,"length":18,"offset":0}],"inlineStyleRanges":[],"text":"Статья у AlexGyver","type":"unordered-list-item","key":"1klla"},{"data":{},"depth":0,"entityRanges":[{"key":77,"length":36,"offset":0}],"inlineStyleRanges":[{"length":36,"offset":0,"style":"BOLD"}],"text":"Полный архив статей вы найдете здесь","type":"unordered-list-item","key":"7o787"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"marker","key":"r95nw3wxV1enuyD1LjHm"}],"entityMap":{"44":{"data":{"url":"https://docs.platformio.org/en/latest/manifests/library-json/index.html#library-json"},"mutability":"MUTABLE","type":"LINK"},"45":{"data":{"url":"https://docs.platformio.org/en/latest/manifests/library-json/index.html#library-json"},"mutability":"MUTABLE","type":"LINK"},"46":{"data":{"url":"http://en.wikipedia.org/wiki/JSON"},"mutability":"MUTABLE","type":"LINK"},"47":{"data":{"url":"http://en.wikipedia.org/wiki/Associative_array"},"mutability":"MUTABLE","type":"LINK"},"48":{"data":{"url":"https://docs.platformio.org/en/latest/manifests/library-json/index.html#library-json"},"mutability":"MUTABLE","type":"LINK"},"49":{"data":{"url":"https://docs.platformio.org/en/latest/manifests/library-json/fields/name.html"},"mutability":"MUTABLE","type":"LINK"},"50":{"data":{"url":"https://registry.platformio.org/"},"mutability":"MUTABLE","type":"LINK"},"51":{"data":{"url":"https://docs.platformio.org/en/latest/manifests/library-json/fields/version.html"},"mutability":"MUTABLE","type":"LINK"},"52":{"data":{"url":"http://semver.org/"},"mutability":"MUTABLE","type":"LINK"},"53":{"data":{"url":"https://docs.platformio.org/en/latest/manifests/library-json/fields/description.html"},"mutability":"MUTABLE","type":"LINK"},"10":{"data":{"url":"https://learn.microsoft.com/ru-ru/cpp/preprocessor/hash-include-directive-c-cpp?view=msvc-170"},"mutability":"MUTABLE","type":"LINK"},"54":{"data":{"url":"https://docs.platformio.org/en/latest/manifests/library-json/fields/keywords.html"},"mutability":"MUTABLE","type":"LINK"},"11":{"data":{"url":"https://registry.platformio.org/"},"mutability":"MUTABLE","type":"LINK"},"55":{"data":{"url":"https://docs.platformio.org/en/latest/manifests/library-json/fields/homepage.html"},"mutability":"MUTABLE","type":"LINK"},"12":{"data":{"url":"https://docs.platformio.org/en/latest/projectconf/sections/env/index.html#projectconf-section-env"},"mutability":"MUTABLE","type":"LINK"},"56":{"data":{"url":"https://docs.platformio.org/en/latest/manifests/library-json/fields/repository.html#manifest-library-json-repository"},"mutability":"MUTABLE","type":"LINK"},"13":{"data":{"url":"https://docs.platformio.org/en/latest/projectconf/sections/env/index.html#projectconf-section-env-named"},"mutability":"MUTABLE","type":"LINK"},"57":{"data":{"url":"https://docs.platformio.org/en/latest/manifests/library-json/fields/repository.html"},"mutability":"MUTABLE","type":"LINK"},"14":{"data":{"url":"https://docs.platformio.org/en/latest/projectconf/sections/platformio/options/directory/lib_dir.html#projectconf-pio-lib-dir"},"mutability":"MUTABLE","type":"LINK"},"58":{"data":{"url":"https://docs.platformio.org/en/latest/manifests/library-json/fields/authors.html"},"mutability":"MUTABLE","type":"LINK"},"15":{"data":{"url":"https://docs.platformio.org/en/latest/projectconf/sections/platformio/options/directory/libdeps_dir.html#projectconf-pio-libdeps-dir"},"mutability":"MUTABLE","type":"LINK"},"59":{"data":{"url":"https://docs.platformio.org/en/latest/manifests/library-json/fields/frameworks.html"},"mutability":"MUTABLE","type":"LINK"},"16":{"data":{"url":"https://docs.platformio.org/en/latest/librarymanager/index.html#librarymanager"},"mutability":"MUTABLE","type":"LINK"},"17":{"data":{"url":"https://docs.platformio.org/en/latest/projectconf/sections/platformio/options/directory/workspace_dir.html#projectconf-pio-workspace-dir"},"mutability":"MUTABLE","type":"LINK"},"18":{"data":{"url":"https://docs.platformio.org/en/latest/projectconf/sections/platformio/options/directory/libdeps_dir.html#projectconf-pio-libdeps-dir"},"mutability":"MUTABLE","type":"LINK"},"19":{"data":{"url":"https://docs.platformio.org/en/latest/projectconf/sections/platformio/options/directory/core_dir.html#projectconf-pio-core-dir"},"mutability":"MUTABLE","type":"LINK"},"0":{"data":{"url":"https://kotyara12.ru/iot/esp_start/"},"mutability":"MUTABLE","type":"LINK"},"1":{"data":{"url":"https://docs.platformio.org/en/latest/librarymanager/index.html#librarymanager"},"mutability":"MUTABLE","type":"LINK"},"2":{"data":{"url":"https://docs.platformio.org/en/latest/librarymanager/ldf.html"},"mutability":"MUTABLE","type":"LINK"},"3":{"data":{"url":"https://docs.platformio.org/en/latest/core/index.html#piocore"},"mutability":"MUTABLE","type":"LINK"},"4":{"data":{"url":"https://docs.platformio.org/en/latest/core/userguide/pkg/cmd_install.html#id2"},"mutability":"MUTABLE","type":"LINK"},"5":{"data":{"url":"https://kotyara12.ru/iot/pio-libs/"},"mutability":"MUTABLE","type":"LINK"},"6":{"data":{"url":"https://learn.microsoft.com/ru-ru/cpp/preprocessor/hash-include-directive-c-cpp?view=msvc-170"},"mutability":"MUTABLE","type":"LINK"},"7":{"data":{"url":"https://docs.platformio.org/en/latest/librarymanager/ldf.html"},"mutability":"MUTABLE","type":"LINK"},"8":{"data":{"url":"https://learn.microsoft.com/ru-ru/cpp/preprocessor/hash-include-directive-c-cpp?view=msvc-170"},"mutability":"MUTABLE","type":"LINK"},"9":{"data":{"url":"https://kotyara12.ru/iot/crawl-to-pio/"},"mutability":"MUTABLE","type":"LINK"},"60":{"data":{"url":"https://docs.platformio.org/en/latest/manifests/library-json/fields/platforms.html"},"mutability":"MUTABLE","type":"LINK"},"61":{"data":{"url":"https://docs.platformio.org/en/latest/manifests/library-json/fields/name.html"},"mutability":"MUTABLE","type":"LINK"},"62":{"data":{"url":"https://docs.platformio.org/en/latest/manifests/library-json/fields/version.html"},"mutability":"MUTABLE","type":"LINK"},"63":{"data":{"url":"https://docs.platformio.org/en/latest/librarymanager/ldf.html#id2"},"mutability":"MUTABLE","type":"LINK"},"20":{"data":{"url":"https://docs.platformio.org/en/latest/projectconf/sections/platformio/options/directory/lib_dir.html"},"mutability":"MUTABLE","type":"LINK"},"64":{"data":{"url":"https://docs.platformio.org/en/latest/projectconf/sections/platformio/options/directory/src_dir.html#projectconf-pio-src-dir"},"mutability":"MUTABLE","type":"LINK"},"21":{"data":{"url":"https://docs.platformio.org/en/latest/librarymanager/index.html#librarymanager"},"mutability":"MUTABLE","type":"LINK"},"65":{"data":{"url":"https://docs.platformio.org/en/latest/projectconf/sections/env/options/library/lib_deps.html#projectconf-lib-deps"},"mutability":"MUTABLE","type":"LINK"},"22":{"data":{"url":"https://docs.platformio.org/en/latest/projectconf/sections/platformio/options/directory/libdeps_dir.html"},"mutability":"MUTABLE","type":"LINK"},"66":{"data":{"url":"https://docs.platformio.org/en/latest/manifests/library-json/index.html#library-json"},"mutability":"MUTABLE","type":"LINK"},"23":{"data":{"url":"https://docs.platformio.org/en/latest/projectconf/sections/platformio/options/directory/workspace_dir.html"},"mutability":"MUTABLE","type":"LINK"},"67":{"data":{"url":"https://docs.platformio.org/en/latest/librarymanager/ldf.html#ldf-c-cond-syntax"},"mutability":"MUTABLE","type":"LINK"},"24":{"data":{"url":"https://docs.platformio.org/en/latest/projectconf/sections/platformio/options/directory/core_dir.html#projectconf-pio-core-dir"},"mutability":"MUTABLE","type":"LINK"},"68":{"data":{"url":"https://docs.platformio.org/en/latest/librarymanager/ldf.html#ldf-c-cond-syntax"},"mutability":"MUTABLE","type":"LINK"},"25":{"data":{"url":"https://docs.platformio.org/en/latest/projectconf/sections/platformio/options/directory/core_dir.html#projectconf-pio-core-dir"},"mutability":"MUTABLE","type":"LINK"},"69":{"data":{"url":"https://docs.platformio.org/en/latest/librarymanager/ldf.html#ldf-c-cond-syntax"},"mutability":"MUTABLE","type":"LINK"},"26":{"data":{"url":"https://docs.platformio.org/en/latest/core/userguide/pkg/cmd_install.html#id2"},"mutability":"MUTABLE","type":"LINK"},"27":{"data":{"url":"https://docs.platformio.org/en/latest/projectconf/sections/platformio/options/directory/globallib_dir.html"},"mutability":"MUTABLE","type":"LINK"},"28":{"data":{"url":"https://docs.platformio.org/en/latest/projectconf/sections/env/options/library/lib_deps.html#projectconf-lib-deps"},"mutability":"MUTABLE","type":"LINK"},"29":{"data":{"url":"https://docs.platformio.org/en/latest/projectconf/sections/platformio/options/directory/core_dir.html#projectconf-pio-core-dir"},"mutability":"MUTABLE","type":"LINK"},"70":{"data":{"url":"https://docs.platformio.org/en/latest/librarymanager/ldf.html#ldf-c-cond-syntax"},"mutability":"MUTABLE","type":"LINK"},"71":{"data":{"url":"https://docs.platformio.org/en/latest/projectconf/sections/env/options/library/lib_ldf_mode.html#projectconf-lib-ldf-mode"},"mutability":"MUTABLE","type":"LINK"},"72":{"data":{"url":"https://docs.platformio.org/en/latest/projectconf/index.html#projectconf"},"mutability":"MUTABLE","type":"LINK"},"73":{"data":{"url":"https://docs.platformio.org/en/latest/projectconf/index.html#projectconf"},"mutability":"MUTABLE","type":"LINK"},"30":{"data":{"url":"https://docs.platformio.org/en/latest/projectconf/sections/platformio/options/directory/core_dir.html#projectconf-pio-core-dir"},"mutability":"MUTABLE","type":"LINK"},"74":{"data":{"url":"https://docs.platformio.org/en/latest/librarymanager/index.html"},"mutability":"MUTABLE","type":"LINK"},"31":{"data":{"url":"https://docs.platformio.org/en/latest/projectconf/sections/platformio/options/directory/globallib_dir.html"},"mutability":"MUTABLE","type":"LINK"},"75":{"data":{"url":"https://registry.platformio.org/"},"mutability":"MUTABLE","type":"LINK"},"32":{"data":{"url":"https://docs.platformio.org/en/latest/projectconf/sections/env/options/library/lib_extra_dirs.html"},"mutability":"MUTABLE","type":"LINK"},"76":{"data":{"url":"https://alexgyver.ru/%D0%BC%D0%B5%D0%BD%D0%B5%D0%B4%D0%B6%D0%B5%D1%80-%D0%B1%D0%B8%D0%B1%D0%BB%D0%B8%D0%BE%D1%82%D0%B5%D0%BA-%D0%B2-platformio/"},"mutability":"MUTABLE","type":"LINK"},"33":{"data":{"url":"https://docs.platformio.org/en/latest/librarymanager/ldf.html"},"mutability":"MUTABLE","type":"LINK"},"77":{"data":{"url":"https://kotyara12.ru/sitemap/"},"mutability":"MUTABLE","type":"LINK"},"34":{"data":{"url":"https://docs.platformio.org/en/latest/projectconf/sections/env/options/library/lib_extra_dirs.html"},"mutability":"MUTABLE","type":"LINK"},"35":{"data":{"url":"https://docs.platformio.org/en/latest/projectconf/sections/env/options/library/lib_deps.html"},"mutability":"MUTABLE","type":"LINK"},"36":{"data":{"url":"https://docs.platformio.org/en/latest/manifests/library-json/index.html#library-json"},"mutability":"MUTABLE","type":"LINK"},"37":{"data":{"url":"https://docs.platformio.org/en/latest/manifests/library-json/index.html#library-json"},"mutability":"MUTABLE","type":"LINK"},"38":{"data":{"url":"https://registry.platformio.org/"},"mutability":"MUTABLE","type":"LINK"},"39":{"data":{"url":"https://docs.platformio.org/en/latest/core/userguide/pkg/cmd_install.html#repository-git-hg-svn"},"mutability":"MUTABLE","type":"LINK"},"40":{"data":{"url":"https://docs.platformio.org/en/latest/core/userguide/pkg/cmd_install.html#id15"},"mutability":"MUTABLE","type":"LINK"},"41":{"data":{"url":"https://kotyara12.ru/iot/pio_versions_control/"},"mutability":"MUTABLE","type":"LINK"},"42":{"data":{"url":"https://devhints.io/semver"},"mutability":"MUTABLE","type":"LINK"},"43":{"data":{"url":"https://docs.platformio.org/en/latest/core/userguide/pkg/cmd_update.html#cmd-pkg-update"},"mutability":"MUTABLE","type":"LINK"}}},"mentions":[]}