/**************************************************************************** ** ** Copyright (C) 2013 Research In Motion. ** Contact: http://www.qt-project.org/legal ** ** This file is part of the tools applications of the Qt Toolkit. ** ** $QT_BEGIN_LICENSE:LGPL$ ** Commercial License Usage ** Licensees holding valid commercial Qt licenses may use this file in ** accordance with the commercial license agreement provided with the ** Software or, alternatively, in accordance with the terms contained in ** a written agreement between you and Digia. For licensing terms and ** conditions see http://qt.digia.com/licensing. For further information ** use the contact form at http://qt.digia.com/contact-us. ** ** GNU Lesser General Public License Usage ** Alternatively, this file may be used under the terms of the GNU Lesser ** General Public License version 2.1 as published by the Free Software ** Foundation and appearing in the file LICENSE.LGPL included in the ** packaging of this file. Please review the following information to ** ensure the GNU Lesser General Public License version 2.1 requirements ** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html. ** ** In addition, as a special exception, Digia gives you certain additional ** rights. These rights are described in the Digia Qt LGPL Exception ** version 1.1, included in the file LGPL_EXCEPTION.txt in this package. ** ** GNU General Public License Usage ** Alternatively, this file may be used under the terms of the GNU ** General Public License version 3.0 as published by the Free Software ** Foundation and appearing in the file LICENSE.GPL included in the ** packaging of this file. Please review the following information to ** ensure the GNU General Public License version 3.0 requirements will be ** met: http://www.gnu.org/copyleft/gpl.html. ** ** ** $QT_END_LICENSE$ ** ****************************************************************************/ #include "conf.h" #include #ifdef QT_GUI_LIB #include #include #include #ifdef QT_WIDGETS_LIB #include #endif // QT_WIDGETS_LIB #endif // QT_GUI_LIB #include #include #include #include #include #include #include #include #include #include #include #include #include #include #define VERSION_MAJ 1 #define VERSION_MIN 0 #define VERSION_STR "1.0" #define FILE_OPEN_EVENT_WAIT_TIME 3000 // ms static Config *conf = 0; static QQmlApplicationEngine *qae = 0; static int exitTimerId = -1; static void loadConf(const QString &override, bool quiet) // Terminates app on failure { const QString defaultFileName = QLatin1String("configuration.qml"); QUrl settingsUrl; bool builtIn = false; //just for keeping track of the warning if (override.isEmpty()) { QFileInfo fi; fi.setFile(QStandardPaths::locate(QStandardPaths::DataLocation, defaultFileName)); if (fi.exists()) { settingsUrl = QUrl::fromLocalFile(fi.absoluteFilePath()); } else { // ### If different built-in configs are needed per-platform, just apply QFileSelector to the qrc conf.qml path settingsUrl = QUrl(QLatin1String("qrc:///qt-project.org/QmlRuntime/conf/") + defaultFileName); builtIn = true; } } else { QFileInfo fi; fi.setFile(override); if (!fi.exists()) { printf("qml: Couldn't find required configuration file: %s\n", qPrintable(QDir::toNativeSeparators(fi.absoluteFilePath()))); exit(1); } settingsUrl = QUrl::fromLocalFile(fi.absoluteFilePath()); } if (!quiet) { if (builtIn) printf("qml: Using built-in configuration.\n"); else printf("qml: Using configuration file: %s\n", qPrintable(settingsUrl.isLocalFile() ? QDir::toNativeSeparators(settingsUrl.toLocalFile()) : settingsUrl.toString())); } // TODO: When we have better engine control, ban QtQuick* imports on this engine QQmlEngine e2; QQmlComponent c2(&e2, settingsUrl); conf = qobject_cast(c2.create()); if (!conf){ printf("qml: Error loading configuration file: %s\n", qPrintable(c2.errorString())); exit(1); } } void contain(QObject *o, const QUrl &containPath) { QQmlComponent c(qae, containPath); QObject *o2 = c.create(); if (!o2) return; bool success = false; int idx; if ((idx = o2->metaObject()->indexOfProperty("containedObject")) != -1) success = o2->metaObject()->property(idx).write(o2, QVariant::fromValue(o)); if (!success) o->setParent(o2); //Set QObject parent, and assume container will react as needed } #ifdef QT_GUI_LIB void noFilesGiven(); // Loads qml after receiving a QFileOpenEvent class LoaderApplication : public QGuiApplication { public: LoaderApplication(int& argc, char **argv) : QGuiApplication(argc, argv) {} bool event(QEvent *ev) { if (ev->type() == QEvent::FileOpen) { if (exitTimerId >= 0) { killTimer(exitTimerId); exitTimerId = -1; } qae->load(static_cast(ev)->url()); } else return QGuiApplication::event(ev); return true; } void timerEvent(QTimerEvent *) { noFilesGiven(); } }; #endif // QT_GUI_LIB // Listens to the appEngine signals to determine if all files failed to load class LoadWatcher : public QObject { Q_OBJECT public: LoadWatcher(QQmlApplicationEngine *e, int expected) : QObject(e) , expect(expected) , haveOne(false) { connect(e, SIGNAL(objectCreated(QObject*,QUrl)), this, SLOT(checkFinished(QObject*))); } private: int expect; bool haveOne; public Q_SLOTS: void checkFinished(QObject *o) { if (o) { haveOne = true; if (conf && qae) foreach (PartialScene *ps, conf->completers) if (o->inherits(ps->itemType().toUtf8().constData())) contain(o, ps->container()); } if (haveOne) return; if (! --expect) { printf("qml: Did not load any objects, exiting.\n"); exit(2);//Different return code from qFatal } } }; void quietMessageHandler(QtMsgType type, const QMessageLogContext &ctxt, const QString &msg) { Q_UNUSED(ctxt); Q_UNUSED(msg); //Doesn't print anything switch (type) { case QtFatalMsg: exit(-1); case QtCriticalMsg: case QtDebugMsg: case QtWarningMsg: default: ; } } // ### Should command line arguments have translations? Qt creator doesn't, so maybe it's not worth it. enum QmlApplicationType { QmlApplicationTypeUnknown , QmlApplicationTypeCore #ifdef QT_GUI_LIB , QmlApplicationTypeGui #ifdef QT_WIDGETS_LIB , QmlApplicationTypeWidget #endif // QT_WIDGETS_LIB #endif // QT_GUI_LIB }; #ifndef QT_GUI_LIB QmlApplicationType applicationType = QmlApplicationTypeCore; #else QmlApplicationType applicationType = QmlApplicationTypeGui; #endif // QT_GUI_LIB bool quietMode = false; bool verboseMode = false; void printVersion() { printf("qml binary version "); printf(VERSION_STR); printf("\nbuilt with Qt version "); printf(QT_VERSION_STR); printf("\n"); exit(0); } void printUsage() { printf("Usage: qml [options] [files]\n"); printf("\n"); printf("Any argument ending in .qml will be treated as a QML file to be loaded.\n"); printf("Any number of QML files can be loaded. They will share the same engine.\n"); printf("Any argument which is not a recognized option and which does not end in .qml will be ignored.\n"); printf("'gui' application type is only available if the QtGui module is avaialble.\n"); printf("'widget' application type is only available if the QtWidgets module is avaialble.\n"); printf("\n"); printf("General Options:\n"); printf("\t-h, -help..................... Print this usage information and exit.\n"); printf("\t-v, -version.................. Print the version information and exit.\n"); #ifdef QT_GUI_LIB #ifndef QT_WIDGETS_LIB printf("\t-apptype [core|gui] .......... Select which application class to use. Default is gui.\n"); #else printf("\t-apptype [core|gui|widget] ... Select which application class to use. Default is gui.\n"); #endif // QT_WIDGETS_LIB #endif // QT_GUI_LIB printf("\t-quiet ....................... Suppress all output.\n"); printf("\t-I [path] .................... Prepend the given path to the import paths.\n"); printf("\t-f [file] .................... Load the given file as a QML file.\n"); printf("\t-config [file] ............... Load the given file as the configuration file.\n"); printf("\t-- ........................... Arguments after this one are ignored by the launcher, but may be used within the QML application.\n"); printf("\tDebugging options:\n"); printf("\t-verbose ..................... Print information about what qml is doing, like specific file urls being loaded.\n"); printf("\t-translation [file] .......... Load the given file as the translations file.\n"); printf("\t-dummy-data [directory] ...... Load QML files from the given directory as context properties.\n"); printf("\t-slow-animations ............. Run all animations in slow motion.\n"); printf("\t-fixed-animations ............ Run animations off animation tick rather than wall time.\n"); exit(0); } void noFilesGiven() { if (!quietMode) printf("qml: No files specified. Terminating.\n"); exit(1); } //Called before application initialization, removes arguments it uses void getAppFlags(int &argc, char **argv) { #ifdef QT_GUI_LIB for (int i=0; i errors = comp.errors(); foreach (const QQmlError &error, errors) qWarning() << error; } if (dummyData && !quietMode) { printf("qml: Loaded dummy data: %s\n", qPrintable(dir.filePath(qml))); qml.truncate(qml.length()-4); engine.rootContext()->setContextProperty(qml, dummyData); dummyData->setParent(&engine); } } } int main(int argc, char *argv[]) { getAppFlags(argc, argv); QCoreApplication *app = 0; switch (applicationType) { case QmlApplicationTypeCore: app = new QCoreApplication(argc, argv); break; #ifdef QT_GUI_LIB case QmlApplicationTypeGui: app = new LoaderApplication(argc, argv); break; #ifdef QT_WIDGETS_LIB case QmlApplicationTypeWidget: app = new QApplication(argc, argv); break; #endif // QT_WIDGETS_LIB #endif // QT_GUI_LIB default: Q_ASSERT_X(false, Q_FUNC_INFO, "impossible case"); break; } app->setApplicationName("Qml Runtime"); app->setOrganizationName("Qt Project"); app->setOrganizationDomain("qt-project.org"); qmlRegisterType("QmlRuntime.Config", VERSION_MAJ, VERSION_MIN, "Configuration"); qmlRegisterType("QmlRuntime.Config", VERSION_MAJ, VERSION_MIN, "PartialScene"); QQmlApplicationEngine e; QStringList files; QString confFile; QString translationFile; QString dummyDir; //Handle main arguments QStringList argList = app->arguments(); for (int i = 0; i < argList.count(); i++) { const QString &arg = argList[i]; if (arg == QLatin1String("-quiet")) quietMode = true; else if (arg == QLatin1String("-v") || arg == QLatin1String("-version")) printVersion(); else if (arg == QLatin1String("-h") || arg == QLatin1String("-help")) printUsage(); else if (arg == QLatin1String("--")) break; else if (arg == QLatin1String("-verbose")) verboseMode = true; else if (arg == QLatin1String("-slow-animations")) QUnifiedTimer::instance()->setSlowModeEnabled(true); else if (arg == QLatin1String("-fixed-animations")) QUnifiedTimer::instance()->setConsistentTiming(true); else if (arg == QLatin1String("-I")) { if (i+1 == argList.count()) continue;//Invalid usage, but just ignore it e.addImportPath(argList[i+1]); i++; } else if (arg == QLatin1String("-f")) { if (i+1 == argList.count()) continue;//Invalid usage, but just ignore it files << argList[i+1]; i++; } else if (arg == QLatin1String("-config")){ if (i+1 == argList.count()) continue;//Invalid usage, but just ignore it confFile = argList[i+1]; i++; } else if (arg == QLatin1String("-translation")){ if (i+1 == argList.count()) continue;//Invalid usage, but just ignore it translationFile = argList[i+1]; i++; } else if (arg == QLatin1String("-dummy-data")){ if (i+1 == argList.count()) continue;//Invalid usage, but just ignore it dummyDir = argList[i+1]; i++; } else { //If it ends in .qml, treat it as a file. Else ignore it if (arg.endsWith(".qml")) files << arg; } } if (quietMode && verboseMode) verboseMode = false; #ifndef QT_NO_TRANSLATION //qt_ translations loaded by QQmlApplicationEngine QString sysLocale = QLocale::system().name(); if (!translationFile.isEmpty()) { //Note: installed before QQmlApplicationEngine's automatic translation loading QTranslator translator; if (translator.load(translationFile)) { app->installTranslator(&translator); if (verboseMode) printf("qml: Loaded translation file %s\n", qPrintable(QDir::toNativeSeparators(translationFile))); } else { if (!quietMode) printf("qml: Could not load the translation file %s\n", qPrintable(QDir::toNativeSeparators(translationFile))); } } #else if (!translationFile.isEmpty() && !quietMode) printf("qml: Translation file specified, but Qt built without translation support.\n"); #endif if (quietMode) qInstallMessageHandler(quietMessageHandler); if (files.count() <= 0) { #if defined(Q_OS_MAC) if (applicationType == QmlApplicationTypeGui) exitTimerId = static_cast(app)->startTimer(FILE_OPEN_EVENT_WAIT_TIME); else #endif noFilesGiven(); } qae = &e; loadConf(confFile, !verboseMode); //Load files LoadWatcher lw(&e, files.count()); foreach (const QString &path, files) { //QUrl::fromUserInput doesn't treat no scheme as relative file paths QRegularExpression urlRe("[[:word:]]+://.*"); if (urlRe.match(path).hasMatch()) { //Treat as a URL QUrl url = QUrl::fromUserInput(path); if (verboseMode) printf("qml: loading %s\n", qPrintable(url.isLocalFile() ? QDir::toNativeSeparators(url.toLocalFile()) : url.toString())); e.load(url); } else { //Local file path if (verboseMode) printf("qml: loading %s\n", qPrintable(QDir::toNativeSeparators(path))); QByteArray strippedFile; if (getFileSansBangLine(path, strippedFile)) e.loadData(strippedFile, e.baseUrl().resolved(QUrl::fromLocalFile(path))); //QQmlComponent won't resolve it for us, it doesn't know it's a valid file if we loadData else //Errors or no bang line e.load(path); } } if (!dummyDir.isEmpty() && QFileInfo (dummyDir).isDir()) loadDummyDataFiles(e, dummyDir); return app->exec(); } #include "main.moc"