安裝第三方 86Duino 函式庫

安裝第三方函式庫至 86Duino

當使用者對 86Duino 內建的標準函式庫相當熟悉了以後,也許想要加入額外的函式庫來擴展 86Duino 功能。

函式庫是什麼?

函式庫可以是包含連結感測器、顯示器、模組等等的相關程式碼。例如,內建的 LiquidCrystal library 可以幫助使用者輕鬆的與 LCD 顯示器溝通。在網路上,有數以百計的第三方函式庫可供下載。86Duino 內建的標準函式庫以及第三方函式庫清單可 點此參考。注意:在使用第三方函式庫之前,必須先安裝它。

如何安裝函式庫

函式庫通常是以 zip 檔或資料夾型式來發佈的。資料夾名稱即為程式庫名稱。資料夾內通常包含 .cpp檔、.h 檔、keywords.txt 檔、範例資料夾以及其他函式庫需要的檔案。

自動安裝

安裝第三方函式庫至開發環境,首先請勿解壓縮下載後的函式庫壓縮檔。

在 86Duino 開發環境,將滑鼠游標移至 草稿碼 > 匯入函式庫,並在下拉式選單中點選最頂端的 “Add Library”。

addLIB

此時開發環境將提示選擇想加入的函式庫,請選擇想加入的 .zip 檔並開啟。

chooseLIB

回到 草稿碼 > 匯入程式庫 的選單。此時應該可以看到剛剛加入的函式庫顯示在下拉式選單中的底端,這代表該函式庫已經匯入至 86Duino IDE。

showLIB

被加入的 zip 檔將被解壓縮在 86Duino 草稿碼資料夾內的 libraries 資料夾中。

注意:雖然草稿碼內可以立即使用此函式庫,但是此函式庫的範例,必需重新啟動 86Duino IDE 後才會顯示於 檔案 > 範例 選單內。

手動安裝

要手動安裝函式庫,首先關閉 86Duino 開發環境。

再來解壓縮包含函式庫的 zip 檔案。例如:若要安裝的程式庫稱為 “DuinoParty”,解壓縮後資料夾應該是 DuinoParty,內部應包含 DuinoParty.cpp 以及 DuinoParty.h 檔。(若 .cpp.h 檔不在資料夾內,則必須自行建立。以上面為例,此時使用者必須建立 DuinoParty.cppDuinoParty.h。)

接下來,需要將 DuinoParty 資料夾放入特定資料夾內。在 Windows 系統,須放入 ”My Documents\86Duino\libraries” 資料夾內。在 Mac 系統,須放入 ”Documents/86Duino/libraries” 資料夾內。在 Linux 系統,須放入草稿碼簿的 ”libraries” 內。

把函式庫放入後,開啟函式庫資料夾應看到下列檔案。(Window 系統下):

My Documents\86Duino\libraries\DuinoParty\DuinoParty.cpp
My Documents\86Duino\libraries\DuinoParty\DuinoParty.h
My Documents\86Duino\libraries\DuinoParty\examples
....

Mac 系統下:

Documents/86Duino/libraries/DuinoParty/DuinoParty.cpp
Documents/86Duino/libraries/DuinoParty/DuinoParty.h
Documents/86Duino/libraries/DuinoParty/examples
...

Linux 系統下與 Mac 系統雷同。

函式庫內也有可能包含一些必要但不是 .cpp.h 的檔案,此時只要確認這些檔與 .cpp 檔在同一資料夾即可。(若是直接將 .cpp.h 放入 libraries 資料夾下或是存在巢狀資料夾的情況,例如:

Documents\86Duino\libraries\DuinoParty.cpp

以及

Documents\86Duino\libraries\DuinoParty\DuinoParty\DuinoParty.cpp

這樣的情況下,加入的函式庫將無法正常動作。)

最後重新啟動 86Duino 開發環境,確認新加入的程式庫有出現在 草稿碼 > 匯入程式庫 功能表內。

若成功出現,代表你已經完成手動函式庫的安裝。


新手上路主頁面

The text of the 86Duino reference is a modification of the Arduino reference, and is licensed under a Creative Commons Attribution-ShareAlike 3.0 License. Code samples in the reference are released into the public domain.