Arduino庫(kù)

Arduino庫(kù)是共享代碼的便捷方法，例如設(shè)備驅(qū)動(dòng)程序或常用的實(shí)用程序功能。本指南詳細(xì)介紹了如何在計(jì)算機(jī)上安裝庫(kù)。有關(guān)Arduino庫(kù)及其使用方法的出色介紹，請(qǐng)參閱Arduino技巧，竅門(mén)和技巧中的“庫(kù)”頁(yè)面。

共有三種類(lèi)型的Arduino庫(kù)：

標(biāo)準(zhǔn)庫(kù)

Arduino IDE附帶了一組標(biāo)準(zhǔn)庫(kù)常用功能。這些庫(kù)支持IDE附帶的所有示例。標(biāo)準(zhǔn)庫(kù)功能包括基本的通信功能，并支持某些最常見(jiàn)的硬件類(lèi)型，例如伺服電機(jī)和字符LCD顯示器。

標(biāo)準(zhǔn)庫(kù)已預(yù)先安裝在Arduino安裝的“ Libraries”文件夾中。如果您安裝了多個(gè)版本的IDE，則每個(gè)版本將具有自己的一組庫(kù)。 在大多數(shù)情況下，更改標(biāo)準(zhǔn)庫(kù)或?qū)?kù)安裝在同一文件夾中不是一個(gè)好主意。

庫(kù)管理器庫(kù)

較新的Arduino IDE具有庫(kù)管理器，該庫(kù)管理器可幫助安裝提交給Arduino的第三方庫(kù)以供使用。 Adafruit在庫(kù)管理器中擁有大多數(shù)庫(kù)和驅(qū)動(dòng)程序，易于使用。

用戶安裝的庫(kù)

還有許多其他庫(kù)，它們具有適用于各種硬件的有用功能和設(shè)備驅(qū)動(dòng)程序。這些驅(qū)動(dòng)程序可從Arduino Playground，Github和Google Code等地方獲得。

應(yīng)將用戶安裝的庫(kù)安裝在您的Sketchbook庫(kù)文件夾中，以便它們可用于所有版本的IDE。這樣，如果發(fā)布了新版本的IDE，則不必重新安裝所有喜歡的庫(kù)！

庫(kù)管理器

庫(kù)管理器是Arduino IDE的較新功能。許多流行的圖書(shū)館，包括Adafruit的大多數(shù)圖書(shū)館，都在圖書(shū)館管理器中。如果您要使用其他人的圖書(shū)館，請(qǐng)先檢查“圖書(shū)館管理器”以查看圖書(shū)館是否在那里，而不是將副本下載到本地的 libraries 文件夾中。

要開(kāi)始，加載Arduino IDE。然后使用頂部的菜單選擇素描-》 包含庫(kù)-》 管理庫(kù)。..

然后您將獲得以下列表：您可以安裝的所有出色的庫(kù)！

大多數(shù)情況下，您可以使用頂部的搜索功能來(lái)查找特定的庫(kù)。

上面，用戶在搜索欄中輸入了 adafruit 。所有現(xiàn)代的Adafruit庫(kù)均以單詞Adafruit開(kāi)頭。

您可以向下滾動(dòng)列表以查找所需的庫(kù)。假設(shè)我們想要Circuit Playground庫(kù)，如下所示。您可以單擊“安裝”按鈕以使其可用或已安裝，可以選擇所需的版本（出于兼容性，通常是最新的，有時(shí)是較早的庫(kù)）。

通常（但并非總是），加載庫(kù)會(huì)帶來(lái)其他示例的可用性。在菜單中，轉(zhuǎn)到文件-》示例，然后選擇您的庫(kù)名稱(chēng)（如果有）并瀏覽其他示例。加載上面的Adafruit CircuitPlayground庫(kù)還加載了12個(gè)示例和4個(gè)帶有其他示例的目錄。

最新版本的Arduino IDE將在啟動(dòng)時(shí)提醒您，如果您要升級(jí)，則可以使用更新版本的已安裝庫(kù)（和板）。 。您可以暫時(shí)忽略它們，但是在啟動(dòng)新項(xiàng)目時(shí)希望獲得最新的庫(kù)。

手動(dòng)安裝庫(kù)

庫(kù)管理器是安裝庫(kù)的最簡(jiǎn)單，最安全的方法。如果可能的話，這就是您應(yīng)該使用的方法。

如果要使用的庫(kù)無(wú)法通過(guò)庫(kù)管理器使用，則可以獲取源代碼并將其放置在計(jì)算機(jī)的本地庫(kù)文件夾中。文件夾的位置非常具體。

請(qǐng)參見(jiàn)下面的文件層次結(jié)構(gòu)：

將庫(kù)安裝在正確的位置很重要。否則，當(dāng)您嘗試編譯和上傳草圖時(shí)，編譯器將無(wú)法找到它們。

錯(cuò)誤安裝的庫(kù)可能會(huì)導(dǎo)致IDE出現(xiàn)許多問(wèn)題。

找到您的Sketchbook文件夾和內(nèi)部的庫(kù)文件夾

您的Sketchbook文件夾是Arduino IDE存儲(chǔ)您的草圖的文件夾。安裝時(shí)，該文件夾由IDE自動(dòng)創(chuàng)建。

在Linux計(jì)算機(jī)上，該文件夾名為“ Sketchbook”，通常位于/home/

在Windows和Macintosh計(jì)算機(jī)上，默認(rèn)名稱(chēng)為文件夾是“ Arduino”，位于您的Documents文件夾中。

這是Windows和Mac計(jì)算機(jī)上常見(jiàn)的混亂來(lái)源，您的Sketchbook文件夾未命名為“ sketchbook”，而是命名為“ Arduino”！

用戶安裝的庫(kù)應(yīng)該在素描本文件夾內(nèi)名為 Libraries 的文件夾中。 IDE將在此處查找用戶安裝的庫(kù)。

在1.0.2版和更高版本的Arduino IDE中，“庫(kù)”文件夾是自動(dòng)創(chuàng)建的。在早期版本的IDE上，安裝第一個(gè)庫(kù)時(shí)可能需要?jiǎng)?chuàng)建它。

打開(kāi)“偏好設(shè)置”對(duì)話框

點(diǎn)擊文件 -》 IDE中的首選項(xiàng)。

查找素描本位置

通常在“文檔”文件夾中找到一個(gè)名為 Arduino 的文件夾。

知道位置后，在Windows資源管理器或mac Finder中導(dǎo)航到該文件夾

創(chuàng)建庫(kù)文件夾

如果其中沒(méi)有庫(kù)文件夾，請(qǐng)創(chuàng)建一個(gè)。

右鍵單擊在Windows資源管理器中，選擇新建-》 文件夾。

重命名為庫(kù)

右鍵單擊新建文件夾，然后選擇重命名。然后輸入庫(kù)。

在Windows上安裝庫(kù)

請(qǐng)按照以下步驟在Windows中安裝庫(kù)。

關(guān)閉Arduino IDE 首先確保關(guān)閉了Arduino IDE的所有實(shí)例。 IDE僅在啟動(dòng)時(shí)掃描庫(kù)。 只要打開(kāi)了IDE的任何實(shí)例，它將不會(huì)看到您的新庫(kù)！

下載壓縮文件

請(qǐng)確保選擇該庫(kù)的發(fā)行版本。一些庫(kù)存儲(chǔ)庫(kù)仍在開(kāi)發(fā)中，并且可能包含未發(fā)布或未經(jīng)測(cè)試的代碼。 “發(fā)布”按鈕將帶您進(jìn)入測(cè)試和發(fā)布的版本。

單擊Github存儲(chǔ)庫(kù)頁(yè)面上的“發(fā)布”按鈕以查找?guī)斓陌l(fā)布版本。

然后下載zip文件。

打開(kāi)Zip文件打開(kāi)Zip文件并復(fù)制庫(kù)主文件夾。

粘貼到您的Libraries文件夾中打開(kāi)您的Sketchbook Libraries文件夾，然后粘貼從.Zip復(fù)制的主文件夾。 br》

命名為合法名稱(chēng) IDE無(wú)法記錄識(shí)別名稱(chēng)中帶有破折號(hào)的文件夾。因此，您必須重命名Github主文件夾。下劃線是可以的！

重新啟動(dòng)IDE ，重新啟動(dòng)Arduino IDE，并驗(yàn)證該庫(kù)是否出現(xiàn)在“文件”-》“示例”菜單中。

加載其中一個(gè)庫(kù)示例進(jìn)行測(cè)試。

驗(yàn)證其是否可編譯點(diǎn)擊左上角的復(fù)選標(biāo)記圖標(biāo)并驗(yàn)證示例草圖是否正確編譯。

在Mac OSX上安裝庫(kù)

請(qǐng)按照以下步驟在Mac OSX上安裝庫(kù)。

關(guān)閉Arduino IDE 首先確保關(guān)閉了Arduino IDE的所有實(shí)例。 IDE僅在啟動(dòng)時(shí)掃描庫(kù)。 只要打開(kāi)了IDE的任何實(shí)例，它將不會(huì)看到您的新庫(kù)！

下載Zip文件

確保選擇該庫(kù)的發(fā)行版本。一些庫(kù)存儲(chǔ)庫(kù)仍在開(kāi)發(fā)中，并且可能包含未發(fā)布或未經(jīng)測(cè)試的代碼。 “發(fā)布”按鈕將帶您進(jìn)入測(cè)試和發(fā)布的版本。

單擊Github存儲(chǔ)庫(kù)頁(yè)面上的“發(fā)布”按鈕以查找?guī)斓陌l(fā)布版本。

然后下載zip文件。

在“下載”文件夾中找到它，OSX會(huì)自動(dòng)在其中打開(kāi)zip文件。

將其拖動(dòng)到您的庫(kù)文件夾中，打開(kāi)您的Sketchbook庫(kù)文件夾并將主文件夾從“下載”拖入其中。

提供法定名稱(chēng) IDE不會(huì)重新識(shí)別名稱(chēng)中帶有破折號(hào)的文件夾。因此，您必須重命名Github主文件夾。下劃線是可以的！

重新啟動(dòng)IDE ，然后重新啟動(dòng)Arduino IDE，并驗(yàn)證該庫(kù)是否出現(xiàn)在“文件”-》“示例”菜單中。

加載其中一個(gè)庫(kù)示例進(jìn)行測(cè)試。

驗(yàn)證其可編譯點(diǎn)擊左上角的復(fù)選標(biāo)記圖標(biāo)并驗(yàn)證示例草圖編譯沒(méi)有錯(cuò)誤。

在Linux上安裝庫(kù)

請(qǐng)按照以下步驟在Linux中安裝庫(kù)。

關(guān)閉Arduino IDE 首先確保關(guān)閉了Arduino IDE的所有實(shí)例。 IDE僅在啟動(dòng)時(shí)掃描庫(kù)。 只要打開(kāi)了IDE的任何實(shí)例，它將不會(huì)看到您的新庫(kù)！

下載Zip文件

確保選擇該庫(kù)的發(fā)行版本。一些庫(kù)存儲(chǔ)庫(kù)仍在開(kāi)發(fā)中，并且可能包含未發(fā)布或未經(jīng)測(cè)試的代碼。 “發(fā)布”按鈕將帶您進(jìn)入測(cè)試和發(fā)布的版本。

單擊Github存儲(chǔ)庫(kù)頁(yè)面上的“發(fā)布”按鈕以查找?guī)斓陌l(fā)布版本。

然后下載zip文件。

保存壓縮文件將壓縮文件保存到方便的位置。

打開(kāi)Zip文件打開(kāi)Zip文件并復(fù)制庫(kù)主文件夾。

開(kāi)始提取，從菜單中選擇“提取”并導(dǎo)航至您的Sketchbook/Libraries文件夾

提取到您的庫(kù)文件夾中導(dǎo)航到sketchbook/libraries文件夾后，完成提取。

提供一個(gè)合法名稱(chēng)，IDE將無(wú)法識(shí)別名稱(chēng)中帶有破折號(hào)的文件夾。因此，您必須重命名Github主文件夾。下劃線是可以的！

重新啟動(dòng)IDE ，然后重新啟動(dòng)Arduino IDE，并驗(yàn)證該庫(kù)是否出現(xiàn)在“文件”-》“示例”菜單中。

加載其中一個(gè)庫(kù)示例進(jìn)行測(cè)試。

驗(yàn)證其可編譯點(diǎn)擊左上角的復(fù)選標(biāo)記圖標(biāo)并驗(yàn)證示例草圖編譯沒(méi)有錯(cuò)誤。

常見(jiàn)的庫(kù)問(wèn)題

‘xxxx’沒(méi)有命名類(lèi)型常見(jiàn)的庫(kù)相關(guān)錯(cuò)誤消息，這意味著編譯器找不到該庫(kù)。原因可能是：

未安裝庫(kù)（請(qǐng)參閱本指南的前幾頁(yè)）

錯(cuò)誤的文件夾位置

錯(cuò)誤的文件夾名稱(chēng)

錯(cuò)誤的庫(kù)名

庫(kù)依賴(lài)項(xiàng)

忘了關(guān)閉IDE

請(qǐng)參閱以下有關(guān)這些問(wèn)題的解決方案。

錯(cuò)誤的文件夾位置

IDE將僅找到標(biāo)準(zhǔn)簿和安裝在寫(xiě)生簿Libraries文件夾中的庫(kù)，它將無(wú)法找到其他位置安裝的庫(kù)。

Library文件夾必須位于Libraries文件夾的頂層。如果將它放在子文件夾中，則IDE找不到它。

注意：某些第三方庫(kù)存儲(chǔ)庫(kù)具有不同的文件夾結(jié)構(gòu)。您可能需要重新整理內(nèi)容，以確保庫(kù)文件位于文件夾的頂層。 WaveHC就是一個(gè)例子。實(shí)際的庫(kù)文件夾是頂級(jí)存儲(chǔ)庫(kù)文件夾中的文件夾。

沒(méi)有“ Sketchbook”文件夾。但是在Windows或Mac/OSX計(jì)算機(jī)上，它可能不會(huì)被命名為“ Sketchbook”。請(qǐng)參見(jiàn)標(biāo)題為“在何處安裝庫(kù)”的頁(yè)面。

不完整的庫(kù)

您必須下載并安裝整個(gè)庫(kù)。不要忽略或更改庫(kù)文件夾內(nèi)任何文件的名稱(chēng)。

錯(cuò)誤文件夾名稱(chēng)

IDE將不會(huì)加載名稱(chēng)中帶有某些字符的文件。不幸的是，它不喜歡Github生成的zip文件名稱(chēng)中的破折號(hào)。解壓縮文件時(shí)，請(qǐng)重命名文件夾，使其不包含任何“非法”字符。只需用andunderscore（‘_’）替換每個(gè)破折號(hào)（‘-’）通常即可。

錯(cuò)誤的庫(kù)名稱(chēng)

在草圖的#include中指定的名稱(chēng)必須與庫(kù)中的類(lèi)名稱(chēng)完全匹配（包括大寫(xiě)！）。如果不完全匹配，則IDE將無(wú)法找到它。庫(kù)中隨附的示例草圖將具有正確的拼寫(xiě)。只需從那里剪切并粘貼即可避免輸入錯(cuò)誤。

多個(gè)版本

如果您有一個(gè)庫(kù)的多個(gè)版本，IDE將嘗試加載所有這些版本。這將導(dǎo)致編譯器錯(cuò)誤。僅重命名庫(kù)文件夾是不夠的。必須將其移出sketchbookLibraries文件夾之外，以便IDE不會(huì)嘗試加載它。

庫(kù)依賴(lài)性

某些庫(kù)依賴(lài)于其他庫(kù)。例如，大多數(shù)Adafruit GraphicDisplay庫(kù)都依賴(lài)于Adafruit GFX庫(kù)。您必須安裝GFX庫(kù)才能使用從屬庫(kù)。

“核心”庫(kù)

某些庫(kù)不能直接使用。 GFX庫(kù)就是一個(gè)很好的例子。它為許多Adafruit顯示器提供了核心圖形功能，但沒(méi)有該顯示器的特定驅(qū)動(dòng)程序庫(kù)就無(wú)法使用。

忘記關(guān)閉IDE

IDE僅在啟動(dòng)時(shí)搜索庫(kù)。您必須先關(guān)閉IDE的所有實(shí)例并重新啟動(dòng)，然后它才能識(shí)別新安裝的庫(kù)。
責(zé)任編輯：wv