QextSerialPort 小记

  • 每一个在Qt下用过串口的同仁应该都对 QextSerialPort 这个第三方类不会感觉陌生。

    http://code.google.com/r/dbzhang800-qextserialport/ 的代码已经合并到主仓库,QextSerialPort-1.2beta1 即将发布,感谢大家关注。 2012.03.16

历史

QextSerialPort 原作者是 Stefan Sander,后来 Michal Policht、 Brandon Fosdick、Liam Staskawicz 均对该库做了大量改进工作。

资料显示:

  • 第一个公开版本 Version 0.1 发布于 2000年12月
  • 软件仓库中的最早的版本 Version 0.8 发布于 2004年12月
    • 仓库地址 http://qextserialport.sf.net

    • 该仓库中最近的一个发布版是 Version 1.2win-alpha,发布于 2007年9月
  • 2009年5月,Liam Staskawicz 将仓库转到
    • http://code.google.com/p/qextserialport/

    • 仓库中最后一次更新是在2010年2月
    • 至今,Version 1.2 发布仍遥遥无期

clones

 http://code.google.com 可见:

已有几十人创建了QextSerialPort仓库的克隆(尽管多数都没有什么更新)。

其他串口类

QSerialDevice

这是俄罗斯的 Денис Шиенков 于2009年7月创建的一个串口类。它提供了QextSerialPort外的另一个选择。

起源:由于QextSerialPort长期没有更新,Денис Шиенков尝试对其重构,但最终发现——如果按照他的想法对代码进行修改,由于改动过大,那么修改后的版本将不再是 QextSerialPort。于是,他在此基础上另其炉灶,创建了 QSerialDevice

仓库早期地址:http://fireforge.net/projects/qserialdevice/

后来转到:https://gitorious.org/qserialdevice

(已有30多人创建了该仓库的克隆)

QSerialPort

仓库地址:https://gitorious.org/inbiza-labs/qserialport

这是2010年9月份创建的一个串口库。

(我没找到该类的起源的更详细的信息,而且该类更新并不及时,最后一次更新在2010年的11月,但也有10多人创建的克隆)

问题

QextSerialPort目前存在不少问题:

  • 授权问题:

google code 中显示的 New BSD License 实不不对的,因为当时仓库转移的时候,必须选择一个开源的协议,Liam Staskawicz 就随便选了一个。直到今年(2011)的9月底,大家似乎才达成一致,采用 MIT 协议。但仓库一直以来(从2010年2月)都没有更新

  • 代码架构:

QextSerialPort,尽管几经修改,但现在的结构,似乎比2007年之前的结构还乱。

  • 例子:

QextSerialPort自带的例子在某些平台下都无法编译(比如MinGW下或VS2008下),这一点是我最无法忍受的。

  • XX:

....

尝试重构

在保持源码兼容性的基础上,对代码进行了一些重构:

仓库:http://code.google.com/r/dbzhang800-qextserialport/

主要改动

  • 使用 D-pointer 和 Q_PRIVATE_SLOT 将私有的成员变量、成员函数 从 QextSerialPort 移动到了 QextSerialPortPrivate 中。

  • 使用 Qt自带的 qdoc3 而不是 doxygen 来作为文档生成工具
  • 在所有源文件头部添加 MIT 授权信息
  • 尝试添加一个私有类 QextWinEventNotifier,当用户安装的是不带有Qt私有文件的SDK时,这个私有类可以自动起作用(替代QWinEventNotifier)[这只是权宜之计,在Qt5中,应该可以让QWinEventNotifier变成公有类,在Qt4.8中,看来是来不及了]。

用法

QextSerialPort 针对qmake做了不少的改进。当使用这个类时,只需要下载所有源码,然后放置到任意目录(一般会是项目中的3rdParty目录)

然后在项目的.pro文件内添加:

include(YourPathToPri/qextserialport.pri)

即可。

除了以源码形式直接整合到项目中,我们可能更喜欢使用动态库或静态库。

此时,我们只要在 qextserialport.pro 的同级目录下创建 config.pri 文件(参考config_example.pri文件)

# uncomment the following line if you want to use qextserialport as library
# QEXTSERIALPORT_LIBRARY = yes

# uncomment the following line too if you want to use it as static library
# QEXTSERIALPORT_STATIC = yes

然后在 buildlib 目录下运行

qmake 
make

即可得到动态库或静态库。剩下的就和直接包含源码一样了,在项目中直接包含qextsrialport.pri即可(它会自动找到动态库或静态库的路径和名字)。

补充一点

似乎国内不少人使用第三方库时,会直接将源码直接拷贝到项目的源码目录中,然后自己将其加入.pro文件内。

尽管这种方法从维护的角度看非常不好,但是最后还是决定提供了该功能:只要将仓库src目录下的所有.cpp/.h和qextsrialport.pri一块拷贝到你的某个目录中,然后在.pro内直接include 该.pri即可。


你可能感兴趣的:(Google,文档,qt,include,library,2010)