主页 | 所有的类 | 主要的类 | 注释的类 | 分组的类 | 函数

Qt插件HOWTO

Qt提供了一个简单地插件接口，可以轻松地生成作为独立组件的定制数据库驱动、图象格式、文本编解码器（text codec）、风格（style）和部件。

警告：Qt 3.0.5对插件的一些方面做了改变，具体涉及到装载、路径操作和库版本。这些变化的结果是，Qt 3.0.4及以前版本编译的插件都不能用于Qt 3.0.5及以后版本。

写一个插件通过以下方式完成：写适当的插件基类的子类，实现几个函数，再添加一个宏。

一共有五个插件基类。派生的插件缺省保存于标准插件目录。

假设你有一个新的风格类，叫做'MyStyle'，你要把它做成插件的形式。需要的代码直截了当：

    class MyStylePlugin : public QStylePlugin
    {
    public:
        MyStylePlugin() {}
        ~MyStylePlugin() {}

        QStringList keys() const { 
            return QStringList() << "MyStyle"; 
        }

        QStyle* create( const QString& key ) { 
            if ( key == "MyStyle" ) 
                return new MyStyle;
            return 0;
        }
    };

    Q_EXPORT_PLUGIN( MyStylePlugin )

构造器和解构器不需要做什么，空的就可以。有两个虚函数一定要实现。第一个是keys()，它返回在插件中实现的类的一个字符串列表。（我们在上面的例子中刚刚实现了一个类。）第二个是一个函数，它返回所要的类的一个对象（或者0，如果插件被要求生成一个不存在的类的对象）。对于QStylePlugin来说，这第二个函数叫做create()。

可以在一个插件里实现任意数目的插件子类，只要他们都是由同一个基类，比如说，QStylePlugin，派生出来的。

对于数据库驱动、图象格式、定制部件和文本编解码器，不需要显式的对象生成过程。Qt会按需求查找并生成他们。风格则是例外，因为你可能想以代码显式地设置一个风格。应用一个风格，可以使用类似代码：

    QApplication::setStyle( QStyleFactory::create( "MyStyle" ) );

有的插件类还需要实现其他函数。关于一个QWidgetPlugin的完全例子，可参见Qt设计器手册中'生成定制部件'一章的'生成定制部件'节。这个例子实现了额外的函数，以把该插件集成到Qt设计器中去。QWidgetFactory类提供了关于QWidgetPlugin的附加信息。

关于每种类型的插件必须要实现哪些虚拟函数，详见该类的文档。

Qt的应用自动辨识哪些插件可用，因为插件都是保存在标准插件子目录下的。为此，应用不需要任何查找和装载插件的代码，既然Qt已自动处理了。

插件的缺省目录是$QTDIR/plugins，每种类型的插件在那种类型的子目录下，比如说，风格（styles）。如果你想要你的应用使用插件但不要标准插件路径，可以让你的安装程序决定你要为插件使用的路径，然后保存该路径，比如说使用QSettings，以使应用在运行时可以读取。之后应用可以用该路径调用QApplication::addLibraryPath()，就可以使用你的插件了。注意，路径的最后部分，也就是说，styles、widgets等等，不能改变。

应用包括一个插件的正规方法是，要么把插件与应用一起编译，要么把插件编译为DLL（或者so或者其他平台指定的库类型），像其他库那样使用。如果要让插件可装载，一个方法是，生成一个应用下的子目录，例如，appdir/plugins/designer，把插件放置到该目录下。

装载与校验插件

在装载插件时，Qt库做了一些稳健的检查，以确定插件是否可以装载和使用。这一点保证了多重版本的能力和分头所安装的Qt库的配置。

• 与高一点的主版本和／或次版本的Qt库链接的插件，不能被低的主版本和／或次版本的库所装载。（译者注：补丁版本不限）

  原因解释：

  依靠新的Qt库而链接的插件可能使用了一些旧版本没有的新特性。Trolltech有一项政策：只在次级发布（minor release）之间添加新特性和API，这就是为什么本测试只看主版本号和次版本号，不看补丁级版本号的缘故。

• 依靠带有线程支持的Qt库而链接的插件，只能被带有线程支持的Qt库所装载。

  原因解释：

  线程和非线程的Qt库有不同的名称。带有线程支持的库装载一个依靠不带有线程支持的Qt库而链接的插件，将会导致在内存中同时有同一库的两个版本。在UNIX系统中，这会导致非线程Qt库被装载。这时，Qt库中的所有静态对象的构造器都会被调用第二次，但是它们是对已经在内存中的对象进行操作。没有办法绕过这一点，因为这是对象二进制格式的一个特征：已经被线程Qt库定义的静态符号，不能在被非线程Qt库被装载的时候被替换或者拷贝。

• 依靠不带有线程支持的Qt库而链接的插件，只能被不带有线程支持的Qt库所装载。

  原因解释：

  参见上面的解释。

• 从Qt 3.0.5开始，Qt库与所有插件都使用联编关键字（build key）来联编。Qt库中的联编关键字被与插件中的联编关键字对照，如果相符，插件就被装载。如果联编关键字不符，Qt库就拒绝装载该插件。

  原因解释：

  参见下面对于build key的解释。

联编关键字（build key）

联编关键字包含一下信息：

• 体系结构（Architecture）、操作系统和编译器。

  原因解释：

  在同一编译器的不同版本并不产生二进制兼容代码的场合，编译器的版本也体现在联编关键字里。

• Qt的配置。这个配置是一个列表，包括了影响库中可用到的API的那些缺少的特性。

  原因解释：

  两个同一版本的Qt库的不同配置不是二进制兼容的。装载插件的Qt库使用这个（缺少的）特性列表来判断插件是不是二进制兼容的。

  注意：也存在这种情况，插件可以使用在两个不同配置里可用到的特性。但是，编写插件的开发者需要知道，哪些特性在他们的插件和Qt的公用工具类中都在被使用。Qt库在装载插件时会需要复杂的特性与依赖性的查询确认。这些需求给开发者添了一个不必要的负担，也增加了装载插件的系统开销。为了减少开发时间，降低应用的运行时消耗，可以使用对联编关键字的简单字符串比较。

• 可选地，可以在配置脚本命令行指定一个附加的字符串。

  原因解释：

  在发布带有应用的Qt库的二进制时，这给开发者提供了一个办法，来编写只能被插件以之链接的那个库所装载的插件。

插件与线程应用

如果你想联编一个使用线程Qt库的插件（不管插件本身是否使用线程），你必须使用线程环境。具体说来，你必须用线程Qt库链接插件，必须用该库联编Qt设计器。你用于插件的.pro文件必须包括这一行：

    CONFIG += thread

警告：不要在应用中混用一般的Qt库与线程Qt库。如果你的应用使用了线程Qt库，你不应该用一般Qt库链接你的插件，也不应该动态装载一般Qt库或者动态装载依赖一般Qt库的另一个库，比如一个插件。在一些系统中，混用线程与非线程库或者插件会破坏（corrupt）Qt库中使用的静态数据。