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