Wiley.Developing.Software.for.Symbian.OS.2nd.Edition.Dec.2007 (Symbian Books)

Developing Software forSymbian OSA Beginner’s Guide to CreatingSymbian OS v9 SmartphoneApplications in C++Developing Software forSymbian OSA Beginner’s Guide to CreatingSymbian OS v9 SmartphoneApplications in C++Steve BabinReviewed byAntony Pranata, Bruce Carney, Chris Notton, Douglas Feather,Freddie Gjertsen, Howard Sykes, Jehad Al-Ansari, Jo Stichbury,Laura Sykes, Lucinda Barlow, Mark Jacobs, Matthew O’Donnell,Neil Hepworth, Ricky Junday, Roderick Burns, Steve Rawlings,and Warren DayHead of Symbian PressFreddie GjertsenManaging EditorSatu McNabbCopyright ¤ 2007John Wiley & Sons Ltd, The Atrium, Southern Gate, Chichester,West Sussex PO19 8SQ, EnglandTelephone (+44) 1243 779777Email (for orders and customer service enquiries): cs-books@wiley.co.ukVisit our Home Page on www.wileyeurope.com or www.wiley.comAll Rights Reserved.

No part of this publication may be reproduced, stored in a retrieval system ortransmitted in any form or by any means, electronic, mechanical, photocopying, recording, scanning orotherwise, except under the terms of the Copyright, Designs and Patents Act 1988 or under the terms ofa licence issued by the Copyright Licensing Agency Ltd, 90 Tottenham Court Road, London W1T 4LP,UK, without the permission in writing of the Publisher. Requests to the Publisher should be addressed tothe Permissions Department, John Wiley & Sons Ltd, The Atrium, Southern Gate, Chichester, WestSussex PO19 8SQ, England, or emailed to permreq@wiley.co.uk, or faxed to (+44) 1243 770620.Designations used by companies to distinguish their products are often claimed as trademarks.

Allbrand names and product names used in this book are trade names, service marks, trademarks orregistered trademarks of their respective owners. The Publisher is not associated with any product orvendor mentioned in this book.This publication is designed to provide accurate and authoritative information in regard to the subjectmatter covered. It is sold on the understanding that the Publisher is not engaged in renderingprofessional services. If professional advice or other expert assistance is required, the services of acompetent professional should be sought.Other Wiley Editorial OfficesJohn Wiley & Sons Inc., 111 River Street, Hoboken, NJ 07030, USAJossey-Bass, 989 Market Street, San Francisco, CA 94103-1741, USAWiley-VCH Verlag GmbH, Boschstr.

12, D-69469 Weinheim, GermanyJohn Wiley & Sons Australia Ltd, 42 McDougall Street, Milton, Queensland 4064, AustraliaJohn Wiley & Sons (Asia) Pte Ltd, 2 Clementi Loop #02-01, Jin Xing Distripark, Singapore 129809John Wiley & Sons Canada Ltd, 6045 Freemont Blvd, Mississauga, Ontario, L5R 4J3, CanadaWiley also publishes its books in a variety of electronic formats. Some content that appearsin print may not be available in electronic books.Anniversary Logo Design: Richard J.

PacificoBritish Library Cataloguing in Publication DataA catalogue record for this book is available from the British LibraryISBN: 978-0-470-72570-2Typeset in 10/12pt Optima by Laserwords Private Limited, Chennai, IndiaPrinted and bound in Great Britain by Bell & Bain, GlasgowThis book is printed on acid-free paper responsibly manufactured from sustainable forestryin which at least two trees are planted for each one used for paper production.ContentsForeword (Jo Stichbury)ixForeword (Warren Day)xiBiographyAuthor AcknowledgmentsxiiixvSymbian Press AcknowledgmentsxviiSymbian OS Code Conventions and Notations Usedin the Bookxix1Smartphones and Symbian OS1.11.21.31.41.51.61.72Notes on this New EditionSmartphone ConceptsSmartphone FeaturesThe Mobile OSSymbian OS – A Little HistorySymbian OS SmartphonesOther Smartphone Operating Systems112311121520Symbian OS Quick Start232.12.22.32.423313856What Do You Need to Get Started?Firing Up the Development ToolsSimple Example ApplicationBuilding and Executing on the EmulatorviCONTENTS2.52.634633.13.23.33.43.53.63.73.83.93.103.113.12636465687077818385869090Components in Symbian OSMultitasking in Symbian OSShared Code: Libraries, DLLs, and FrameworksClient–Server ModelMemory in Symbian OSThe KernelActive Objects and Asynchronous FunctionsGUI ArchitectureHigh-Performance GraphicsThe Communication ArchitectureApplication Engines and ServicesPlatform SecuritySymbian OS Programming BasicsUse of C++ in Symbian OSNon-standard C++ CharacteristicsBasic Data TypesSymbian OS ClassesException Error Handling and CleanupLibrariesExecutable FilesNaming ConventionsSummarySymbian OS Build Environment5.15.25.35.45.55.65.75.85.965859Symbian OS Architecture4.14.24.34.44.54.64.74.84.95A Carbide.c++ ProjectBuilding for the SmartphoneSDK Directory StructureBuild System OverviewBasic Build FlowBuild TargetsWhat is a UID?The EmulatorBuilding Shared LibrariesDLL Interface FreezingInstalling Applications on the SmartphoneStrings, Buffers, and Data Collections6.16.26.36.46.5Introducing the Text ConsoleDescriptors for Strings and Binary DataThe Descriptor ClassesDescriptor MethodsConverting Between 8-Bit and 16-Bit Descriptors93939494951011151181191221231231261261311351371411441491611611651681861986.66.76.86.97Dynamic BuffersTemplates in Symbian OSArraysOther Data Collection Classes199203205213What is Platform Security?What Platform Security is NotWhat this Means to a DeveloperCapabilities for API SecurityApplication Signing in SymbianGetting Your Application Symbian SignedDeveloper CertificatesAsynchronous Functions and Active Objects8.18.28.38.48.58.68.78.88.98.109viiPlatform Security and Symbian Signed7.17.27.37.47.57.67.78CONTENTSAsynchronous FunctionsIntroducing Active ObjectsThe Active SchedulerActive Scheduler Error HandlingActive Object PrioritiesCanceling Outstanding RequestsRemoving an Active ObjectActive Object ExampleActive Object IssuesUsing Active Objects for Background TasksProcesses, Threads, and Synchronization9.19.29.39.49.5ProcessesUsing Threads on Symbian OSSharing Memory Between ProcessesMemory ChunksThread Synchronization10 Client–Server Framework10.110.210.3217217218219219232238244247247249254258260260262262269271277277286292293297303Client–Server OverviewA Look at the Client–Server ClassesClient–Server Example30430530611 Symbian OS TCP/IP Network Programming32311.111.211.311.411.5Introduction to TCP/IPNetwork Programming Using SocketsSymbian OS Socket APIExample: Retrieving Weather InformationMaking a Network Connection324327334345356viiiCONTENTS12 GUI Application Programming12.112.212.312.412.512.612.712.8Symbian OS User InterfacesAnatomy of a GUI ApplicationApplication ClassesResource FilesDialogsSymbian OS ControlsView ArchitectureApplication Icon and CaptionReferencesIndex359360365367377387405409409413415ForewordJo StichburySymbian PressSymbian has recently reported combined cumulative licensee sales ofover 145 million smartphones worldwide.

And with over 120 smartphone models available, Symbian has by far the largest installed base ofsmartphones, at approximately 72% of the market. Calculations suggestthat there are two Symbian smartphones shipping every second.Symbian smartphone users can buy and install after-market applications, and evidence is that they are doing this in increasing numbers.Symbian Signed has recently reached a milestone, having signed over20,000 application and content files, ranging from games and multimediaapplications to enterprise and messaging utilities.Symbian OS is a great platform for creating applications such asthese, and others. New handsets are shipping with technologies such asWi-Fi, GPS, DVB-H, HSDPA, IMS, multi-megapixel cameras, multi-GBstorage, biometrics, industry-leading security, 3D hardware acceleratedgraphics, tilt-sensors, DNLA and uPnP (Universal Plug and Play), demandpaging, VoIP and much more.

. . there’s scope to create some of the mostimaginative smartphone applications ever.What about the people creating these applications? Symbian has over300 Platinum Partner companies and a community of over 55,000 developers. These are not just based in mainland Europe, but are worldwide:in Australia, Canada, Brazil, USA, India, People’s Republic of China,Russian Federation, Singapore, Japan, and Thailand, to name just a fewof the countries where Accredited Symbian Developers can be found.Symbian OS offers a range of development environments for application development, from C and C++ to managed runtime environmentssuch as Java, Python, and Ruby.

The best access to the smartphonexFOREWORDhardware, and the best performance on Symbian OS, comes from nativeC++ and Software Development Kits for both major UI platforms – S60and UIQ – are freely available. But, however available a developmentenvironment may be, it isn’t necessarily easy to start work on a platform,particularly a mobile operating system that demands robust and efficientcode.

Newcomers to Symbian OS can be intimidated by the vocabularyand the range of information, libraries, and tools provided.This book sets out to make it easier to get started. It is aimed primarilyat C++ developers who are new to Symbian development. It makesno assumptions of knowledge about Symbian OS, or any other mobileplatform, although it does assume a reasonable understanding of C++.After introducing the Symbian platform and explaining how you canget the tools and kits you need, Steve goes through the fundamentaltopics needed to write an application to run on either UI platform builton Symbian OS v9 (UIQ 3 and S60 3rd Edition).