/*

* Copyright (c) 2007-2007 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:  Launch Diagnostics embedded application.

*                 (DevDiagApp.exe) The UID3 is defined below.

*

*/

#ifndef GSDDPLUGIN_H

#define GSDDPLUGIN_H

// INCLUDES

#include <gsplugininterface.h>

#include <ConeResLoader.h>

#include <AknServerApp.h>

//CONSTANTS

const TUid KGSDDPluginUid = { 0x2000E543 };

const TUid KGsDiagnosticsAppUid  = { 0x2000E542 }; //app to be laucnhed 

//_LIT( KGSDDPluginIconDirAndName, "z:GSDDPlugin.mbm"); // Use KDC_BITMAP_DIR

_LIT( KGSDDPluginIconDirAndName, "z:GSDevDiagPlugin.mif"); // Use KDC_BITMAP_DIR or ?? KDC_APP_BITMAP_DIR

_LIT( KGSDiagnosticsApp,    "z:\\sys\\bin\\DevDiagApp.exe" );

// MACROS

// DATA TYPES

// FUNCTION PROTOTYPES

// FORWARD DECLARATIONS

class CAknNullService;

// CLASS DEFINITION

/**

*  CGSDevDiagPlugin view class 

*  @since S60 5.0

*

*/

class CGSDevDiagPlugin : public CGSPluginInterface,

                         public MAknServerAppExitObserver // Embedding

    {

    /**

    * Contains application information

    *

    *  @since S60 5.0

    **/

    class TAppInfo

     {

     public:

         TAppInfo( TUid aUid, const TDesC& aFile )

             : iUid( aUid ), iFile( aFile )

             {}

         TUid iUid; //Uid3

         TFileName iFile; //full filename of the app.

     };

public: // Constructors and destructor

    /**

    * Symbian OS two-phased constructor

    * @return GS connection view.

    */

    static CGSDevDiagPlugin* NewL( TAny* aInitParams );

    /**

    * Destructor

    */

    ~CGSDevDiagPlugin();

public: // From CGSPluginInterface

    /**

    * @see CGSPluginInterface header file.

    */

    void GetCaptionL( TDes& aCaption ) const;

    /**

    * See base class.

    */

    CGulIcon* CreateIconL( const TUid aIconType );

    /**

    * @see CGSPluginInterface header file.

    */

    TInt PluginProviderCategory() const;

    /**

    * GS framework calls this method when plug-in is opened.

    * The method launches the embedded application.

    **/

    void HandleSelection( const TGSSelectionTypes aSelectionType );

    /**

    * See base class.

    */

    TGSListboxItemTypes ItemType();

    /**

    * See base class.

    */

    void GetValue( const TGSPluginValueKeys aKey,

                       TDes& aValue );

public: //from MAknServerAppExitObserver

    /**

    * Close the GS when embedded application is shutdown.

    **/

    virtual void HandleServerAppExit(TInt aReason);

public: //From CAknView

    /**

    * From CAknView.

    * Returns views id.

    **/

    TUid Id() const;

protected:

    /**

    * From CAknView Activates view.

    * @since Series 60 3.1

    * @param aPrevViewId Id of previous view.

    * @param aCustomMessageId Custom message id.

    * @param aCustomMessage Custom message.

    * @return None.

    */

    virtual void DoActivateL (const TVwsViewId &aPrevViewId, 

                                       TUid aCustomMessageId, 

                                       const TDesC8 &aCustomMessage);

    /**

    * From CAknView Deactivates view.        

    * @since Series 60 3.1

    * @param None.

    * @return None.

    */

    virtual void DoDeactivate();     

private:

    /**

    * ConstructL

    **/

    void ConstructL();

    /**

    * Default constructor

    **/

    CGSDevDiagPlugin();

    /**

    * Open localised resource file.

    *

    * @aResourceFileName Full path name of the resource file.

    * @aRsourceLoader 

    **/

    void OpenLocalizedResourceFileL(

            const TDesC& aResourceFileName,

            RConeResourceLoader& aResourceLoader );

   /**

   * Launch DevDiagApp.exe as an embedded application 

   **/            

   void LaunchDiagnosticsAppL();

   /**

   * Calls null service to launch the application.

   *

   * @param aApp The application to be launched.

   **/      

   void EmbedAppL( const TAppInfo& aApp );      

private:

     // resource loader

    RConeResourceLoader iResourceLoader;

    // Mysterious embedded app launcher.

    CAknNullService* iNullService;             

    };

#endif //GSDDPLUGIN_H

// End of File