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

Details

    • 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)

    Description

      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

      Attachments

        Issue Links

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

          Activity

            People

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

              Dates

                Created:
                Updated:
                Resolved: