如何在Qt中向后移植功能

Question

假设有一个项目使用Qt，并且依赖于新版本Qt中存在的功能(例如添加的类成员(。该项目旨在使用Qt的"系统"/分发版本构建，该版本可能比项目所依赖的版本旧。

幼稚的方法会导致预处理器地狱：

void Class::foo() {
#if QT_VERSION >= QT_VERSION_CHECK(...)
  QClass::newFangled();
#else
  QClass::oldFangled1();
  blurble();
#endif
}

有没有一种更干净的方法，在使用该功能时不依赖于预处理器宏？ 即我们不希望：

// THIS IS BLAH
#if QT_VERSION >= QT_VERSION_CHECK(...)
#define QClass_newFangled QClass::newFangled
#else
#define QClass_newFangled [this]{ 
   QClass::oldFangled1(); 
   blurble(); 
}
#endif
void Class::foo() {
  QClass_newFangled();
}

Answer 1

一种可行的方法是在自定义命名空间中使用给定的类或全局函数。该命名空间中的类/函数可以从Qt导入而无需更改，也可以是向后移植所需功能的自定义类/函数。

下面的代码是Qt-namespace-aware的：它将与命名空间的Qt构建一起使用。

在使用点，向后移植的功能(全局函数和类(在compat命名空间中访问，即

void test() {
  ...
  qDebug() << compat::qEnvironmentVariableIntValue("RUNMODE");
  compat::QTimer::singleShot(1000, object, []{ ... });
}

请注意，将具有默认参数的函数/方法添加到 compat 命名空间时，默认参数仅在 C++17 及更高版本中传播。否则，我们必须通过定义转发函数/方法自己处理它们。

向后移植全局函数

假设我们想从Qt 5.5向后移植qEnvironmentVariableIntValue：

// INTERFACE
namespace compat {
#if QT_VERSION >= QT_VERSION_CHECK(5,5,0)
#if __cplusplus >= 201703L
using QT_PREPEND_NAMESPACE(qEnvironmentVariableIntValue); // C++17
#else
int inline qEnvironmentVariableIntValue(const char *varName, bool *ok = {}) {
  return QT_PREPEND_NAMESPACE(qEnvironmentVariableIntValue)(varName, ok);
}
#endif
#else
int qEnvironmentVariableIntValue(const char *varName, bool *ok = {});
#endif
} // compat

// IMPLEMENTATION
namespace compat {
#if QT_VERSION < QT_VERSION_CHECK(5,5,0)
using QT_PREPEND_NAMESPACE(qgetenv); // C++17
int qEnvironmentVariableIntValue(const char *varName, bool *ok) {
  return qgetenv(varName).toInt(ok, 0);
}
#endif // Qt<5.5
} // compat

向后移植到类中

假设我们想向后移植Qt 5.4的QTimer::singleShot(int, QObject*, Functor)，正如这个答案所激发的那样：

// INTERFACE
namespace compat {
#if QT_VERSION >= QT_VERSION_CHECK(5,4,0)
using QT_PREPEND_NAMESPACE(QTimer);
#else
using Q_QTimer = QT_PREPEND_NAMESPACE(QTimer);
class QTimer : public Q_QTimer {
  Q_OBJECT
public:
  #if __cplusplus >= 201703L
  using Q_QTimer::Q_QTimer; // C++17
  #else
  QTimer(QObject *parent = {}) : Q_QTimer(parent) {}
  #endif
  template <class Functor> static void singleShot(int, QObject *, Functor &&);
};
template <class Functor>
void QTimer::singleShot(int msec, QObject *context, Functor &&fun) {
  ...
}
#endif
} // compat