The EMDKManager class is the key class in Android EMDK. This class provides access to different classes for the supported features. Clients should call EMDKManager.getEMDKManager(Context, EMDKManager.EMDKListener), to get the EMDKManager object. Each application implements EMDKListener interface. The EMDKManager object will be returned on successful opening through the EMDKListener callback.
Example Usage:
EMDKResults results = EMDKManager.getEMDKManager(getApplicationContext(), emdkListener);
Public Methods
getEMDKManager
public EMDKResults getEMDKManager(Context context, EMDKManager.EMDKListener emdkListener)
This is static method and it is the key function to get the EMDKManager object. Clients must implement EMDKManager.EMDKListener to get notified of the EMDK manager status and to get the EMDKManager object.
Parameters:
context - The application context should be provided by the user.
emdkListener - The EMDK Listener for listener callbacks.
Returns:
com.symbol.emdk.EMDKResults
getInstance
public EMDKBase getInstance(EMDKManager.FEATURE_TYPE featureType)
This method returns an object instance which has derived from EMDKBase. Based on the type given, the object needs to be type-casted before used. Calling this method before EMDKManager opened will return null.
Example Usage:
ProfileManager mProfileManager = (ProfileManager) emdkManager.getInstance(EMDKManager.FEATURE_TYPE.PROFILE);
VersionManager mVersionManager = (VersionManager) emdkManager.getInstance(EMDKManager.FEATURE_TYPE.VERSION);
Parameters:
featureType - The EMDKManager.FEATURE_TYPE the object to be created.
Returns:
com.symbol.emdk.EMDKBase
getInstanceAsync
public void getInstanceAsync(EMDKManager.FEATURE_TYPE featureType, EMDKManager.StatusListener statusListener)
This method is an asynchronous call and requests object instance for the specified feature type and object is returned through the status listener callback when the feature is initialized and ready to use. Ex:The Profile Manager related components will take few seconds to initialize for it to be used after device booted. If the application tries to use the EMDKManager.getInstance to get the profile manager object and sets the profile during the device boot will result in error because the underlying Profile manager is not ready.
Parameters:
featureType - The EMDKManager.FEATURE_TYPE the object to be created.
statusListener - The callback will returned on EMDKManager.StatusListener when the feature is ready to use.
Returns:
void
Throws:
com.symbol.emdk.EMDKException
The exception will be thrown when the error occurs during this request.
release
public void release()
This method releases all the resources constructed by EMDKManager. EMDKManager can't be used after this call. The clients must call this method before exiting the application.
Example Usage:
emdkManager.release();
Returns:
void
release
public void release(EMDKManager.FEATURE_TYPE featureType)
This method releases resources of a given manager type. Instance variable is not required as multiple instances are not allowed by design.
Example Usage:
emdkManager.release(EMDKManager.FEATURE_TYPE.PROFILE);
Parameters:
featureType - Type of EMDKManager.FEATURE_TYPE to be released. Only the given feature related manager will be cleared if it has been constructed.
Returns:
void