安裝第三方 86Duino 函式庫
安裝第三方函式庫至 86Duino
當使用者對 86Duino 內建的標準函式庫相當熟悉了以後,也許想要加入額外的函式庫來擴展 86Duino 功能。
函式庫是什麼?
函式庫可以是包含連結感測器、顯示器、模組等等的相關程式碼。例如,內建的 LiquidCrystal library 可以幫助使用者輕鬆的與 LCD 顯示器溝通。在網路上,有數以百計的第三方函式庫可供下載。86Duino 內建的標準函式庫以及第三方函式庫清單可 點此參考。注意:在使用第三方函式庫之前,必須先安裝它。
如何安裝函式庫
函式庫通常是以 zip 檔或資料夾型式來發佈的。資料夾名稱即為程式庫名稱。資料夾內通常包含 .cpp
檔、.h
檔、keywords.txt
檔、範例
資料夾以及其他函式庫需要的檔案。
自動安裝
安裝第三方函式庫至開發環境,首先請勿解壓縮下載後的函式庫壓縮檔。
在 86Duino 開發環境,將滑鼠游標移至 草稿碼 > 匯入函式庫,並在下拉式選單中點選最頂端的 “Add Library”。
此時開發環境將提示選擇想加入的函式庫,請選擇想加入的 .zip
檔並開啟。
回到 草稿碼 > 匯入程式庫 的選單。此時應該可以看到剛剛加入的函式庫顯示在下拉式選單中的底端,這代表該函式庫已經匯入至 86Duino IDE。
被加入的 zip 檔將被解壓縮在 86Duino 草稿碼資料夾內的 libraries
資料夾中。
注意:雖然草稿碼內可以立即使用此函式庫,但是此函式庫的範例,必需重新啟動 86Duino IDE 後才會顯示於 檔案 > 範例 選單內。
手動安裝
要手動安裝函式庫,首先關閉 86Duino 開發環境。
再來解壓縮包含函式庫的 zip 檔案。例如:若要安裝的程式庫稱為 “DuinoParty”,解壓縮後資料夾應該是 DuinoParty
,內部應包含 DuinoParty.cpp
以及 DuinoParty.h
檔。(若 .cpp
與 .h
檔不在資料夾內,則必須自行建立。以上面為例,此時使用者必須建立 DuinoParty.cpp
與 DuinoParty.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.