// Copyright (c) 2007-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:

//

// INCLUDE FILES

#include <featmgr/featurecontrol.h>

// LOCAL CONSTANTS AND MACROS

_LIT(KTxt,"featureinstaller: mainL failed");

// ============================= LOCAL FUNCTIONS ===============================

// -----------------------------------------------------------------------------

// mainL

// -----------------------------------------------------------------------------

//  

LOCAL_C void mainL()

	{

	// Open Feature Control.

	RFeatureControl featureControl;

    User::LeaveIfError( featureControl.Open() );

    // Example code adds a new persisted feature to the device.

    // Comment or uncomment code when needed. 

    // Specify in your .pkg file:

    // @"featureinstaller.sisx", (0x10283303)

    // Replace UID 0x00000000 with real value

    TUid featureUid( TUid::Uid( 0x00000000 ) ); 

    // Set feature flags of the feature!

    // Set all flags to zero.

    // Comment when needed!

    TBitFlags32 featureFlags( 0 );

    // If set, feature is supported and available for use; 

    // if not, feature is not supported.

    // Comment when needed!

    featureFlags.Set( EFeatureSupported );

    // If set, feature is upgradeable. The feature is known to the device

    // but it must be upgraded to enable it. If a feature s blacklisted, 

    // its upgradeable flag is unset. 

    // Uncomment when needed!

    // featureFlags.Set( EFeatureUpgradeable );

    // If set, the feature is modifiable and may be enabled/disabled 

    // at run-time. The initial flag values for such a feature flag are

    // defined in a ROM image obey file.

    // Comment when needed!

    featureFlags.Set( EFeatureModifiable );

    // If set, the feature has been blacklisted, and may not be changed at 

    // run-time. This also prevents a feature from being upgraded.

    // Uncomment when needed!

    // featureFlags.Set( EFeatureBlackListed );

    // If set, only clients with WriteDeviceData capability can modify it.

    // This ensures only trusted software can set the feature Supported flag.

    // Uncomment when needed!

    // featureFlags.Set( EFeatureProtected );

    // If set, this flag is saved to the system drive when modified 

    // preserving its value across reboots/power downs.

    // Comment when needed!

    featureFlags.Set( EFeaturePersisted );

    // If set, this flag Supported state is unknown at build-time and is

    // initialised at run-time by system software. The Feature Manager will

    // ignore the Supported flag in the file. A run-time call to RFeatureControl

    // will be needed to set the feature's supported flag. Look ups of 

    // uninitialised features result in a KErrNotReady error code

    // Uncomment when needed!

    // featureFlags.Set( EFeatureUninitialized );

    // Feature data is 32-bit quantity for client read and write. Feature data is

    // defined by owner of the feature and can contain for example flags, 

    // enumeratons and/or integers.

    // Set feature data. Replace <featureData> with real value!

    // Comment when needed!

    TUint32 featureData( 0x00000000 );

    // Comment when needed!

    TFeatureEntry entry( featureUid, featureFlags, featureData );

    TInt err( KErrNone );

    // Inform feature manager that your executable is launched by the software installer (SWI)

    // and it wishes to set, add, delete, enable or disable features in feature manager. This

    // function must be called before any API calls by RFeatureControl that add, set, delete 

    // enable, or disable features so that changes in feature manager are cached to be rolled 

    // back if the installationhas user-aborted or failed. Otherwise, feature manipulations will

    // be committed directly into feature manager and will not be possible to undo them in the

    // case of abort.

    // A call to SWIStart must be accompanied by a call to SWIEnd after all API calls by

    // RFeatureControl functions that manipulate features.

    User::LeaveIfError(featureControl.SWIStart()); 

    // Add a new feature to the device.

    // Comment when needed!

    err = featureControl.AddFeature( entry );

    if ( err == KErrAlreadyExists ) // Existing feature cannot be added as a new feature.

        {

        // Enable an existing feature.

        User::LeaveIfError( featureControl.EnableFeature( featureUid ) );

        // OR enable an exsiting feature and set feature data.

        // Uncomment when needed!

        //User::LeaveIfError( featureControl.SetFeature( featureUid, ETrue, featureData ) );

        }

    // Inform feature manager that caching feature manipulations should stop and they should be 

    // committed to feature manager.

    // A call to this API should follow the call to SWIStart before any RFeatureControl API calls

    // that manipulate features to feature manager.

    User::LeaveIfError(featureControl.SWIEnd());

    featureControl.Close();

    }

// ============================ MEMBER FUNCTIONS ===============================

TInt E32Main() // main function called by E32

	{

	__UHEAP_MARK;

	CTrapCleanup* cleanup=CTrapCleanup::New(); // get clean-up stack

	TRAPD( error,mainL() ); // Run main method

	__ASSERT_ALWAYS( !error,User::Panic(KTxt,error) );

	delete cleanup; // destroy clean-up stack

	__UHEAP_MARKEND;

	return 0; // and return

	}

// End of file