|
1 <?xml version="1.0" encoding="utf-8"?> |
|
2 <!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. --> |
|
3 <!-- This component and the accompanying materials are made available under the terms of the License |
|
4 "Eclipse Public License v1.0" which accompanies this distribution, |
|
5 and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". --> |
|
6 <!-- Initial Contributors: |
|
7 Nokia Corporation - initial contribution. |
|
8 Contributors: |
|
9 --> |
|
10 <!DOCTYPE concept |
|
11 PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd"> |
|
12 <concept id="GUID-2DC89F9D-30E8-5260-8850-53E4152EE3CF" xml:lang="en"><title>Finding |
|
13 your way around</title><shortdesc>Read this page to learn about the contents and structure of the |
|
14 library.</shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody> |
|
15 <section id="GUID-91A35BDC-92E4-47D6-8A04-C6E0C444C484"><title>The platform |
|
16 structure and APIs</title> <p>The <xref href="GUID-32E29020-1956-461A-B79A-1492E06049E7.dita">Symbian |
|
17 Guide</xref> provides introductory documents to the platform |
|
18 as a whole, and guides that describe the major areas of the platform in depth. </p><p>The |
|
19 Symbian platform is a large system, and contains hundreds of C++ classes and |
|
20 thousands of member functions. Like most complex systems, it is easiest to |
|
21 divide it into large areas, and gradually to narrow your focus down to the |
|
22 areas that are most important to your tasks. </p><p>The <xref href="http://developer.symbian.org/wiki/index.php/Symbian_System_Model" scope="external">Symbian System Model</xref> organises the components of the |
|
23 Symbian platform into a layered software architecture. The guides in this |
|
24 library are also structured around this architecture. The guides describe |
|
25 the key technology and architectural concepts of the area, and show the key |
|
26 ways to use its classes.</p> <p>Note: Before the System Model was introduced, |
|
27 the Symbian platform used another architectural view based on large divisions |
|
28 called subsystems. Some documentation has not yet been changed to use the |
|
29 System Model rather than subsystems. </p> </section> |
|
30 <section id="GUID-5C4DC90E-DB65-4EB7-B271-D64D5FC5A065"><title>Newcomers to |
|
31 the Symbian platform</title> <p>For those developing on the Symbian platform |
|
32 for the first time, the <xref href="GUID-35D7EEFC-B2E4-5444-8875-2A24790E08C2.dita">Essential |
|
33 Idioms</xref> section describes the distinctive programming idioms and conventions |
|
34 of the Symbian platform. </p> </section> |
|
35 <section id="GUID-0AA83743-82BC-473B-ABFD-20FFD6AB6485"><title>Examples</title> <p>The <xref href="GUID-270C96B0-4BDF-5A18-A8FE-FA4F78BB34EE.dita">Examples</xref> section gives |
|
36 instructions for building and using the large set of C++ example projects |
|
37 that accompany the library. Projects include examples that demonstrate the |
|
38 use of fundamental Symbian platform classes, and many examples showing how |
|
39 to use particular Symbian platform C++ APIs. </p> <p>Example code is provided |
|
40 for illustrative and demonstration purposes, and should not be assumed to |
|
41 be useable as product code. </p></section> |
|
42 |
|
43 <section id="GUID-C5687256-B657-4D29-B280-1837D4F991AE"><title>Tools</title><p>The |
|
44 library does not include documentation for most tools, which are usually delivered |
|
45 separately from the Symbian platform code. See the <xref href="http://developer.symbian.org/wiki/index.php/Category:Tools" scope="external">Tools</xref> section of the <xref href="http://developer.symbian.org/" scope="external">Symbian Developer Community</xref> website.</p><p>The <xref href="GUID-A837D8F6-B9D3-5119-8C63-51772B388999.dita">Tools And Utilities</xref> section |
|
46 documents the tools that are delivered with the platform. In particular, the <xref href="GUID-B21141D4-3BFE-59C9-8D5F-147A93BE1C95.dita">Build Tools Guide</xref> and |
|
47 the <xref href="GUID-49397CFD-955A-5DF6-9251-368C44224966.dita">Build Tools Reference</xref> document |
|
48 the <cmdname>abld</cmdname>/<cmdname>bldmake</cmdname> (SBSv1) command line |
|
49 build tools, and explain the project file formats. </p></section> |
|
50 </conbody></concept> |