×
Namespaces

Variants
Actions
Revision as of 16:12, 22 May 2008 by ltomuta (Talk | contribs)

SDK API Plug-in

From Nokia Developer Wiki
Jump to: navigation, search


As a response to the frequent requests expressed by the 3rd party developers for more internal APIs to be released, Forum Nokia is providing the S60 API Partnering process through which any developer can apply for access to the APIs needed to implement a given functionality. Whether the request is approved or not it all depends on the business justification provided and the current status of the APIs ( binary compatibility breaks, API deprecation, security considerations ... )

The receiver of the API should understand that despite the initial testing, which is intended to show that the API works on the targeted device, no guarantees can be given with regards to the binary compatibility or the availability of the API across platform version or even within devices released based on the current platform version.

As the number of processed API Partnering requests grew, the decision was made that some of the partnered APIs are released to the whole developer community. However, due to the above mentioned binary compatibility issues the release was made without any marketing campaign and the API Packages were released in archived mode.

The following very important message accompanies the plug-in and is also included in each API's release notes, please read carefully:



PLEASE NOTICE THE FOLLOWING ISSUES WITH THESE APIs:

  1. Nokia is not giving any binary compatibility promise for these APIs; neither between platform versions or within a platform version.
  2. You must test your application with each device that the application can be installed on. This is needed to ensure the best possible user experience. To prevent application installation on other than tested devices, define the Product ID(s) (also known as Machine UID) in the .pkg file. More information can be found in the document S60 Platform: Identification Codes available on the Forum Nokia Web site.


The API plug-in package is also covered by a click through Limited License Agreement (LLA), the content of which is also included in the package. The use of the API included in the API Plug-in assumes that the LLA is implicitly accepted.

Template:NoteS

The content of the Limited License Agreement (LLA) has been updated to address the concerns regarding the usage of the API in 3rd Party projects.

Template:NoteE

The Plug-ins

Currently the following API Plug-in packages are available:

API Plug-in for the S60 3rd Edition SDK for Symbian OS, for C++, MR


The following APIs are included:

Adaptive History List API AIW Criteria API
AIW Generic Parameters API AIW Service Handler API
Audio Metadata Reader API Audio Proxy Server API v2.43
Bluetooth Engine API Browser Launcher API
Camera Application Engine API CR Keys To Control Phone Volume API
Data Connection Log Counters API Extended AIW Criteria API
Extended Skins API Item Finder API
KAccessoryModeChanged API KAlarmClockOne API
KCoreAppUIsNewEmailStatus API Logs Client API
Logs Timers API Media Player Engine API
Media Recorder API Meeting Request API
MMFDevSound API New File Service Client API
OMA Provisioning Adapter API Personalisation Skins Settings API
Phone Client Dial API Phone Client Extension API
Profiles Engine API Profiles Engine Extended API
Profile UID API PS Keys for Call Status & Indicators API
S60 RTP/RTC API ScShortcuts Engine Wrapper API
Settings Framework API SMS Utilities API
SW Installer Launcher API SyncML Client API
WLAN Info API WLAN Settings UI API
WLAN Management API




























API Plug-in for the S60 3rd Edition SDK for Symbian OS, for C++, supporting Feature Pack 1


The following APIs are included:

Adaptive History List API AIW Criteria API
AIW Generic Parameters API AIW Service Handler API
Audio Metadata Reader API Audio Proxy Server API v2.43 (deprecated)
Audio Routing API Bluetooth Engine API
Browser Launcher API CR Keys To Control Phone Volume API
Data Connection Log Counters API Extended AIW Criteria API
Extended Skins API Item Finder API
KAccessoryModeChanged API KAlarmClockOne API
KCoreAppUIsNewEmailStatus API Logs Client API
Logs Timers API Media Player Engine API
Media Recorder API Meeting Request API
MMFDevSound API Music Player Remote Control API
New File Service Client API OMA Provisioning Adapter API
Personalisation Skins Settings API Phone Client Dial API
Phone Client Extension API Profiles Engine Extended API
Profile UID API PS Keys for Call Status & Indicators API
S60 RTP/RTC API ScShortcuts Engine Wrapper API
Settings Framework API SMS Utilities API
SW Installer Launcher API SyncML Client API
WLAN Info API WLAN Management API
Call Audio Control API (new) VoIP Audio Services API (new)




























API Plug-in for the S60 3rd Edition SDK for Symbian OS, for C++, supporting Feature Pack 2


The following APIs are included:





























FAQ

  • Question: The API I am using is not working on some devices. Should I report this as a bug against the platform?
  • Answer: It is likely that this is due to a scheduled change in API's implementation, however, if you see the bug as also affecting the firmware components then the best approach would be to report it.

  • Question: Will there be an announcement that a BC break was introduced in one of the S60 Platform builds if it affects one of the APIs from the plug-in?
  • Answer: This kind of notification will be provided on best effort bases.

  • Question: The APIs included in the plug-in are poorly documented. Where can I find better documentation?
  • Answer: As the APIs were not intended for publishing there is no SDK level documentation available for them. These wiki pages are intended to compensate this documentation gap.

  • Question: Are there any example applications available for these APIs?
  • Answer: The only API that includes an example application is the Audio Proxy Server. More examples will be added to this wiki page as they will become available. You are of course welcome to contribute.

  • Question: One of the existing APIs solves partly my problem but for a full solution I need access to another internal API. Can you provide that API in the same plug-in?
  • Answer: Each API has been released with a specific use case in mind. If you need some other API to accomplish your task, it is likely that you are outside the intended use case and the only solution for you is the S60 API Partnering process. Please note that if the dependency is on a Symbian owned API, you will have to contact Symbian Ltd. for requesting the API.

  • Question: The API I need requires manufacturer granted capabilities. Are these capabilities going to be granted to me?
  • Answer: The standard process for requesting manufacturer approved capabilities applies for these APIs too.

  • Question: Are you publishing all the frequently requested APIs in these plug-ins?
  • Answer: Only the APIs which are considered stable enough and of wide interest are released in this plug-in. A special case is the API needed for creating Active Idle plug-ins as though it otherwise meets the criteria for being released in this plug-in it also requires for the developed 3rd party plug-in to be enabled in the firmware (i.e. firmware variant creation) and this makes the API unusable for most developers.

  • Question: Where can I find the WINSCW/GCCE libraries for these APIs?
  • Answer: The libraries included in this package are built at a later date that the public SDK. To speed up the release date and to avoid SDK incompatibilities it was decided that the WINSCW libraries will not be published. For the GCCE platform the ARMV5 libraries are used seamlessly.



711 page views in the last 30 days.
×