安装第三方 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.