diff options
author | Kai Koehne <kai.koehne@nokia.com> | 2010-03-04 16:17:02 +0100 |
---|---|---|
committer | Kai Koehne <kai.koehne@nokia.com> | 2010-03-04 16:32:37 +0100 |
commit | 0714893c8f2066b166d5f49254f9a5112b9cbbbe (patch) | |
tree | 1258c95d59c6db914cbd10dc138bb985c4f258f1 /README | |
parent | dd062b30f344869d842d5dffd3a16b721dc3de69 (diff) | |
download | qt-creator-0714893c8f2066b166d5f49254f9a5112b9cbbbe.tar.gz |
QmlDesigner/QmlInspector: Document private headers dependency
Users also can now explicitly set the path to the private
header files by passing "QT_PRIVATE_HEADERS=$PATH" to qmake,
or force qmake to ignore the plugins by passing in an invalid
/empty path.
Reviewed-by: con
Diffstat (limited to 'README')
-rw-r--r-- | README | 25 |
1 files changed, 25 insertions, 0 deletions
@@ -26,6 +26,31 @@ cd $BUILD_DIRECTORY qmake $SOURCE_DIRECTORY/qtcreator.pro make (or mingw32-make or nmake or jom, depending on your platform) +QmlDesigner, QmlInspector require private headers +------------------------------------------------- + +The QmlDesigner and QmlInspector plugins depend on "private" Qt headers, +specifically from the QtDeclarative module. These private headers always end +with an "_p.h", and Nokia does not make any promises to keep the files or API's +binary or source compatible between releases. This means that when compiled, +the two plugins have a dependency to the exact Qt version they were compiled +with. Running Qt Creator with the plugins against updated Qt libraries (also for +patch releases) might lead to link time failures, or even crashes. + +If you want to disable the plugins, you can pass "QT_PRIVATE_HEADERS=" to qmake: + + qmake "QT_PRIVATE_HEADERS=" $SOURCE_DIRECTORY/qtcreator.pro + +Anyhow, the plugins will not be compiled when the private header files needed +are not found. This might be the case when you are using a Qt version from your +distribution, or when you installed your self-compiled Qt to a separate +directory via 'make install'. You can fix this by either re-building your Qt +with the "-developer-build" configure option, or pass the include directory in +the source directory to qmake, e.g. + + qmake "QT_PRIVATE_HEADERS=$$QT_SOURCE_TREE/include" $SOURCE_DIRECTORY/qtcreator.pro + + Third-party components ====================== Qt Creator includes the following third-party components, |