summaryrefslogtreecommitdiffstats
path: root/tests/auto/corelib/plugin/qfactoryloader/tst_qfactoryloader.cpp
blob: faec311f2ddbf75cced5b549c72102d7697913a6 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
// Copyright (C) 2016 The Qt Company Ltd.
// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GPL-3.0-only

#include <QtTest/qtest.h>
#include <QtCore/qdir.h>
#include <QtCore/qfileinfo.h>
#include <QtCore/qplugin.h>
#include <QtCore/qversionnumber.h>
#include <private/qfactoryloader_p.h>
#include <private/qlibrary_p.h>
#include "plugin1/plugininterface1.h"
#include "plugin2/plugininterface2.h"

#if !QT_CONFIG(library)
Q_IMPORT_PLUGIN(Plugin1)
Q_IMPORT_PLUGIN(Plugin2)
#endif

class tst_QFactoryLoader : public QObject
{
    Q_OBJECT

    QString binFolder;
public slots:
    void initTestCase();

private slots:
    void usingTwoFactoriesFromSameDir();
    void extraSearchPath();
    void multiplePaths();
    void staticPlugin_data();
    void staticPlugin();
};

static const char binFolderC[] = "bin";

void tst_QFactoryLoader::initTestCase()
{
    // On Android the plugins are bundled into APK's libs subdir
#ifndef Q_OS_ANDROID
    binFolder = QFINDTESTDATA(binFolderC);
    QVERIFY2(!binFolder.isEmpty(), "Unable to locate 'bin' folder");
#endif
}

void tst_QFactoryLoader::usingTwoFactoriesFromSameDir()
{
#if QT_CONFIG(library) && !defined(Q_OS_ANDROID)
    // set the library path to contain the directory where the 'bin' dir is located
    QCoreApplication::setLibraryPaths( { QFileInfo(binFolder).absolutePath() });
#endif
    auto versionNumber = [](const QCborValue &value) {
        // Qt plugins only store major & minor versions in the metadata, so
        // the low 8 bits are always zero.
        qint64 v = value.toInteger();
        return QVersionNumber(v >> 16, uchar(v >> 8));
    };
    QVersionNumber qtVersion(QT_VERSION_MAJOR, 0);

    const QString suffix = QLatin1Char('/') + QLatin1String(binFolderC);
    QFactoryLoader loader1(PluginInterface1_iid, suffix);
    const QFactoryLoader::MetaDataList list1 = loader1.metaData();
    const QList<QCborArray> keys1 = loader1.metaDataKeys();
    QCOMPARE(list1.size(), 1);
    QCOMPARE(keys1.size(), 1);
    QCOMPARE_GE(versionNumber(list1[0].value(QtPluginMetaDataKeys::QtVersion)), qtVersion);
    QCOMPARE(list1[0].value(QtPluginMetaDataKeys::IID), PluginInterface1_iid);
    QCOMPARE(list1[0].value(QtPluginMetaDataKeys::ClassName), "Plugin1");

    // plugin1's Q_PLUGIN_METADATA has FILE "plugin1.json"
    QCborValue metadata1 = list1[0].value(QtPluginMetaDataKeys::MetaData);
    QCOMPARE(metadata1.type(), QCborValue::Map);
    QCOMPARE(metadata1["Keys"], QCborArray{ "plugin1" });
    QCOMPARE(keys1[0], QCborArray{ "plugin1" });
    QCOMPARE(loader1.indexOf("Plugin1"), 0);
    QCOMPARE(loader1.indexOf("PLUGIN1"), 0);
    QCOMPARE(loader1.indexOf("Plugin2"), -1);

    QFactoryLoader loader2(PluginInterface2_iid, suffix);
    const QFactoryLoader::MetaDataList list2 = loader2.metaData();
    const QList<QCborArray> keys2 = loader2.metaDataKeys();
    QCOMPARE(list2.size(), 1);
    QCOMPARE(keys2.size(), 1);
    QCOMPARE_GE(versionNumber(list2[0].value(QtPluginMetaDataKeys::QtVersion)), qtVersion);
    QCOMPARE(list2[0].value(QtPluginMetaDataKeys::IID), PluginInterface2_iid);
    QCOMPARE(list2[0].value(QtPluginMetaDataKeys::ClassName), "Plugin2");

    // plugin2's Q_PLUGIN_METADATA does not have FILE
    QCOMPARE(list2[0].value(QtPluginMetaDataKeys::MetaData), QCborValue());
    QCOMPARE(keys2[0], QCborArray());
    QCOMPARE(loader2.indexOf("Plugin1"), -1);
    QCOMPARE(loader2.indexOf("Plugin2"), -1);

    QObject *obj1 = loader1.instance(0);
    PluginInterface1 *plugin1 = qobject_cast<PluginInterface1 *>(obj1);
    QVERIFY2(plugin1,
             qPrintable(QString::fromLatin1("Cannot load plugin '%1'")
                        .arg(QLatin1String(PluginInterface1_iid))));
    QCOMPARE(obj1->metaObject()->className(), "Plugin1");

    QObject *obj2 = loader2.instance(0);
    PluginInterface2 *plugin2 = qobject_cast<PluginInterface2 *>(obj2);
    QVERIFY2(plugin2,
             qPrintable(QString::fromLatin1("Cannot load plugin '%1'")
                        .arg(QLatin1String(PluginInterface2_iid))));
    QCOMPARE(obj2->metaObject()->className(), "Plugin2");

    QCOMPARE(plugin1->pluginName(), QLatin1String("Plugin1 ok"));
    QCOMPARE(plugin2->pluginName(), QLatin1String("Plugin2 ok"));
}

void tst_QFactoryLoader::extraSearchPath()
{
#if defined(Q_OS_ANDROID) && !QT_CONFIG(library)
    QSKIP("Test not applicable in this configuration.");
#else
#ifdef Q_OS_ANDROID
    // On Android the libs are not stored in binFolder, but bundled into
    // APK's libs subdir
    const QStringList androidLibsPaths = QCoreApplication::libraryPaths();
    QCOMPARE(androidLibsPaths.size(), 1);
#endif
    QCoreApplication::setLibraryPaths(QStringList());

#ifndef Q_OS_ANDROID
    QString pluginsPath = QFileInfo(binFolder).absoluteFilePath();
    QFactoryLoader loader1(PluginInterface1_iid, "/nonexistent");
#else
    QString pluginsPath = androidLibsPaths.first();
    // On Android we still need to specify a valid suffix, because it's a part
    // of a file name, not directory structure
    const QString suffix = QLatin1Char('/') + QLatin1String(binFolderC);
    QFactoryLoader loader1(PluginInterface1_iid, suffix);
#endif

    // it shouldn't have scanned anything because we haven't given it a path yet
    QVERIFY(loader1.metaData().isEmpty());

    loader1.setExtraSearchPath(pluginsPath);
    PluginInterface1 *plugin1 = qobject_cast<PluginInterface1 *>(loader1.instance(0));
    QVERIFY2(plugin1,
             qPrintable(QString::fromLatin1("Cannot load plugin '%1'")
                        .arg(QLatin1String(PluginInterface1_iid))));

    QCOMPARE(plugin1->pluginName(), QLatin1String("Plugin1 ok"));

    // check that it forgets that plugin
    loader1.setExtraSearchPath(QString());
    QVERIFY(loader1.metaData().isEmpty());
#endif
}

void tst_QFactoryLoader::multiplePaths()
{
#if !QT_CONFIG(library) || !(defined(Q_OS_UNIX) && !defined(Q_OS_DARWIN)) || defined(Q_OS_ANDROID)
    QSKIP("Test not applicable in this configuration.");
#else
    QTemporaryDir dir;
    QVERIFY(dir.isValid());

    QString pluginsPath = QFileInfo(binFolder, binFolderC).absolutePath();
    QString linkPath = dir.filePath(binFolderC);
    QVERIFY(QFile::link(pluginsPath, linkPath));

    QCoreApplication::setLibraryPaths({ QFileInfo(binFolder).absolutePath(), dir.path() });

    const QString suffix = QLatin1Char('/') + QLatin1String(binFolderC);
    QFactoryLoader loader1(PluginInterface1_iid, suffix);

    QLibraryPrivate *library1 = loader1.library("plugin1");
    QVERIFY(library1);
    QCOMPARE(library1->loadHints(), QLibrary::PreventUnloadHint);
#endif
}

Q_IMPORT_PLUGIN(StaticPlugin1)
Q_IMPORT_PLUGIN(StaticPlugin2)
constexpr bool IsDebug =
#ifdef QT_NO_DEBUG
        false &&
#endif
        true;

void tst_QFactoryLoader::staticPlugin_data()
{
    QTest::addColumn<QString>("iid");
    auto addRow = [](const char *iid) {
        QTest::addRow("%s", iid) << QString(iid);
    };
    addRow("StaticPlugin1");
    addRow("StaticPlugin2");
}

void tst_QFactoryLoader::staticPlugin()
{
    QFETCH(QString, iid);
    QFactoryLoader loader(iid.toLatin1(), "/irrelevant");
    QFactoryLoader::MetaDataList list = loader.metaData();
    QCOMPARE(list.size(), 1);

    QCborMap map = list.at(0).toCbor();
    QCOMPARE(map[int(QtPluginMetaDataKeys::QtVersion)],
            QT_VERSION_CHECK(QT_VERSION_MAJOR, QT_VERSION_MINOR, 0));
    QCOMPARE(map[int(QtPluginMetaDataKeys::IID)], iid);
    QCOMPARE(map[int(QtPluginMetaDataKeys::ClassName)], iid);
    QCOMPARE(map[int(QtPluginMetaDataKeys::IsDebug)], IsDebug);

    QCborValue metaData = map[int(QtPluginMetaDataKeys::MetaData)];
    QVERIFY(metaData.isMap());
    QCOMPARE(metaData["Keys"], QCborArray{ "Value" });
    QCOMPARE(loader.metaDataKeys(), QList{ QCborArray{ "Value" } });
    QCOMPARE(loader.indexOf("Value"), 0);

    // instantiate
    QObject *instance = loader.instance(0);
    QVERIFY(instance);
    QCOMPARE(instance->metaObject()->className(), iid);
}

QTEST_MAIN(tst_QFactoryLoader)
#include "tst_qfactoryloader.moc"