Qt Creator JS中有哪些JS对象：变量扩展？

Question

Qt Creator的向导和配置设置支持variable expansion，包括评估JavaScript表达式，例如： C++ class wizard file template包含：

%{JS: Cpp.openNamespaces('%{Class}')}

Cpp似乎是一个全球性的对象。 Qt Creator中的来源是那些定义的，哪些可用？

这些都没有记录在任何地方

Answer 1

JavaScript变量扩展由核心插件中的JsExpander执行。扩展器可以注册QObject实例并将它们公开为全局JS对象的属性。

要查找所有这些全局对象，请搜索registerQObjectForJs方法调用。见github search results for this method。

从Qt Creator 4.2.1开始，直到至少4.6，以下是唯一注册的对象：

• Util - 露出Internal::UtilsJsExtension，
• Cpp - 露出CppTools::Internal::CppToolsJsExtension，
• Modeling - 露出ModelEditor::Internal::JsExtension，
• QtSupport - 露出QtSupport::CodeGenerator，
• Vcs - 露出VcsBase::Internal::VcsJsExtension。

方法参数类型由QJSEngine映射到JavaScript类型。例如。要获得Qt包含，可以进行以下替换：

%{JS: QtSupport.qtIncludes([ '%{Base}' ], [ '%{Base}' ])}

鉴于签名

QString qtIncludes(const QStringList &qt4, const QStringList &qt5)

方法列表如下。

Util

QString toNativeSeparators(const QString &in) const;
QString fromNativeSeparators(const QString &in) const;

QString baseName(const QString &in) const;
QString fileName(const QString &in) const;
QString completeBaseName(const QString &in) const;
QString suffix(const QString &in) const;
QString completeSuffix(const QString &in) const;
QString path(const QString &in) const;
QString absoluteFilePath(const QString &in) const;

QString relativeFilePath(const QString &path, const QString &base) const;

// File checks:
bool exists(const QString &in) const;
bool isDirectory(const QString &in) const;
bool isFile(const QString &in) const;

// MimeDB:
QString preferredSuffix(const QString &mimetype) const;

// Generate filename:
QString fileName(const QString &path,
                             const QString &extension) const;

// Generate temporary file:
QString mktemp(const QString &pattern) const;

// Generate a ascii-only string:
QString asciify(const QString &input) const;

Cpp

// Generate header guard:
QString headerGuard(const QString &in) const;

// Fix the filename casing as configured in C++/File Naming:
QString fileName(const QString &path, const QString &extension) const;

// Work with classes:
QStringList namespaces(const QString &klass) const;
QString className(const QString &klass) const;
QString classToFileName(const QString &klass,
                                    const QString &extension) const;
QString classToHeaderGuard(const QString &klass, const QString &extension) const;
QString openNamespaces(const QString &klass) const;
QString closeNamespaces(const QString &klass) const;

Modeling

QString fileNameToElementName(const QString &file);
QString elementNameToFileName(const QString &element);

QtSupport

// Ui file related:
// Change the class name in a UI XML form
QString changeUiClassName(const QString &uiXml, const QString &newUiClassName);

QString uiClassName(const QString &uiXml);

// Generic Qt:
QString qtIncludes(const QStringList &qt4, const QStringList &qt5);

Vcs

bool isConfigured(const QString &vcsId) const;
QString displayName(const QString &vcsId) const;

Answer 2

注意通过macroexpander公开的几个JS变量：https://github.com/qt-creator/qt-creator/blob/master/src/plugins/coreplugin/coreplugin.cpp#L169也很有用