Overview  Package   Class  Tree  Deprecated  Index  Help 
 PREV CLASS   NEXT CLASS FRAMES    NO FRAMES    
SUMMARY: NESTED | FIELD | CONSTR | METHOD DETAIL: FIELD | CONSTR | METHOD

com.nokia.notifications.installer
Interface NotificationsEnablerInstaller

public interface NotificationsEnablerInstaller

Overview

This interface is meant for checking Notification Enabler availability and for handling downloading, installation and launching of the enabler if an update is required. This is needed on Nokia Asha OS 1.0 to maintain backward compatibility with Nokia Notification API offering in S40 legacy devices.

  • During startup, application calls checkAndUpdateNapiEnabler(InstallListener, Displayable, MIDlet) before trying to use Notifications API
  • Enabler is pre-installed in Nokia Asha OS 1.0.
  • The result InstallListener.ALREADY_EXISTS is returned to the InstallListener.installResult(int) callback
  • Application can start using Notifications API

    • Method Summary
     void cancel()
              This API has no effect on Nokia Asha OS 1.0.
     void checkAndUpdateNapiEnabler(InstallListener listener, javax.microedition.lcdui.Displayable nextDisplayable, javax.microedition.midlet.MIDlet midlet)
               Checks that is the Notification Enabler available and that is it's version correct.
     void checkNapiEnabler(InstallListener listener, javax.microedition.midlet.MIDlet midlet)
               Checks that is the Notification Enabler available and that is it's version correct.
     void showInstallerSoftNotification(javax.microedition.lcdui.Display display)
               This API has no effect on Nokia Asha OS 1.0.
     void updateNapiEnabler(InstallListener listener, javax.microedition.lcdui.Displayable nextDisplayable, javax.microedition.midlet.MIDlet midlet)
               Updates Notification Enabler to latest available version.
     

    Method Detail

    checkAndUpdateNapiEnabler

    void checkAndUpdateNapiEnabler(InstallListener listener,
                               javax.microedition.lcdui.Displayable nextDisplayable,
                               javax.microedition.midlet.MIDlet midlet)

    Checks that is the Notification Enabler available and that is it's version correct.

    NOTE: This function will always result in InstallListener.ALREADY_EXISTS returned to the InstallListener.installResult(int) callback.

    Parameters:
    listener - Listener for receiving install result
    nextDisplayable - This displayable will be shown if update procedure starts but ends in error. If null, then installer will use a temporary displayable.
    midlet - The application MIDlet

    checkNapiEnabler

    void checkNapiEnabler(InstallListener listener,
                      javax.microedition.midlet.MIDlet midlet)

    Checks that is the Notification Enabler available and that is it's version correct.

    NOTE: This function will always result in InstallListener.ALREADY_EXISTS returned to the InstallListener.installResult(int) callback.

    Parameters:
    listener - Listener for receiving checking result
    midlet - The application MIDlet

    showInstallerSoftNotification

    void showInstallerSoftNotification(javax.microedition.lcdui.Display display)

    This API has no effect on Nokia Asha OS 1.0. It is for backward compability with legacy S40 devices.

    Parameters:
    display - Display of the MIDlet.

    updateNapiEnabler

    void updateNapiEnabler(InstallListener listener,
                       javax.microedition.lcdui.Displayable nextDisplayable,
                       javax.microedition.midlet.MIDlet midlet)

    Updates Notification Enabler to latest available version.

    NOTE: This function will always result in InstallListener.ALREADY_EXISTS returned to the InstallListener.installResult(int) callback.

    Parameters:
    listener - Listener for receiving install result
    nextDisplayable - This displayable will be shown if update procedure starts but ends in error. If null, then installer will use a temporary displayable.
    midlet - The application MIDlet

    cancel

    void cancel()
    This API has no effect on Nokia Asha OS 1.0. It is for backward compability with legacy S40 devices.

    Overview  Package   Class  Tree  Deprecated  Index  Help 
     PREV CLASS   NEXT CLASS FRAMES    NO FRAMES    
    SUMMARY: NESTED | FIELD | CONSTR | METHOD DETAIL: FIELD | CONSTR | METHOD
    Copyright © 2012 Nokia Corporation. All rights reserved.

    Nokia is registered trademark of Nokia Corporation. Java and all Java-based marks are trademarks or registered trademarks of Oracle Corporation. Other product and company names mentioned herein may be trademarks or trade names of their respective owners. This document is confidential information of Nokia Corporation.

    Disclaimer
    The information in this document is provided "as is," with no warranties whatsoever, including any warranty of merchantability, fitness for any particular purpose, or any warranty otherwise arising out of any proposal, specification, or sample. Furthermore, information provided in this document is preliminary, and may be changed substantially prior to final release.

    Nokia Corporation disclaims all liability, including liability for infringement of any proprietary rights, relating to this document and implementation of any information presented in this document.

    Nokia Corporation retains the right to make changes to this document at any time, without notice.

    License
    Subject to above disclaimer, a license is hereby granted to use this documentation solely under existing Limited License Agreement and non-disclosure agreement between the companies for the agreed application development for Series 40 Nokia phones. No other licenses e.g. to any intellectual property rights are granted herein. Any use of the screen shots of this documentation, including any icons thereof, is subject to Nokia's prior written approval.