| author | Dominic Pinkman <dominic.pinkman@nokia.com> |
| Fri, 16 Jul 2010 17:23:46 +0100 | |
| changeset 12 | 80ef3a206772 |
| parent 9 | 59758314f811 |
| child 14 | 578be2adaf3e |
| permissions | -rw-r--r-- |
|
9
59758314f811
Week 23 contribution of PDK documentation content. See release notes for details. Fixes bugs Bug 2714, Bug 462.
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
5
diff
changeset
|
1 |
<?xml version="1.0" encoding="utf-8"?> |
|
59758314f811
Week 23 contribution of PDK documentation content. See release notes for details. Fixes bugs Bug 2714, Bug 462.
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
5
diff
changeset
|
2 |
<!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. --> |
|
59758314f811
Week 23 contribution of PDK documentation content. See release notes for details. Fixes bugs Bug 2714, Bug 462.
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
5
diff
changeset
|
3 |
<!-- This component and the accompanying materials are made available under the terms of the License |
|
59758314f811
Week 23 contribution of PDK documentation content. See release notes for details. Fixes bugs Bug 2714, Bug 462.
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
5
diff
changeset
|
4 |
"Eclipse Public License v1.0" which accompanies this distribution, |
|
59758314f811
Week 23 contribution of PDK documentation content. See release notes for details. Fixes bugs Bug 2714, Bug 462.
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
5
diff
changeset
|
5 |
and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". --> |
|
59758314f811
Week 23 contribution of PDK documentation content. See release notes for details. Fixes bugs Bug 2714, Bug 462.
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
5
diff
changeset
|
6 |
<!-- Initial Contributors: |
|
59758314f811
Week 23 contribution of PDK documentation content. See release notes for details. Fixes bugs Bug 2714, Bug 462.
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
5
diff
changeset
|
7 |
Nokia Corporation - initial contribution. |
|
59758314f811
Week 23 contribution of PDK documentation content. See release notes for details. Fixes bugs Bug 2714, Bug 462.
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
5
diff
changeset
|
8 |
Contributors: |
|
59758314f811
Week 23 contribution of PDK documentation content. See release notes for details. Fixes bugs Bug 2714, Bug 462.
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
5
diff
changeset
|
9 |
--> |
|
59758314f811
Week 23 contribution of PDK documentation content. See release notes for details. Fixes bugs Bug 2714, Bug 462.
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
5
diff
changeset
|
10 |
<!DOCTYPE concept |
|
59758314f811
Week 23 contribution of PDK documentation content. See release notes for details. Fixes bugs Bug 2714, Bug 462.
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
5
diff
changeset
|
11 |
PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd"> |
|
59758314f811
Week 23 contribution of PDK documentation content. See release notes for details. Fixes bugs Bug 2714, Bug 462.
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
5
diff
changeset
|
12 |
<concept xml:lang="en" id="GUID-70202CC9-BC49-539A-8255-4B0B9C24A702"><title> After Market Application Starter Overview</title><prolog><metadata><keywords/></metadata></prolog><conbody><p>AMA (After Market Application) Starter is a Symbian platform component that manages the launch of AMCs (After Market Components), such as applications and services, at phone boot time. </p> <section><title>Purpose</title> <p>The main purpose of AMA Starter is to launch AMCs at phone boot time based on the items in a Dynamic Startup Configuration (DSC). A DSC corresponds to a list of items stored in a DSC database. Each item represents an AMC to be launched when the phone is switched on. A DSC can contain zero or more components. </p> <p>The components are launched and monitored (if configured, using <xref href="GUID-70DA7D35-3EF3-5B9B-9E86-28893021A4A1.dita">System Health Manager</xref>) when the DSC list is processed by the <xref href="GUID-788BD091-186A-5E25-B058-952C7629A8D4.dita">System State Manager</xref>. </p> <p> <b>Note:</b> DSCs enable the phone boot procedure to be extended after the ROM image has been built. A DSC can include applications installed before or after the ROM is built. </p> </section> <section><title>Required background</title> <p>To use AMA Starter, familiarity with <xref href="GUID-788BD091-186A-5E25-B058-952C7629A8D4.dita">System State Manager</xref> and <xref href="GUID-DF3E24A4-8E97-5E26-8C24-5033A0716B5A.dita">System State Management Architecture</xref> is recommended. </p> </section> <section><title>Architecture</title> <p>The AMA Starter component is loaded as a DLL and is run by the System State Manager (SSM) component at phone boot time. The launching of AMCs at phone boot time by the AMA Starter component is triggered by the SSM component. Firstly, the EStart component loads the SSM component. Secondly, the SSM passes the DSC defined in the Static Command Lists (SCLs) or policy plug-ins to the AMA Starter component. Thirdly, AMA Starter loads the DSC that results in the launching of the AMCs at phone boot time. </p> <p> <b>Note:</b> Optionally, AMCs can be launched and monitored by the System Health Management component. </p> <p>The following figure illustrates the interactions between AMA Starter and other Symbian platform components: </p> <fig id="GUID-8C583C79-8457-553E-AAA3-B7F92D1BBEBB"><title> |
|
59758314f811
Week 23 contribution of PDK documentation content. See release notes for details. Fixes bugs Bug 2714, Bug 462.
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
5
diff
changeset
|
13 |
Interaction of AMA Starter and Symbian platform components |
|
12
80ef3a206772
Week 28 contribution of PDK documentation content. See release notes for details. Fixes bugs Bug 1897, Bug 344, Bug 2681, Bug 463, Bug 1522.
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
9
diff
changeset
|
14 |
</title> <image href="GUID-45580F91-F1E2-5F6F-9449-5C7B5009EC44_d0e177969_href.png" placement="inline"/></fig> </section> <section><title>APIs</title> <table id="GUID-00024226-5A3C-5AE2-9C9D-2BBEDA9909FD"><tgroup cols="2"><colspec colname="col0"/><colspec colname="col1"/><thead><row><entry>API</entry> <entry>Description</entry> </row> </thead> <tbody><row><entry><p> <xref href="GUID-EB3CA81E-8684-3851-A556-1C91CAD3891F.dita"><apiname>RDscStore</apiname></xref> </p> </entry> <entry><p>Provides the client interface for managing the DSC database. </p> </entry> </row> <row><entry><p> <xref href="GUID-54F2480A-07A1-3FA1-920D-5F1D3469C40B.dita"><apiname>CDscItem</apiname></xref> </p> </entry> <entry><p>Contains application/process information required by the AMA Starter to launch an AMA. </p> </entry> </row> </tbody> </tgroup> </table> </section> <section><title>Typical uses</title> <p>Device creators can use the AMA Starter APIs to manage items in the DSC database. Once a connection has been established with the DSC database, device creators can perform the following tasks: </p> <ul><li id="GUID-E5FEF5A8-7EF2-54B4-9FB3-EB7EDAA45136"><p>Add an AMC to the start-up list by adding an item to a DSC using <xref href="GUID-EB3CA81E-8684-3851-A556-1C91CAD3891F.dita#GUID-EB3CA81E-8684-3851-A556-1C91CAD3891F/GUID-11BA9684-72EF-329F-B94B-223515E1133A"><apiname>RDscStore::AddItemL()</apiname></xref>. </p> </li> <li id="GUID-16B9C3A4-1432-5C39-8260-1CFE31B1614B"><p>Modify the start-up behavior of an AMC by modifying the associated item in the DSC using <xref href="GUID-EB3CA81E-8684-3851-A556-1C91CAD3891F.dita#GUID-EB3CA81E-8684-3851-A556-1C91CAD3891F/GUID-9BB82550-B622-3777-BC4B-6966D4EC6995"><apiname>RDscStore::UpdateItemL()</apiname></xref>. </p> </li> <li id="GUID-1E2B5B1F-DAF0-512A-9449-717119927440"><p>Remove an AMC from the start-up list by removing the associated item from the DSC using <xref href="GUID-EB3CA81E-8684-3851-A556-1C91CAD3891F.dita#GUID-EB3CA81E-8684-3851-A556-1C91CAD3891F/GUID-F2A782F7-B0C4-308D-A9EF-64FB5BE41FF7"><apiname>RDscStore::DeleteItemL()</apiname></xref>. </p> </li> <li id="GUID-34606C2C-5BFB-5B18-95A2-E03EBF2ACAC4"><p>Add or remove a DSC from the DSC database using <xref href="GUID-EB3CA81E-8684-3851-A556-1C91CAD3891F.dita#GUID-EB3CA81E-8684-3851-A556-1C91CAD3891F/GUID-03E5738C-6D3B-3A59-A627-ED655566E552"><apiname>RDscStore::CreateDscL()</apiname></xref> or <xref href="GUID-EB3CA81E-8684-3851-A556-1C91CAD3891F.dita#GUID-EB3CA81E-8684-3851-A556-1C91CAD3891F/GUID-88278C76-7BAE-38A0-8FEF-C61E6C901D21"><apiname>RDscStore::DeleteDscL()</apiname></xref>. </p> </li> </ul> <p>For more information on how to perform these tasks, see the <xref href="GUID-C1BEF313-ED22-5904-9648-740D069331ED.dita">After Market Application Starter Tutorial</xref> section. </p> </section> </conbody></concept> |