diff -r 000000000000 -r bde4ae8d615e os/persistentdata/featuremgmt/featuremgr/tools/featureinstaller/featureinstaller.cpp --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/os/persistentdata/featuremgmt/featuremgr/tools/featureinstaller/featureinstaller.cpp Fri Jun 15 03:10:57 2012 +0200 @@ -0,0 +1,153 @@ + +// 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 + +// 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 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