/*
* Copyright (c) 2008 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:   This file contains the header file of the CIAUpdateStarter
*                class 
*
*/


#ifndef __IAUPDATE_STARTER_H__
#define __IAUPDATE_STARTER_H__

// INCLUDES
#include <e32base.h>
#include "iaupdateuitimerobserver.h"

// FORWARD DECLARATIONS
class CApaWindowGroupName;
class MIAUpdateStarterObserver;
class CIAUpdateUITimer;

// CLASS DECLARATION
/**
*
*/

class CIAUpdateStarter :public CActive, public MIAUpdateUITimerObserver
    {
public:

    /**
    * Construct a CIAUpdateStarter using two phase construction,
    * and return a pointer to the created object
    * @param aCommandLineExecutable Name of executable to be started
    * @param aCommandLineArguments Command line arguments of an application 
    * @return A pointer to the created instance of CIAUpdateStarter
    */
    static CIAUpdateStarter* NewL( const TDesC& aCommandLineExecutable,
                                   const TDesC8& aCommandLineArguments );
    
    /**
    * Destructor
    */
    ~CIAUpdateStarter();

public: // new functions
    /**
    * Starts an executable
    *
    * @param aStarterObserver  Observer
    */
    void StartExecutableL( MIAUpdateStarterObserver& aStarterObserver );
    
    /**
    * Checks weather startable executable exists in installation package
    *
    * @param aPUid  Package Uid of installation
    */
    void CheckInstalledPackageL( const TUid& aPUid );    
    
    /**
    * Bring started application to foreground
    */
    void BringToForegroundL() const;
    
private: // from CActive

    /**
     * @see CActive::DoCancel
     *
     */
    void DoCancel();

    /**
     * When the server side has finished operation, the CActive object will
     * be informed about it, and as a result RunL will be called. This function
     * well inform the observer that the operation has been completed.
     * @see CActive::RunL
     *
     */
    void RunL();
           
    /**
     * Just trap leave error and pass it to observer
     *
     * @see CActive::RunError
     *
     */
    TInt RunError( TInt aError );
    
private: // from MIAUpdateUITimerObserver
      
     void BackgroundDelayComplete( TInt aError );   
         
     void ForegroundDelayComplete( TInt aError );
     
     void ProcessStartDelayComplete( TInt aError );  

private:  //constructors

    /**
    * Perform the second phase construction of a CIAUpdateStarter object
    * @param aCommandLineExecutable Name of executable to be started
    * @param aCommandLineArguments Command line arguments of an application 
    */
    void ConstructL( const TDesC& aCommandLineExecutable,
                     const TDesC8& aCommandLineArguments );

    /**
    * C++ constructor 
    */
    CIAUpdateStarter();

private:  //new functions
    
    /**
    * Starts executable
    */
    void LaunchExeL();
    
    /**
    * Close executable
    */
    void CloseExecutableL();
    
    /**
    * Finds UID of executable
    * @param aUid UID 
    */
    void UidForExecutableL( TUid& aUid ) const;
    
    /**
    * Starts process
    */
    void StartProcessL();

private: //data

    HBufC* iCommandLineExecutable;
    
    HBufC8* iCommandLineArguments;
    
    TBool iStartNeeded;
    
    TBool iExeStarted;
    
    TUid iUid;
    
    TInt iPrevWgId;
        
    RThread iThread;
	
	RProcess iProcess;
	
	MIAUpdateStarterObserver* iStarterObserver; //not owned
	
	CEikonEnv* iEikEnv; //not owned
	
	CIAUpdateUITimer* iProcessStartTimer;
	
    };


#endif // __IAUPDATE_STARTER_H__