Uploaded image for project: 'Qt'
  1. Qt
  2. QTBUG-116209

Document that toggling features in a Qt build should be done after removing CMakeCache.txt

XMLWordPrintable

    • 58ca23500 (dev), dc303732e (6.5), 86ad2f623 (6.6), c1d235685 (dev), 65e04162d (dev), 43326b380 (6.6), 010ab170c (6.6), b52817db1 (tqtc/lts-6.5), 26f7096bf (tqtc/lts-6.5)

      There are a few things to mention.

      Sometimes users might want to toggle a feature either ON or OFF after an initial configuration of Qt.
      We have a mechanism that tries to support that, but it might not always be reliable.

      For example in a -developer-build, qt_find_package won't look for packages on reconfiguration, so even though a feature is toggled on, it's associated 3rd party package might not be found on reconfiguration.

      And toggling -developer-build itself is risky, because of its overloaded meaning.
      Are we switching from a -prefix build to a no-prefix one, or vice versa?
      Is it just about private tests?

      The safest thing we can offer (in my opinion) is to document that any toggling of Qt features should be done after CMakeCache.txt is removed.

      We could document that at https://doc.qt.io/qt-6/configure-options.html#including-or-excluding-features

      When using configure, that can also be done using the -redo option.

      Also for -developer-builds, we can try to add some checks to ensure it's never accidentally toggled, or investigate if we can make it work just for the private_tests part, and not for the -no-prefix part.
      The reason to do that check is that sometimes Qt Creator seems to toggle it. See

      https://bugreports.qt.io/browse/QTBUG-112957?focusedId=739922&page=com.atlassian.jira.plugin.system.issuetabpanels%3Acomment-tabpanel#comment-739922

        No reviews matched the request. Check your Options in the drop-down menu of this sections header.

            alexandru.croitor Alexandru Croitor
            alexandru.croitor Alexandru Croitor
            Votes:
            0 Vote for this issue
            Watchers:
            2 Start watching this issue

              Created:
              Updated:
              Resolved: