Editing Task:Download client for extras-applications/Development

Warning: You are not logged in. Your IP address will be recorded in this page's edit history.

The edit can be undone. Please check the comparison below to verify that this is what you want to do, and then save the changes below to finish undoing the edit.

Learn more about Contributing to the wiki.

This part documentation explains how the code is structured and which parts are used as the client-side implementation of the [[link | REST API]].

===STRUCTURE===

The [url git-repository] in [http://garage.maemo.org garage] contains the source code of the application. The source-folder contains to different directories:

* '''gui''': This directory contains the implementation of the user interface. ATM this part of the code is a bit messy because of a complete change of the UI. This is pretty much work in progress and needs a proper clean-up.

* '''maemo''': The back-end implementation of the REST API can be found here. The major API to request data from the server is located in MaemoApplicationHandler. This class takes care of the communication and parsing. Further several objects are defined here, like the MaemoApplication, it's subclass MaemoApplicationDetails and MaemoComment.

===API===

'''MaemoApplicationHandler'''

This file contains the API to request the data from the server.

* Request list of applications:

/* requests a list of all available applications
  * parameter:
  *  OS -> lists the applications for the specified operating system ('OS2007','OS2008','Maemo5')
  *  cat -> id of the category
  *  page -> number of the page
  *  pagesize -> applications/request
  *  keyword  -> search for applications regarding a specified keyword
  */
 void requestApplications (QString OS,
                           QString cat,
                           int page,
                           int pageSize,
                           QString keyword);

:The response is returned as a list of MaemoApplication objects, when the following signal is emitted:
 void ready (QList<MaemoApplication *>*);

* Request application details

/* parameter:
  *  uid -> identifier of an application
  */
 void requestApplicationData (QString uid);
            
:Signal, emitted when the data is received:
 void detailsReady(MaemoApplicationDetails*);

* Request images:

//requests an image by a url
 void requestImage (QString url);
 //signal
 void imageReady(QPixmap*);

=== NEXT STEPS ===
 * separate UI implementation and back-end implementation completely
 * more stability
 * define a "final" API

Please note that all contributions to maemo.org wiki may be edited, altered, or removed by other contributors. If you do not want your writing to be edited mercilessly, then do not submit it here.
You are also promising us that you wrote this yourself, or copied it from a public domain or similar free resource (see maemo.org wiki:Copyrights for details). Do not submit copyrighted work without permission!

Summary:

Cancel | Editing help (opens in new window)

Retrieved from "http://wiki.maemo.org/Task:Download_client_for_extras-applications/Development"

Personal tools

Navigation

Views

Editing Task:Download client for extras-applications/Development

@@ Line 1: / Line 1: @@
-This part documentation explains how the code is structured and which parts are used as the client-side implementation of the [[Task:Download_client_for_extras-applications/REST-API | REST API]].
+This part documentation explains how the code is structured and which parts are used as the client-side implementation of the [[link | REST API]].
@@ Line 60: / Line 60: @@
   void imageReady(QPixmap*);
-[[Category:Tasks]]
+=== NEXT STEPS ===
+ * separate UI implementation and back-end implementation completely
+ * more stability
+ * define a "final" API