/*
* 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>

#ifdef LOGGING
#define QDEBUG(a)   qDebug() <<a
#else
#define QDEBUG(a)  
#endif //LOGGING

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