Symbian/C++ Documentation

19-May-2009

Optimizing Mobile Software with Built-in Power Profiling
This document describes S60 software profiling tools that allow every developer to measure power consumption without any external equipment. Measurement analysis is carried out either on the mobile device or a PC. In addition, the document present a set of guidelines and good practices that energy-conscious developers should follow to maximise application use time. This document was originally published as a chapter in the book Mobile Phone Programming and its Application to Wireless Networking in 2007.
Document; Base/System, Optimization --- Power Management, Quality, S60, Symbian C++; English (en)

12-Feb-2009

S60 Platform: Descriptor Example
This C++ code example demonstrates how to use descriptors (Symbian OS strings) and related APIs. The example is an S60 application that is used to run one example method or all of them. The methods write a log on the screen or into a file that demonstrates the results of different statements. The example has been updated to support S60 5th Edition and touch UI. Important classes: TBuf, HBufC, RBuf.
Application --- Example; Base/System, Files/Data, S60 --- S60 3rd Edition / S60 5th Edition, Symbian C++; English (en)

09-Feb-2009

S60 Platform: Power and Resource Management Example
This C++ code example demonstrates the APIs that are available for figuring out battery, charger, and network status. It also demonstrates how to implement some of the power and resource management principles that have been discussed in the document S60 Platform: Effective Power and Resource Management. The updated example has been tested to support S60 5th Edition and touch UI. Main classes: CTelephony, CIdle, CActive.
Application --- Example; Base/System, Optimization --- Power Management, Quality, S60 --- S60 3rd Edition / S60 5th Edition, Symbian C++; English (en)

16-Jan-2009

S60 Platform: Time Zone Localiser Example
This C++ code example demonstrates how to convert UTC time to local time using the time zone server (RTz) and how to add, remove, or find a city in the database using the TZLocalizer API, introduced in Symbian OS v.9.1 (S60 3rd Edition). The updated example has been tested to support S60 5th Edition and touch UI. Main classes: RTz, CTzLocalizer.
Application --- Example; Base/System, Files/Data, S60 --- S60 3rd Edition / S60 5th Edition, Symbian C++; English (en)

02-Oct-2008

S60 Platform: Thread and Active Objects Example
The example demonstrates how to create an active scheduler and how to use active objects inside a new thread. Inside the main thread (main program) the framework creates the active scheduler automatically, but inside a new thread the active scheduler must be created by the developer. One active object is a Bluetooth device discoverer that searches Bluetooth devices in the vicinity and displays them in the listbox. The example has been tested to be compatible with S60 5th Edition and touch UI. Important classes and headers: RThread, RSocketServer, Btnotifier.h (Bluetooth notifier API).
Application --- Example; Base/System, S60 --- S60 3rd Edition / S60 5th Edition, Symbian C++; English (en)

31-Mar-2008

S60 Platform: Log Example
This C++ application demonstrates the usage of the Log Engine API provided by Symbian. The API is used to record events of interest to the user, of which they may not be immediately aware, or which are of high importance since costs are incurred, such as telephone calls. These events can be retrieved by a viewer application and displayed to the user. The Log Engine API is supported from S60 2nd Edition onwards. In the updated version, the timestamp offset of the log events has been corrected, backup & restore and scalability support has been added, and the application views have been simplified.
Application --- Example; Base/System, S60 --- S60 2nd Edition / S60 3rd Edition, Symbian C++; English (en)

06-Feb-2008

S60 Platform: Chinese Display Example
This C++ application demonstrates how to display Chinese characters from resource files. The application supports internationalization and localization. In the updated version also the context-sensitive help has been added. The application supports following languages: English, Taiwan Chinese, Taiwan English, HongKong Chinese, HongKong English, Mainland Chinese, and Mainland English. Main classes: TFontSpec, CCnvCharacterSetConverter
Application --- Example; Base/System, Localization, S60, Symbian C++, UI; English (en)

09-Jan-2008

Symbian OS Basics - Lab Exercises
These Symbian C++ examples provide exercises and solutions to the following topics: setting up a development environment and building a simple hello world application, Symbian OS basics, memory and resource management, descriptors, application structure overview, resource and localization files, client/server framework, and active object framework. The exercises complement Symbian OS Basics - Workbook training course material.
Application --- Example; Architecture/Design, Base/System, Symbian C++, Symbian OS, Training; English (en)

09-Jan-2008

Symbian OS Basics - Workbook
This updated Symbian C++ developer training courseware discusses memory and resource management, descriptors, application structure overview, resource and localization files, UI controls, client/server framework, and active object framework. The workbook also describes seven programming exercises (source code of the exercises is published separately in Symbian OS Basics - Lab Exercises package).
Document; Architecture/Design, Base/System, Symbian C++, Symbian OS, Training; English (en)

30-Nov-2007

S60 Platform: Effective Power and Resource Management
Learn how to reduce power and resource consumption in C++ applications without sacrificing their application performance. RAM usage, server design, code efficiency, battery monitoring, and moderate backlight usage are discussed. Available analyzer tools are also presented. The document refers to a separately published example application.
Document; Base/System, Optimization --- Power Management, Quality, S60, Symbian C++; English (en)

01-Nov-2007

S60 Platform: Document Handler API Developer's Guide
See this C++ document to learn how to use the Document Handler API to show different content in dedicated applications. These handler applications have been registered to be able to handle files with certain MIME types (for example, Notes can handle text format and Image Viewer can show different types of images). In the file opening process, the MIME type recognition is done using Recognizers (implemented as Ecom plugins from S60 3rd Edition onwards). Besides viewing, file operations like move and copy are used in many S60 applications. The document refers to a code example that is available at www.forum.nokia.com.
Document; Base/System, Files/Data, S60, Symbian C++; Adobe PDF (.pdf); English (en)

12-Jan-2007

S60 Platform: ECom Plug-in Architecture v2.0
This document describes the ECom framework and discusses why and how it should be used. ECom is a client/server framework that provides a service to instantiate, resolve, and destroy plug-ins. Essentially, it means that functionality that is required by a number of applications can be encapsulated in a dll plugin and accessed by multiple clients through an interface class. The document refers to a separately published code example.
Document; Base/System, S60, Symbian C++; Adobe PDF (.pdf); English (en)

12-Jan-2007

S60 Platform: ECom Plug-In Examples v2.0
This package includes two C++ code examples demonstrating how to create and use an ECom plug-in from a client application. ECom_Shape draws different figures and ECom_ Calculator performs calculation for two numbers using the ECom plug-in component. The examples consist of a custom ECom interface, a DLL plug-in component with actual implementations for the interface, a resolver (either a default or custom resolver), and a simple GUI client that uses the interface. Main classes: REComSession, TEComResolverParams, CEikLabel, CEikEdwin, TResourceReader, CResolver, TImplementationProxy.
Application --- Example; Base/System, S60, Symbian C++; Zip Archive (.zip); English (en)

22-Dec-2006

S60 Platform: Document Handler Example
This C++ example demonstrates how to use the Document Handler and the Recognizer to open and handle certain file types in a dedicated application. The example consists of three components: a caller application trying to open a specific file, a recognizer (a dll component implemented as an ECom plugin from S60 3rd Edition onwards) detecting the file extension, and a document handler opening the file. Note that for the recognizer, a developer certificate is needed due to its ProtServ capability requirement. Usage of the document handler is described in the S60 Platform: Document Handler API Developer's Guide document, available at www.forum.nokia.com. Main classes: CDocumentHandler, CApaDataRecognizerType.
Application --- Example; Base/System, Files/Data, S60, Symbian C++; Zip Archive (.zip); English (en)

15-Dec-2006

S60 Platform: System Initiated Events v2.1
This updated document describes several different common events that a C++ application can capture from a system. It focuses on events beneficial for application developers, for example, UI and domain specific events. The usage of Publish and Subscribe API and Central Repository are also discussed. While the document focuses on the S60 platform, the information is generally applicable to other devices that are based on Symbian OS.
Document; Base/System, S60, Symbian C++, Symbian OS; Adobe PDF (.pdf); English (en)

20-Sep-2006

S60 Platform: System Information Example v2.0
This C++ code example demonstrates how to retrieve system information such as software and language versions, running applications, active profile, and battery and network status information. For some of these tasks, the APIs are different for S60 2nd and 3rd Edition. Main classes: HAL, CRepository, CTelephony, CSettingInfo, RSystemAgent.
Application --- Example; Base/System, S60, Symbian C++; Zip Archive (.zip); English (en)

25-Nov-2005

S60 Platform: Multiple Threads Example v1.1
This package includes a C++ Thread example program that demonstrates thread usage and synchronization. A document explaining the use of threads in Symbian OS is included in the package.
Application --- Example; Base/System, S60, Symbian C++; Zip Archive (.zip); English (en)