为 Arduino 集成开发环境安装扩展类库

当你已经下载并使用了 Arduino 内置例程一段时间之后,您会感觉遇到了瓶颈,因为现有的功能已经完全不能满足您无穷无尽的想法,而迫切需要扩展自己的 Arduino 主控板,这个时候,您需要学习和搜集更多的扩展类库,以丰富自己的知识和想法。

什么是扩展类库?

扩展类库是一组代码,使您可以轻松地连接到一个传感器,显示模块等。例如,Arduino 内置库 LiquidCrystal 使得它容易沟通字符的 LCD 显示屏模块。在互联网上有数以百计的额外的库可供下载,Arduino 内置的例程和类库可供参考。若要使用其他的库,您将需要手动安装。

如何安装扩展类库?

扩展类库通常被封装成 ZIP 文件或者一个文件夹,解压缩后的文件夹名通常就是类库的名称,文件夹中一般会存在多个 .h (声明)头文件和 .cpp (实现)文件,同时附带 keywords.txt 文件、examples 例程文件夹和其他需要继承的类库。

准备安装之前,须确认已经将所有的 Arduino 开发工具窗口保存并关闭退出。

如果你要安装的类库名称是 ArduinoParty,那我们就通常需要解压缩一个 ArduinoParty.zip 文件。解压缩后就可以找到一个 ArduinoParty 文件夹,打开这个文件夹就可以看到 ArduinoParty.cpp 和 ArduinoParty.h 文件,如果 .cpp 和 .h 文件并没有在 ArduinoParty 文件夹里面,您需要手动创建一个文件夹,并命名为 ArduinoParty,再把这个文件夹复制到下面对应的路径:在 Windows 操作系统下,类库保存在 “”;在 Mac OS 下,类库保存在 ”Documents/Arduino/libraries” 文件夹下;在 Linux 系统下,类库需要保存在项目文件夹下的 “libraries”。

在 Windows 操作系统下,类库存放位置如下:

My Documents\Arduino\libraries\ArduinoParty\实现文件.cpp
My Documents\Arduino\libraries\ArduinoParty\声明头文件.h
My Documents\Arduino\libraries\ArduinoParty\examples
….

在 Mac OS 系统下,我们按照一下路径安装:

Documents/Arduino/libraries/ArduinoParty/实现文件.cpp
Documents/Arduino/libraries/ArduinoParty/声明头文件.h
Documents/Arduino/libraries/ArduinoParty/examples

在 Linux 操作系统下的安装过程和 Mac OS 类似,但是注意以下两种情况类库将无法导入:

.cpp 和 .h 文件直接放在 libraries 文件夹下:Documents\Arduino\libraries\ArduinoParty.cpp

.cpp 和 .h 文件直接放在更多级目录下:Documents\Arduino\libraries\ArduinoParty\ArduinoParty\ArduinoParty.cpp

重启 Arduino 开发环境,在编写自己的程序时候,就可以在菜单栏中点击 Sketch -> Import 导入需要的类库了。

好了,现在您已经成功安装了一个类库。

本教程原文由 Limor Fried 撰写,TONYLABS 译。