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