book

Quick Recipes on Symbian OS: Mastering C++ Smartphone Development

Name: Quick Recipes on Symbian OS: Mastering C++ Smartphone Development
Author: Michael Aubert
ISBN: 9780470997833

by Michael Aubert

August 2008

Intermediate to advanced

382 pages

8h 26m

English

Wiley

Read now

Unlock full access

Copyright
Foreword
About this Book
About the Authors
Michael AubertAlexey GusevTanzim HusainJenny MulhollandAntony PranataJukka SilvennoinenJo Stichbury
Acknowledgments
Symbian OS Code Conventions and Notations Used in the Book
1.1. Capitalization1.2. Prefixes1.3. Suffixes
1. Introduction and Setup
1.1. Tools: What You Need and Where to Find It1.1.1. System Requirements1.1.2. IDE1.1.3. SDKs1.1.4. Compilers1.2. While You are Waiting1.2.1. Carbide.c++1.2.2. Development Communities1.2.3. Concepts of Mobile Development1.2.4. ARM Hardware1.2.5. Emulator1.3. Post-Installation1.3.1. Command Line Tools1.3.2. SDK Directories Structure1.3.3. Emulators
2. Quick Start
2.1. Hello World Project Template2.2. Running Carbide.c++ IDE2.3. Generating the Hello World Project2.4. Building the Hello World Project2.5. Running the Hello World Application on the Emulator2.5.1. Configuring the Emulator2.6. Running the Hello World Application on the Device2.7. Modifying the Hello World Project2.7.1. Adding a New Menu Item2.7.2. Handling a Menu Event2.8. Advanced Topics on Carbide.c++2.8.1. Modifying the Project Files2.8.2. Importing Project Files2.8.3. Changing the Certificate/Key Pair2.9. Links
3. Symbian OS Development Basics
3.1. Fundamental Data Types on Symbian OS3.2. Symbian OS Class Conventions3.2.1. T Classes3.2.2. C Classes3.2.3. R Classes3.2.4. M Classes3.2.5. Static Classes3.3. Leaves and Exception Handling3.3.1. The Difference between Panics and Leaves3.3.2. TRAP and TRAPD Macros3.3.3. What Causes a Leave?3.3.4. new(ELeave)3.4. The Cleanup Stack3.5. The Cleanup Stack FAQ: Advanced Information3.5.1. Why Does PushL( ) Leave?3.5.2. Why Do I Get a Panic When I Try To Use the Cleanup Stack?3.5.3. Why Do I Get a Panic When My Code Leaves a TRAP?3.5.4. Why Do I Get a Panic When I Call CleanupStack::Pop( )?3.5.5. How Do I Mix Leaves, Exceptions and the Cleanup Stack?3.6. Two-Phase Construction3.7. Thin Templates3.8. Descriptors – Symbian OS Strings3.8.1. Character Size3.8.2. TDesC3.8.3. TDes3.8.4. The Derived Descriptor Classes3.8.5. Pointer Descriptors: TPtrC and TPtr3.8.6. Stack-Based Buffer Descriptors TBufC and TBuf3.8.7. Dynamic Descriptors: HBufC and RBuf3.8.8. Using RBuf3.8.9. Literal Descriptors3.8.10. Descriptor Class Types: Summary3.8.11. Using the Descriptor APIs3.8.12. Descriptors as Function Parameters and Return Types3.9. Arrays on Symbian OS3.9.1. Static Arrays3.9.2. Dynamic Arrays3.9.3. Cleanup of the RArray Classes3.9.4. When Should You Use CArrayX Arrays?3.9.5. Sorting and Searching3.10. Executable Files3.10.1. UID13.10.2. UID23.10.3. UID33.11. Platform Security: Capabilities3.12. Platform Security: Data Caging3.13. Stack Size and Heap Size3.14. Streams3.14.1. Externalize and Internalize3.15. Active Objects3.15.1. Preemption3.15.2. Class CActive3.15.3. Class TRequestStatus3.15.4. The Active Scheduler3.15.5. Common Problems with Active Objects3.16. Threads3.17. Timers and Callbacks3.18. Summary
4. Symbian C++ Recipes
4.1. File Handling4.1.1. Easy Recipes4.1.1.1. Get a File Server Session4.1.1.2. Write Binary Data to a File4.1.1.3. Read Binary Data from a File4.1.1.4. Read Text from a File4.1.2. Intermediate Recipes4.1.2.1. Get the Path of a Private Folder4.1.2.2. Read from and Write to a File Stream4.1.2.3. Read and Write Class Members from and to a File Stream4.1.3. Advanced Recipes4.1.3.1. Read from and Write to a File Store4.1.3.2. Share Files between Processes4.1.4. Resources4.2. Contacts and Calendar4.2.1. Before You Start with Contacts4.2.2. Before You Start with Calendar4.2.3. Easy Recipes4.2.3.1. Write Data to a Contact4.2.3.2. Read Data from a Contact4.2.3.3. Add a New Contact4.2.3.4. Remove a Contact4.2.3.5. Modify a Calendar Event4.2.3.6. Add a New Calendar Event4.2.3.7. Remove a Calendar Event4.2.4. Intermediate Recipes4.2.4.1. Sort Contacts4.2.4.2. Use the vCard Format4.2.4.3. Use the vCal Format4.2.4.4. Create a Repeating Calendar Event4.2.5. Advanced Recipes4.2.5.1. Find a Contact4.2.5.2. Move a Contact to Another Group4.2.5.3. Find Out If You are Available4.2.5.4. Get Attendee List4.3. Networking4.3.1. Getting Started4.3.2. Setting Up the Environment4.3.2.1. Using the SDK Configuration Tools4.3.2.2. Using WinPCap4.3.2.3. Using WinTAP4.3.2.4. Using WinSock4.3.3. HTTP4.3.4. InetProtUtils4.3.5. Easy Recipes4.3.5.1. Send/Receive Data Using TCP Sockets4.3.5.2. Force a Connection to Use a Specific Bearer4.3.5.3. Force a Connection to Use a Specific IAP4.3.5.4. Resolve Domain Name4.3.5.5. Use HTTP GET Request4.3.5.6. Parse a URI4.3.5.7. Create a URI4.3.6. Intermediate Recipes4.3.6.1. Listen for an Incoming Connection Using TCP4.3.6.2. Observe Connection Status4.3.6.3. Get Active Connection Information4.3.6.4. Use Secure Socket4.3.6.5. Use HTTP POST Request4.3.6.6. Set Advanced HTTP Properties4.3.6.7. Extract Local Filename from URI4.3.7. Advanced Recipes4.3.7.1. Retrieve HTTP Proxy Information4.3.8. Resources4.4. Messaging4.4.1. Supported Bearers4.4.2. SendAs4.4.3. Services4.4.4. The Message Store4.4.4.1. Structure and Main Classes4.4.4.2. Types of Entry4.4.3. Tips for Writing Messaging Applications4.4.3.1. Messaging Libraries4.4.3.2. Multimode SMS4.4.3.3. UI Implementation Differences4.4.3.4. Mail Store Debugging4.4.4. About the Recipes4.4.4.1. Required Capabilities4.4.5. Recipes4.4.5.1. Initialize your Application to Use Messaging4.4.5.2. Create a Folder4.4.5.3. Create a Message4.4.5.4. Read Message Details4.4.5.5. Edit a Message4.4.5.6. Retrieve and Edit Message Settings4.4.5.7. Copy a Message4.4.5.8. Move a Message4.4.5.9. Send a Message4.4.5.10. Delete Messages4.4.5.11. Handle Incoming Messages4.4.6. Resources4.5. Graphics and Drawing4.5.1. Easy Recipes4.5.1.1. Draw Lines and Shapes4.5.1.2. Draw Background Color or Fill a Shape4.5.1.3. Load and Draw MBM or MIF Images4.5.1.4. Draw an Image with a Transparent Section4.5.2. Intermediate Recipes4.5.2.1. Load a JPG or PNG Image4.5.2.2. Draw Text to the Screen4.5.2.3. Load Fonts4.5.2.4. Draw Controls Inside Another Control4.5.3. Advanced Recipes4.5.3.1. Use Off-Screen Images for Drawing4.5.3.2. Load GIF Animation Images4.5.3.3. Draw Skins as Backgrounds (S60 Only)4.5.3.4. Draw Outside the Symbian OS Application Framework4.5.3.5. Draw with Direct Screen Access4.6. 3D Graphics Using OpenGL ES4.6.1. OpenGL ES Primer4.6.2. OpenGL to OpenGL ES4.6.3. Easy Recipes4.6.3.1. Full-Screen Setup4.6.3.2. Display a 3D Object4.6.3.3. Translate a 3D Object4.6.3.4. Rotate a 3D Object4.6.4. Intermediate Recipes4.6.4.1. Apply a Texture to a 3D Object4.6.4.2. Part-Screen Setup4.6.5. Advanced Recipes4.6.5.1. Animate a Scene4.6.5.2. Adapt Performances4.6.6. Resources4.7. Multimedia4.7.1. Easy Recipes4.7.1.1. Play an Audio Clip4.7.1.2. Perform Basic Audio Operations4.7.1.3. Play an Audio Tone4.7.1.4. Play a MIDI File4.7.2. Intermediate Recipes4.7.2.1. Get the Default Multimedia Storage Location4.7.2.2. Play a Video Clip4.7.2.3. Audio Streaming4.7.3. Advanced Recipes4.7.3.1. Record Audio4.7.3.2. Record a Phone Call4.7.3.3. Display a Camera Viewfinder4.7.3.4. Capture Still Images from a Camera4.7.3.5. Record Video4.7.4. Resources4.8. Telephony4.8.1. Easy Recipes4.8.1.1. Handle Phone Calls4.8.1.2. Send DTMF Tones to the Phone Line4.8.1.3. Observe the Phone Line State4.8.1.4. Retrieve the Network Signal Strength4.8.1.5. Retrieve the Battery Status4.8.1.6. Retrieve the IMEI Number of the Device4.8.1.7. Retrieve the Current Network Name4.8.1.8. Retrieve the Current Operator Name4.8.1.9. Retrieve the Flight Mode Status4.8.1.10. Retrieve the Network Registration Status4.8.2. Intermediate Recipes4.8.2.1. Retrieve the Phone Number from an Incoming/Outgoing Call4.8.2.2. Match a Name to a Phone Number4.8.2.3. Retrieve the IMSI Number of the SIM Card4.8.2.4. Retrieve the Phone Lock Status4.8.3. Advanced Recipes4.8.3.1. Retrieve Cell ID and Network Information4.8.3.2. Retrieve Call Forwarding Status4.8.3.3. Retrieve Call Barring Status4.9. Connectivity4.9.1. Easy Recipes4.9.1.1. Print over IrDA4.9.1.2. Discover Infrared Devices4.9.1.3. Discover Bluetooth Devices4.9.1.4. Discover Bluetooth Services for a Given Device4.9.2. Intermediate Recipes4.9.2.1. Use the Sockets API4.9.2.2. Create a Simple OBEX Client4.9.2.3. Create a Simple OBEX Server over Bluetooth4.9.3. Advanced Recipes4.9.3.1. Advertise Bluetooth Services4.10. Location-Based Services4.10.1. Easy Recipes4.10.1.1. Get the List of Available Positioning Technology Modules4.10.1.2. Retrieve the Current Module Status Information4.10.1.3. Receive Module Status Change Notifications4.10.1.4. Set the Module Selection Criteria4.10.2. Intermediate Recipes4.10.2.1. Request Location Information4.10.2.2. Request Extended Location Information

5. Next Level Development
5.1. Advanced Technologies5.1.1. Publish and Subscribe: System-wide Properties5.1.2. Creating a Server Process: File Sharing5.1.3. Advanced Platform-Specific User Interface5.1.4. Advanced Messaging: A New Protocol5.2. Symbian Partners Only5.2.1. File Server Plug-in: Separate File System5.2.2. Advanced Multimedia: Additional Format Streaming5.3. Advanced Application Deployment5.3.1. Automatic Installation5.3.2. Custom Install5.3.3. Embedded Binaries
6. Releasing Your Application
6.1. What To Do Before You Release Your Application6.1.1. Look At It!6.1.2. Test It!6.1.3. Optimize It!6.1.4. Protect It!6.1.5. Sign It!6.1.6. Internationalize It!6.2. How To Distribute Your Application6.2.1. Network Operators6.2.2. Independent Software Channels6.2.3. Content Aggregators6.2.4. Pre-Installed Applications6.2.5. Open Source6.3. Where To Go Next6.3.1. Symbian Press Books6.3.2. Partnering with Symbian6.3.3. Partnering Within the Symbian Ecosystem

Content preview from Quick Recipes on Symbian OS: Mastering C++ Smartphone Development

Chapter 5. Next Level Development

This chapter gives you a glimpse of some advanced features of Symbian OS. If you want to take full advantage of these features, you will probably need to use some additional resources, such as the Symbian Developer Library, Symbian Press books or technical papers available on Symbian C++ developer community websites.

Advanced Technologies

Publish and Subscribe: System-wide Properties

You can find a full introduction to the Publish and Subscribe API at developer.symbian.com/main/downloads/papers/publishandsubscribe/PublishAndSubscribe_v1.0.pdf.

The Publish and Subscribe API in Symbian OS is basically a kernel-side hashtable that can only contain one value per key. The key of the hashtable should be a UID that you allocated. The value of the hashtable is a TInt or a TDesC (binary data or text, limited to 512 bytes).

Your code accesses the hashtable through the RProperty class. The API is fairly basic: add/remove key, get/set value. You can also receive notification if a value changes using RProperty::Subscribe(), which is an asynchronous request. Only one such request is allowed per RProperty instance at any given time.

Each property belongs to a category, identified by yet another UID. The category UID defaults to the secure identifier of the current process. It can be useful to you as a developer to have a look at all the properties in the KUidSystemCategoryValue category.

The main issue with the system category is to find all the property keys that belong ...

Become an O’Reilly member and get unlimited access to this title plus top books and audiobooks from O’Reilly and nearly 200 top publishers, thousands of courses curated by job role, 150+ live events each month,
and much more.

Read now

Unlock full access

More than 5,000 organizations count on O’Reilly

O’Reilly covers everything we've got, with content to help us build a world-class technology community, upgrade the capabilities and competencies of our teams, and improve overall team performance as well as their engagement.

Julian F.

Head of Cybersecurity

I wanted to learn C and C++, but it didn't click for me until I picked up an O'Reilly book. When I went on the O’Reilly platform, I was astonished to find all the books there, plus live events and sandboxes so you could play around with the technology.

Addison B.

Field Engineer

I’ve been on the O’Reilly platform for more than eight years. I use a couple of learning platforms, but I'm on O'Reilly more than anybody else. When you're there, you start learning. I'm never disappointed.

Amir M.

Data Platform Tech Lead

I'm always learning. So when I got on to O'Reilly, I was like a kid in a candy store. There are playlists. There are answers. There's on-demand training. It's worth its weight in gold, in terms of what it allows me to do.

Mark W.

Embedded Software Engineer

Developing Software for Symbian OS: A Beginner's Guide to Creating Symbian OS v9 Smartphone Applications in C++

Publisher Resources

ISBN: 9780470997833Purchase book

Cloud Computing

Data Engineering

Data Science

AI & ML

Programming Languages

Software Architecture

IT/Ops

Security

Design