零知开发工具-增加本地库功能使用说明

应大家的建议，在新版零知开发工具3.22版本中加入了从本地新增库的功能，下面说明使用方法：

1、下载到本地

        首先我们需要下载第三方的软件库或者自己的软件库，放置到电脑某个位置，这里我以 @liu118 建议的PID库为例；从git下载后这里放置到如下位置：

上面的库时下载好PID库后，目录结构如上图。

2、目录结构要求

为例使用更加规范化，目录结构需要符合以下要求：

（1）有src目录，里面放置源码文件cpp\h等文件；

（2）有library.properties库的说明文件；

（3）可选：examples文件，这里的examples可选的，如果有则在安装后会显示到零知开发工具的【欢迎】页面。

（4）libinfo.ini 文件，这个文件用于版本号和在零知开发工具库管理界面显示信息。

因此我们需要对不规范的库文件进行调整下，这里新建src目录，然后把cpp和h文件放置到src目录中，更改后如下：

注：如果符合该规范的库就不需要进行调整了，基本上现在第三方库都是符合如上面文件结构的，不需要任何更改的。

3、安装

我们打开零知开发工具，然后打开【库】页面，然后点击【从本地安装】：

然后出现如下界面：

我们根据库的类别，比如这个PID库是个算法相关的，和硬件关系不大，就可以通用的，我们选择【通用】，然后选择我们下载好的PID文件夹：

选择后如下：

我们点击【安装】，出现提示“成功”信息，如果失败了，请检查是不是库符合上面说的几个要求。

4、安装成功

我们现在再打开【欢迎】界面，然后就可以看到库的示例了（有时候没有出现，可以点击切换板子型号，再看看）：

这里就说明已经安装好了，我们就可以打开它自带的例子或者调用这个PID算法库愉快的玩耍了。

5、libinfo.ini 文件这个文件用于在库管理界面显示库的显示，比如如下示例：

复制
																		
name=Adafruit_SSD1306
libver=1.0
classname=Adafruit_SSD1306
incfile=Adafruit_SSD1306.h
brief=SSD1306 OLED显示屏接口驱动，包含SPI或IIC接口方式。
																		

分别为库的名字、库的版本、库的类名、头文件、描述。

---