7 Nokia Corporation - initial contribution. |
7 Nokia Corporation - initial contribution. |
8 Contributors: |
8 Contributors: |
9 --> |
9 --> |
10 <!DOCTYPE concept |
10 <!DOCTYPE concept |
11 PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd"> |
11 PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd"> |
12 <concept id="GUID-2DC89F9D-30E8-5260-8850-53E4152EE3CF" xml:lang="en"><title>Finding |
12 <concept id="GUID-2DC89F9D-30E8-5260-8850-53E4152EE3CF" xml:lang="en"><title>Finding your way around</title><shortdesc>Read this page to learn about the contents and structure |
13 your way around</title><shortdesc>Read this page to learn about the contents and structure of the |
13 of the library.</shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody> |
14 library.</shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody> |
14 <section id="GUID-91A35BDC-92E4-47D6-8A04-C6E0C444C484"><title>The |
15 <section id="GUID-91A35BDC-92E4-47D6-8A04-C6E0C444C484"><title>The platform |
15 platform structure and APIs</title> <p>The <xref href="GUID-32E29020-1956-461A-B79A-1492E06049E7.dita">Symbian Guide</xref> provides introductory documents to the platform as a whole, and |
16 structure and APIs</title> <p>The <xref href="GUID-32E29020-1956-461A-B79A-1492E06049E7.dita">Symbian |
16 guides that describe the major areas of the platform in depth. </p><p>The Symbian platform is a large system, and contains hundreds |
17 Guide</xref> provides introductory documents to the platform |
17 of C++ classes and thousands of member functions. Like most complex |
18 as a whole, and guides that describe the major areas of the platform in depth. </p><p>The |
18 systems, it is easiest to divide it into large areas, and gradually |
19 Symbian platform is a large system, and contains hundreds of C++ classes and |
19 to narrow your focus down to the areas that are most important to |
20 thousands of member functions. Like most complex systems, it is easiest to |
20 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 |
21 divide it into large areas, and gradually to narrow your focus down to the |
21 of the Symbian platform into a layered software architecture. 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 |
22 guides in this library are also structured around this architecture. |
23 Symbian platform into a layered software architecture. The guides in this |
23 The guides describe the key technology and architectural concepts |
24 library are also structured around this architecture. The guides describe |
24 of the area, and show the key ways to use its classes.</p> <p>Note: |
25 the key technology and architectural concepts of the area, and show the key |
25 Before the System Model was introduced, the Symbian platform used |
26 ways to use its classes.</p> <p>Note: Before the System Model was introduced, |
26 another architectural view based on large divisions called subsystems. |
27 the Symbian platform used another architectural view based on large divisions |
27 Some documentation has not yet been changed to use the System Model |
28 called subsystems. Some documentation has not yet been changed to use the |
28 rather than subsystems. </p> </section> |
29 System Model rather than subsystems. </p> </section> |
29 <section id="GUID-5C4DC90E-DB65-4EB7-B271-D64D5FC5A065"><title>Newcomers |
30 <section id="GUID-5C4DC90E-DB65-4EB7-B271-D64D5FC5A065"><title>Newcomers to |
30 to the Symbian platform</title> <p>For those developing on the Symbian |
31 the Symbian platform</title> <p>For those developing on the Symbian platform |
31 platform for the first time, the <xref href="GUID-35D7EEFC-B2E4-5444-8875-2A24790E08C2.dita">Essential Idioms</xref> section describes the distinctive programming idioms and conventions |
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> |
32 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 |
33 <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 instructions for building and using the large set |
36 instructions for building and using the large set of C++ example projects |
34 of C++ example projects that accompany the library. Projects include |
37 that accompany the library. Projects include examples that demonstrate the |
35 examples that demonstrate the use of fundamental Symbian platform |
38 use of fundamental Symbian platform classes, and many examples showing how |
36 classes, and many examples showing how to use particular Symbian platform |
39 to use particular Symbian platform C++ APIs. </p> <p>Example code is provided |
37 C++ APIs. </p> <p>Example code is provided for illustrative and demonstration |
40 for illustrative and demonstration purposes, and should not be assumed to |
38 purposes, and should not be assumed to be useable as product code. </p></section> |
41 be useable as product code. </p></section> |
39 <section id="GUID-F8410B90-5208-4E73-A4C1-FA951429403A"><title>Hardware integration</title> <p>The library provides the following guides related to hardware |
42 <section id="GUID-F8410B90-5208-4E73-A4C1-FA951429403A"><title>Hardware |
40 integration. </p> <p><b> Kernel and Hardware Services guide</b> </p> <p>The <xref href="GUID-E3D2A6ED-8192-563D-8966-DD96B3AF1783.dita">Kernel |
43 integration</title> <p>The library provides the following guides related to |
41 and Hardware Services Guide</xref> provides information for device |
44 hardware integration. </p> <p><b> Kernel and Hardware Services guide</b> </p> <p>The <xref href="GUID-E3D2A6ED-8192-563D-8966-DD96B3AF1783.dita">Kernel and Hardware Services |
42 creators and silicon vendors who port the Symbian platform base to |
45 Guide</xref> provides information for device creators and silicon vendors |
43 new hardware. The porting process is explained through a Template |
46 who port the Symbian platform base to new hardware. The porting process is |
44 port. </p> <p><b> Device Driver guide</b> </p> <p>The <xref href="GUID-0437DB4C-FC4E-51DC-BB4C-95C0B26834F5.dita">Device Driver Guide</xref> contains information on writing device drivers to run on the Symbian |
47 explained through a Template port. </p> <p><b> Device Driver guide</b> </p> <p>The <xref href="GUID-0437DB4C-FC4E-51DC-BB4C-95C0B26834F5.dita">Device Driver Guide</xref> contains |
45 platform. It gives an overview that explains the device driver model |
48 information on writing device drivers to run on the Symbian platform. It gives |
46 as used in the Symbian platform, and then goes on to explain what |
49 an overview that explains the device driver model as used in the Symbian platform, |
47 you need to do in order to write a driver. </p> </section> |
50 and then goes on to explain what you need to do in order to write a driver. </p> </section> |
48 <section id="GUID-C5687256-B657-4D29-B280-1837D4F991AE"><title>Tools</title><p>The library does not include documentation for most tools, which |
51 <section id="GUID-C5687256-B657-4D29-B280-1837D4F991AE"><title>Tools</title><p>The |
49 are usually delivered separately from the Symbian platform code. See |
52 library does not include documentation for most tools, which are usually delivered |
50 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 |
53 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 |
51 Community</xref> website.</p><p>The Tools section documents |
54 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 |
52 the tools that are delivered with the platform. In particular, the |
55 the <xref href="GUID-49397CFD-955A-5DF6-9251-368C44224966.dita">Build Tools Reference</xref> document |
53 Build Tools Guide and the Build Tools Reference document the <cmdname>abld</cmdname>/<cmdname>bldmake</cmdname> (SBSv1) command line build |
56 the <cmdname>abld</cmdname>/<cmdname>bldmake</cmdname> (SBSv1) command line |
54 tools, and explain the project file formats. </p></section> |
57 build tools, and explain the project file formats. </p></section> |
|
58 </conbody></concept> |
55 </conbody></concept> |