Supported APIs

The following tables list the core and additional Java™ APIs supported by the Nokia Asha and Series 40 software platforms. The tables also list which API version is supported since which Nokia Asha and Series 40 platform release. The API names link to the corresponding implementation notes, if available, while the Java Specification Request (JSR) numbers link to the corresponding API specifications ("Javadocs").

For older API specification versions, see Java API Specifications on Nokia Developer.

Core Java APIs

The Nokia Asha and Series 40 platforms support the following core Java APIs.

Table: Core Java APIs supported by the Nokia Asha and Series 40 software platforms

Java API

JSR

Description

Supported from Asha software platform

Supported Series 40 developer platform

Connected Limited Device Configuration (CLDC)

139 (CLDC 1.1)

30 (CLDC 1.0)

CLDC specifies the low-level Java APIs on which MIDP is implemented.

CLDC 1.1

Nokia Asha Software Platform 1.0

CLDC 1.1

Series 40 6th Edition

Mobile Information Device Profile (MIDP)

118 (MIDP 2.1)

118 (MIDP 2.0)

37 (MIDP 1.0)

MIDP specifies the basic Java APIs for Java ME applications running on mobile devices. These APIs include, for example, the LCDUI API for creating GUIs and the RMS API for storing application data.

Java ME applications that use MIDP are called MIDlets.

The MIDP 2.1 specification is only available as a PDF download on the Java Community Process (JCP) website. The Java Developer's Library includes the MIDP 2.0 specification. For detailed information about the MIDP 2.1 implementation on Nokia Asha and Series 40 platform devices, see section Developer's guides and the MIDP 2.1 implementation notes.

MIDP 2.1

Nokia Asha Software Platform 1.0

MIDP 2.1

Series 40 6th Edition

Additional Java APIs

The Nokia Asha and Series 40 platforms support the following additional Java APIs.

Table: Additional Java APIs supported by the Nokia Asha and Series 40 software platforms

Java API

JSR

Description

Supported from Asha software platform

Supported Series 40 developer platform

Advanced Multimedia Supplements API (AMMS API)

234

The AMMS API allows you to build MIDlets with advanced multimedia features. You can access camera-specific controls such as brightness, contrast, flash, lighting modes, and zoom. You can also access radio and advanced audio processing capabilities.

For instructions on using this API, see section Using advanced multimedia features.

Version 1.1

Nokia Asha Software Platform 1.0

Version 1.1

Series 40 6th Edition

Bluetooth API

82

The Bluetooth API allows you to use Bluetooth connections in your MIDlet.

For instructions on using this API, see section Bluetooth connections.

Version 1.1

Nokia Asha Software Platform 1.0

Version 1.1

Series 40 6th Edition

Content Handler API (CHAPI)

211

The Content Handler API allows MIDlets to invoke registered Java ME and non-Java applications for content handling.

For instructions on using this API, see section Content handling.

Version 1.0.1

Nokia Asha Software Platform 1.0

Version 1.0.1

Series 40 6th Edition

Location API

179

179 Appendix

The Location API allows MIDlets to access location information and services through GPS.

Version 1.0

Nokia Asha Software Platform 1.0

Version 1.0

Series 40 6th Edition

Mobile 3D Graphics API (M3G API)

184

The Mobile 3D Graphics API allows MIDlets to use 3D graphics in their UI. The API implementation is based on OpenGL ES 1.0.

For instructions on using this API, see section Mobile 3D graphics.

Version 1.1

Nokia Asha Software Platform 1.0

Version 1.1

Series 40 6th Edition

Mobile Internationalisation API

238

The Mobile Internationalisation API allows MIDlets to format data items as per given locales, manage application and device resources for given base names and locales and compare strings as per rules specified by given locale.

Version 1.0

Nokia Asha Software Platform 1.0

 

Mobile Media API (MMAPI)

135

The Mobile Media API allows MIDlets to display images and play back audio and video.

Version 1.2

Nokia Asha Software Platform 1.0

Version 1.2

Series 40 6th Edition

Mobile Sensor API

256

The Mobile Sensor API allows you to develop MIDlets that use input from embedded or external sensors.

For instructions on using this API, see section Mobile sensors.

Version 1.2

Nokia Asha Software Platform 1.0

Version 1.2

Series 40 Developer Platform 2.0

Nokia UI API

Nokia UI API

The Nokia UI API is a Nokia-proprietary extension to MIDP. It provides additional functionality, especially for game developers, in the form of audio and graphics capabilities. Version 1.1b introduces Gestures and the TextEditor UI Component. Version 1.6 introduces the CategoryBar, IconCommand, PopupList UI elements as well as the Locale, Multipoint Touch and Orientation APIs. Version 1.7 introduces the File Select, Phone Settings, Contact, Image Scaling, Network State and Notifications APIs, while the com.nokia.mid.sound.Sound and com.nokia.mid.sound.SoundListener classes are removed.

Version 1.7

Nokia Asha Software Platform 1.0

Version 1.6

Series 40 Developer Platform 2.0

Version 1.1c

Series 40 Developer Platform 1.0

Version 1.1b

Series 40 6th Edition Feature Pack 1

Version 1.1a

Series 40 6th Edition (Navi Key devices)

PDA Optional Package: FileConnection API (FC API)

75 (FC)

The FileConnection API allows MIDlets to access the device file system.

For instructions on using this API, see section File access.

Version 1.0

Nokia Asha Software Platform 1.0

Version 1.0

Series 40 6th Edition

PDA Optional Package: Personal Information Management API (PIM API)

75 (PIM)

The PIM API allows MIDlets to access personal data stored by users, including contact lists, calendars, and to-do lists.

For instructions on using this API, see section Personal information management.

Version 1.1

Nokia Asha Software Platform 1.0

Version 1.0

Series 40 6th Edition

Scalable 2D Vector Graphics API (M2G API)

226

The Scalable 2D Vector Graphics API allows MIDlets to load and render external 2D vector images stored in the W3C SVG Tiny format. The API can be extend to support other formats.

For instructions on using this API, see section Scalable 2D vector graphics.

 

Version 1.1

Series 40 6th Edition

Security and Trust Services API (SATSA API)

177

The SATSA API allows MIDlets to use PKI certificates, private data storage, cryptographic operations, and secure environment services for authentication, authorization, and identification. The API consists of the following optional packages:

  • SATSA-PKI

  • SATSA-APDU

  • SATSA-CRYPTO

For instructions on using this API, see section Security.

Version 1.0

Nokia Asha Software Platform 1.0

Version 1.0

Series 40 6th Edition

Web Services API

172 (RPC)

172 (XML Parser)

The Web Services API provides an infrastructure for the web services client/server architecture. The API consists of the following independent, optional packages:

  • RPC Package

  • XML Parser Package

The packages provide basic XML processing capabilities and allow the reuse of web service concepts when designing Java ME clients for enterprise services.

For instructions on using this API, see section Web services.

Version 1.0

Nokia Asha Software Platform 1.0

Version 1.0

Series 40 6th Edition

Wireless Messaging API (WMA)

205 (WMA 2.0)

120 (WMA 1.0)

The Wireless Messaging API allows MIDlets to compose, send, and receive SMS and MMS messages.

For instructions on using this API, see section Wireless Messaging API 2.0.

Version 2.0

Nokia Asha Software Platform 1.0

Version 2.0

Series 40 6th Edition

Nokia APIs

The following table summarizes the Nokia APIs supported on Nokia Asha and Series 40 platforms:

Nokia API

Description

Javadocs

Supported from Asha software platform

Supported Series 40 developer platform

Theme API

The Theme API allows MIDlets to retrieve the colors and images for each of the native themes.

Nokia UI Theme API

Nokia Asha Software Platform 1.4

 

Share API

With Share API, applications can easily share content. There are two sides in sharing - one is the source and the other is the destination. The sharing source has some kind of content available, for example, an image edited by the user or an HTTP URL pointing to some interesting Web page. Sharing is initiated by calling the share content handler via the JSR 211 API.

JSR-211 - Content Handler API 1.0.1

Nokia Asha Software Platform 1.1

 

VoIP API

Asha software platform now supports SIP VoIP functionality. You can use the VoIP API to develop MIDlets with VoIP features.

VoIP API

Nokia Asha Software Platform 1.1

 

Nokia Notifications API

The Nokia Notifications API makes it easy to add real-time push notifications to your MIDlets running on Nokia Asha software platform devices. Notification is a message that is sent from an application-specific notification service to its own MIDlet (client) installed on the device.

Nokia Notifications API

Nokia Asha Software Platform 1.0

 

File Select API

The File Select API allows MIDlets to use the device’s native file browser to list and select files. The listing of files can be filtered by URL path and media type, and single as well as multiple files can be selected.

File Select API

Nokia Asha Software Platform 1.0

 

Image Scaling API

The Image Scaling API enables you to develop MIDlets with image resizing capabilities. You can use this API to reduce the size of an image either by file size or by dimension (that is, width and height). The aspect ratio of the image can be retained, if required. For JPEG images, the output quality can be set before resizing the image.

Image Scaling API

Nokia Asha Software Platform 1.0

 

Network State API

The Network State API allows MIDlets to retrieve state change notifications pertaining to network, SIM and WLAN. For example, network state changes include in home network, no network and in roaming network.

Network State API

Nokia Asha Software Platform 1.0

 

Contact API

The Contact API allows MIDlets to discover and receive changes to the device’s contacts in the phonebook.

Contact API

Nokia Asha Software Platform 1.0

 

Phone Setting API

The Phone Setting API allows MIDlets to retrieve settings and state change notifications pertaining to various phone settings such as, flight mode, data connection, vibration mode, silent mode and so on.

Phone Setting API

Nokia Asha Software Platform 1.0

 

Nokia UI API

The Nokia UI API is a Nokia-proprietary extension to MIDP. It provides additional functionality, especially for game developers, in the form of audio and graphics capabilities. Version 1.1b introduces Gestures and the TextEditor UI Component. Version 1.6 introduces the CategoryBar, IconCommand, PopupList UI elements as well as the Locale, Multipoint Touch and Orientation APIs. Version 1.7 introduces the File Select, Phone Settings, Contact, Image Scaling, Network State and Notifications APIs, while the com.nokia.mid.sound.Sound and com.nokia.mid.sound.SoundListener classes are removed.

Nokia UI API

Nokia Asha Software Platform 1.0

Series 40 6th Edition

Available Plug-ins in Nokia Asha and Series 40 software Platform

Developers can take advantage of plug-ins to enrich their application with additional functionalities. The plug-ins are not native APIs. They therefore need to be manually integrated into the working project as an external library, which results in an increased installation package (.jar file). Starting from Nokia SDK 2.0 for Java the plug-ins are available in the ./plugins folder of each SDK. The table below that shows all the available plug-ins.

Plug-in

Description

Supported from Nokia Asha software platform

Supported from Series 40 developer platform

LightWeight UI Toolkit (LWUIT)

LWUIT for Nokia is a customised version (for Nokia Asha and Series 40 software platform) of the popular Light Weight UI Toolkit (LWUIT). LWUIT has been optimised for Nokia Asha and Series 40 software platform with a number of styling, theming and functional changes. You can use LWUIT for Nokia to create rich user interface Java applications with quick and easy transitions and animations.

Nokia Asha Software Platform 1.0

Series 40 Developer Platform 2.0

HERE Maps API for Java ME

The HERE Maps API for Java ME is a set of programming interfaces that enable developers to build mobile device applications with mapping, search and routing functionality and targets devices that support the Mobile Information Device Profile (MIDP) for Java Micro Edition.

Nokia Asha Software Platform 1.0

Series 40 Developer Platform 2.0

Tantalum

Tantalum is a cross-platform Java library that provides a minimal set of functionality to easily create concurrent, networked applications.

Nokia Asha Software Platform 1.0

 

Nokia In-App Payment

Nokia In-App Payment offers simple, seamless integration of a payment event into any Java ME app published on Nokia Store for phones from the new Nokia Asha family on the Nokia Asha software platform to phones based on Series 40 6th Edition. With Nokia In-App Payment integrated into your app, consumers are able to purchase additional digital content from anywhere within your app.

Nokia Asha Software Platform 1.4

 

Support for additional Java APIs on Series 40 Lite

The Series 40 Lite platforms support a subset of the additional Java APIs supported by the corresponding regular Series 40 platform release. The Series 40 Lite platforms support the JSR-185 Java Technology for the Wireless Industry (JTWI) specification and not the JSR-248 Mobile Service Architecture (MSA) Subset specification.

Series 40 6th Edition Lite does not support the following APIs supported by Series 40 6th Edition:

  • JSR-179 Location API

  • JSR-226 Scalable 2D Vector Graphics API

  • JSR-234 Advanced Multimedia Supplements API

Otherwise, the Series 40 Lite platforms support the same APIs and API versions as the corresponding regular Series 40 platform release.