readme.txt

nokia symbian File_Fetching

========
OVERVIEW
========

FileFetcher example application is a simple browser application for media files.
It demonstrates how to use CAknFileSelectionDialog and MGFetch dialogs, and also 
how to open files into their default handler application by using RApaLsSession.


=============
COMPATIBILITY
=============

Series 60, version 2.0
Tested on Nokia 6600


===========
COMPILATION
===========

For wins build (from .\group):
>> bldmake bldfiles
>> abld build wins udeb

.\sis contains package file (FileFetcher.pkg) for the project. It is assumed
that the SDK is installed in the default location ("C:\Symbian\7.0s"). 
If not, you must change the paths for FileFetcher.app and FileFetcher.rsc in
the FileFetcher.pkg file. 

Also ready made installation file is provided, FileFetcher.sis, compiled and 
created with Series 60 v2.0 SDK.


=======
DETAILS
=======

There are three central methods in the application which contains the usage of
the APIs:

* CFileFetcherAppUi::BrowseUsingAknSelectionDlg opens a new 
  CAknFileSelectionDialog.

* CFileFetcherAppUi::BrowseUsingMGFetchL opens a new MGFetch dialog.
  
* CFileFetcherAppUi::ViewFileL opens given file into default application
  registered to handle the given file's type.


=====
NOTES
=====

* Emulator does not have the same directory structure as real device.
  Emulator contains only one media file path, images, in:
  C:\Symbian\7.0s\Series60_v20\Epoc32\wins\c\nokia\Images
  One could copy standard Windows bitmaps into this folder to test the
  application in emulator.