Introducing winrtrunner

winrtrunner is a console application for launching WinRT Qt packages. It
handles:
- installing (registering) & removing the package
- launching & terminating the app
- fetching & dispaying test output for test cases

It is designed to compile everywhere, as the platform-specific backends
are left out where not supported. Currently it only has a backend for
Appx packages, so MSVC2012/2013 is required. It may support other
backends over time, such as Windows Phone and remote Appx, as well as
any host SDK that gains support for deploying to these platforms.

Done-with: Maurice Kalinowski <maurice.kalinowski@digia.com>
Change-Id: I424c228435d8eb4608a1d1854106b9df69ca5f11
Reviewed-by: Friedemann Kleint <Friedemann.Kleint@digia.com>
Reviewed-by: Oliver Wolff <oliver.wolff@digia.com>

1 files changed, 67 insertions, 0 deletions

diff --git a/src/winrtrunner/runnerengine.h b/src/winrtrunner/runnerengine.h
new file mode 100644
index 000000000..187be5f1a
--- /dev/null
+++ b/src/winrtrunner/runnerengine.h
@@ -0,0 +1,67 @@
+/****************************************************************************
+**
+** Copyright (C) 2014 Digia Plc and/or its subsidiary(-ies).
+** 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$
+**
+****************************************************************************/
+
+#ifndef RUNNERENGINE_H
+#define RUNNERENGINE_H
+
+#include <QtCore/QString>
+
+QT_USE_NAMESPACE
+
+class RunnerEngine
+{
+public:
+    virtual ~RunnerEngine() { }
+    virtual bool install(bool removeFirst = false) = 0;
+    virtual bool remove() = 0;
+    virtual bool start() = 0;
+    virtual bool suspend() = 0;
+    virtual bool waitForFinished(int secs) = 0;
+    virtual bool stop() = 0;
+    virtual qint64 pid() const = 0;
+    virtual int exitCode() const = 0;
+    virtual QString executable() const = 0;
+    virtual QString devicePath(const QString &relativePath) const = 0;
+    virtual bool sendFile(const QString &localFile, const QString &deviceFile) = 0;
+    virtual bool receiveFile(const QString &deviceFile, const QString &localFile) = 0;
+};
+
+#endif // RUNNERENGINE_H