org.symbian.wrttools.doc.WRTKit/html/WRTKit_RSS_Reader_Tutorial-GUID-678d197f-c7b0-4e5e-85e2-f8549c75bbe8.html
author tasneems@symbian.org
Thu, 04 Mar 2010 15:42:37 -0800
changeset 220 41890dfa56f5
permissions -rw-r--r--
Fixed 2046 - added support for WRTKit help
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
220
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
     1
<?xml version="1.0" encoding="UTF-8"?><!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
     2
<html lang="en" xml:lang="en">
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
     3
<head>
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
     4
<meta content="text/html; charset=utf-8" http-equiv="Content-Type" />
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
     5
<meta name="copyright" content="(C) Copyright 2005" />
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
     6
<meta name="DC.rights.owner" content="(C) Copyright 2005" />
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
     7
<meta content="concept" name="DC.Type" />
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
     8
<meta name="DC.Title" content="RSS Reader" />
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
     9
<meta scheme="URI" name="DC.Relation" content="WRTKit_Tutorials-GUID-506c11e3-e6f3-43ec-9495-fcfa638b7e08.html" />
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    10
<meta scheme="URI" name="DC.Relation" content="WRTKit_RSS_Reader_first_steps-GUID-db42b227-1647-4020-bdb9-dacb26771779.html" />
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    11
<meta scheme="URI" name="DC.Relation" content="WRTKit_RSS_Reader_user_interface-GUID-1083a0c4-a953-4b6e-a4d0-45a031e51c35.html" />
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    12
<meta scheme="URI" name="DC.Relation" content="WRTKit_Feed_updates-GUID-25cd0e54-0516-4469-965e-c5781cf44dc9.html" />
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    13
<meta content="XHTML" name="DC.Format" />
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    14
<meta content="GUID-678D197F-C7B0-4E5E-85E2-F8549C75BBE8" name="DC.Identifier" />
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    15
<meta content="en" name="DC.Language" />
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    16
<link href="commonltr.css" type="text/css" rel="stylesheet" />
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    17
<title>
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    18
RSS Reader</title>
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    19
</head>
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    20
<body id="GUID-678D197F-C7B0-4E5E-85E2-F8549C75BBE8"><a name="GUID-678D197F-C7B0-4E5E-85E2-F8549C75BBE8"><!-- --></a>
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    21
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    22
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    23
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    24
    <h1 class="topictitle1">
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    25
RSS Reader</h1>
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    26
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    27
    <div>
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    28
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    29
        <p>
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    30
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    31
            The RSS Reader example is the first complete, working widget that actually
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    32
            does something useful that you will create using the WRTKit. It is quite a bit
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    33
            more complex than the Hello World example, but then again it also contains
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    34
            a lot more functionality.
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    35
        </p>
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    36
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    37
        <p>
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    38
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    39
            For the Hello World widget we covered a lot of very fine details but for the
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    40
            RSS Reader it is assumed that the reader already knows the basics of how to
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    41
            create a widget, deploy it, test it, and so on. If you skipped the Hello World
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    42
            tutorial and feel that you're not comfortable with the basics of creating
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    43
            widgets yet then it's recommended that you go back and read the Hello World
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    44
            widget tutorial first and then come back and continue with the RSS Reader.
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    45
        </p>
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    46
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    47
        <p>
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    48
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    49
            The RSS Reader that we're going to build in this tutorial will have two views:
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    50
            a main view that displays news items from an RSS feed and a settings view where
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    51
            the user can configure what news feed should be displayed in the main view and
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    52
            how often it should be updated from the Internet. We will let users choose from
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    53
            a list of feeds that we will pre-configure. In principle you can use whatever
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    54
            RSS feeds you want in your own widget but it's probably best to test first with
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    55
            the ones we have in our example since they have been tested and known to work.
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    56
        </p>
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    57
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    58
        <p>
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    59
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    60
            The actual news feed items will be displayed as a list of foldable content
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    61
            panels on the main view. The panels allow the user to see the headline for each
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    62
            piece of news and clicking on the headline will expand the news item so that the
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    63
            actual story summary can be read. At the bottom of the summary we'll place a
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    64
            link to the full story in a similar fashion to many other RSS reader applications.
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    65
        </p>
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    66
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    67
        <p>
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    68
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    69
            We will also implement a couple of features to make the widget more user friendly.
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    70
            For example the first time when the widget is started we'll go directly to the
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    71
            settings view to let the user configure the widget before the first use. We'll
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    72
            also show helpful information such as loading progress and any error messages in
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    73
            notification popup windows. And of course all configuration settings will be
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    74
            persistent so that the user doesn't have to re-configure the widget every time
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    75
            its started.
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    76
        </p>
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    77
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    78
        <p>
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    79
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    80
            In order to make the widget similar to other S60 applications, we will tweak
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    81
            the softkeys and Options menu so that the settings view can be reached from the
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    82
            menu and so that the right softkey will let the user go back from the settings
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    83
            view to the main view. In the main view the right softkey will be used to exit
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    84
            the widget. We will also allow the user to manually force a refresh of the news
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    85
            items by adding a "Refresh" option to the options menu.
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    86
        </p>
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    87
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    88
        <p>
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    89
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    90
            And last but not least, we'll implement the widget so that it will work in a
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    91
            standards-compliant PC web browser such as Firefox. This will allow you to test
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    92
            and debug the widget quickly as you develop it on your PC.
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    93
        </p>
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    94
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    95
    </div>
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    96
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    97
<div>
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    98
<ul class="ullinks">
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    99
<li class="ulchildlink"><strong><a href="WRTKit_RSS_Reader_first_steps-GUID-db42b227-1647-4020-bdb9-dacb26771779.html">First steps</a></strong><br />
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
   100
</li>
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
   101
<li class="ulchildlink"><strong><a href="WRTKit_RSS_Reader_user_interface-GUID-1083a0c4-a953-4b6e-a4d0-45a031e51c35.html">RSS Reader user interface</a></strong><br />
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
   102
</li>
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
   103
<li class="ulchildlink"><strong><a href="WRTKit_Feed_updates-GUID-25cd0e54-0516-4469-965e-c5781cf44dc9.html">Feed updates</a></strong><br />
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
   104
</li>
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
   105
</ul>
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
   106
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
   107
<div class="familylinks">
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
   108
<div class="parentlink"><strong>Parent topic:</strong> <a href="WRTKit_Tutorials-GUID-506c11e3-e6f3-43ec-9495-fcfa638b7e08.html">WRTKit Tutorials</a></div>
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
   109
</div>
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
   110
</div>
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
   111
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
   112
</body>
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
   113
</html>