ftuapplication/inc/ftufirsttimeuse.h
changeset 0 c464cd7e2753
child 2 66c26770985f
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/ftuapplication/inc/ftufirsttimeuse.h	Mon Apr 19 14:01:47 2010 +0300
@@ -0,0 +1,130 @@
+/*
+* Copyright (c) 2009 Nokia Corporation and/or its subsidiary(-ies).
+* All rights reserved.
+* This component and the accompanying materials are made available
+* under the terms of "Eclipse Public License v1.0"
+* which accompanies this distribution, and is available
+* at the URL "http://www.eclipse.org/legal/epl-v10.html".
+*
+* Initial Contributors:
+* Nokia Corporation - initial contribution.
+*
+* Contributors:
+*
+* Description:  First Time Use application main class.
+*
+*/
+
+
+#ifndef FTU_FIRSTTIMEUSE_H
+#define FTU_FIRSTTIMEUSE_H
+
+#include "ftutest_global.h"
+
+#include <QObject>
+
+FTU_TEST_CLASS(FtuFirstTimeUseTest)
+
+class QStateMachine;
+
+
+/**
+ * @ingroup group_ftuapplication
+ * @brief First Time Use application main class.
+ * 
+ * Loads a runtime from a runtime provider plugin. Manages 
+ * the runtime execution.
+ *
+ * @lib ?library
+ * @since S60 ?S60_version
+ */
+class FtuFirstTimeUse : public QObject
+{
+    Q_OBJECT
+
+public:
+
+    /**
+     * Constructor.
+     * @since S60 ?S60_version.     
+     * @param aParent Parent object.
+     */
+    FtuFirstTimeUse(QObject* aParent = 0);
+    
+    /**
+     * Destructor.
+     * @since S60 ?S60_version.     
+     */
+    virtual ~FtuFirstTimeUse();
+
+private:
+
+    /**
+     * Registers service plugins pre-installed on the device.
+     */
+    void registerServicePlugins();
+    /**
+     * Recursively registers service plugins starting from given root
+     * directory. All directories containing plugins are added to
+     * application's library paths at the same time.
+     * @param root The root folder.
+     */
+    void registerServicePlugins(const QString &root);
+
+    Q_DISABLE_COPY(FtuFirstTimeUse)
+
+signals:
+
+    /**
+     * Emitted when the FTU application needs to exit.
+     * @since S60 ?S60_version.     
+     */
+    void exit();
+
+public slots:
+
+    /**
+     * Starts the runtime.
+     * @since S60 ?S60_version. 
+     */
+    void start();
+    
+    /**
+     * Stops the runtime.
+     * @since S60 ?S60_version.     
+     */
+    void stop();
+
+private slots:
+
+    /**
+     * Called after the runtime has started.
+     * @since S60 ?S60_version.     
+     */
+    void handleRuntimeStarted();
+
+    /**
+     * Called after the runtime has stopped.
+     * @since S60 ?S60_version.     
+     */
+    void handleRuntimeStopped();
+    
+    /**
+     * Called after the runtime has faulted.
+     * @since S60 ?S60_version.     
+     */
+    void handleRuntimeFaulted();
+
+private:
+
+    /**
+     * Runtime.
+     */
+    QStateMachine* mRuntime;
+
+    FTU_TEST_FRIEND_CLASS(FtuFirstTimeUseTest)
+
+};
+
+#endif
+