release_notes.txt

一个简单的资源管理器

S60 Platform: FileList Example v.2.2
------------------------------------

This C++ code example demonstrates how to list files in a specific directory. 
It helps developers in creating user-friendly applications that allow users 
to choose files from a list of specific file types. Middle softkey labelling is 
supported (introduced in S60 3rd Edition, Feature Pack 2). The updated version 
has been tested to support S60 5th Edition and touch UI.

--------------------------------------------------------------------------------
 
PREREQUISITES

Symbian C++ basics.

--------------------------------------------------------------------------------

IMPORTANT FILES/CLASSES

src/FileListEngine.cpp

    GetResourceFilesL(TFileName &aBasePath)
       Fetches the selected file types (including files in subfolders).
   
    StartFileList()
       Gets the specific directory. The paths are obtained by using PathInfo
       (PlatformEnv.lib).

    LaunchCurrentL(TInt aPosition)
       Launches the selected files using CDocumentHandler (note that all
       extensions that work on the device do not work on the emulator).
  
src/FileListContainer.cpp

    SetFileListL()
       Handles the dynamical changing of the middle softkey label.

Important classes:
PathInfo, CDocumentHandler.

--------------------------------------------------------------------------------

REQUIRED CAPABILITIES

None.

--------------------------------------------------------------------------------

KNOWN ISSUES

To show the Scalable Vector Graphics Tiny (SVGT) application icons on S60 3rd 
Edition devices, the application has to be compiled using S60 3rd Edition, MR 
SDK. A separate SIS file is provided for this purpose.

--------------------------------------------------------------------------------

RUNNING THE EXAMPLE

When the application has started, choose the Options menu and select Sounds,
Pictures, or Video. The FileList application displays a numbered list of files.
The file name is on the first line of the list box item, and the second line
shows either the modification date or the file size, depending on the user's
selection. The user can select whether date or file size is displayed from the
first menu item. 

From S60 3rd Edition, Feature Pack 2 onwards, the context-sensitive label for 
the middle softkey is displayed on certain screens (Open for pictures, Play 
for sound and video clips).

For information on how to provide middle softkey labels in an application, 
see the included Middle_Softkey_Notes.txt file.

--------------------------------------------------------------------------------
     
BUILD & INSTALLATION INSTRUCTIONS

The package provides two self-signed installation packages, both of which 
support touch UI.

FileList_S60_3_0_v_2_2_0_selfs.sis:
-From S60 3rd Edition onwards.
-Supports SVG icons in all S60 3rd Edition and newer releases.
-No middle sofkey labelling.

FileList_S60_3_1_v_2_2_0_selfs.sis:
-From S60 3rd Edition, FP1 onwards.
-Enables middle softkey labelling (from S60 3rd Edition, FP2 onwards on 
 selected screen layouts).


The steps for building and installing the application on a device depend on the 
S60 platform version:

Mobile device (S60 3rd Edition)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
1. Make sure the paths in .pkg files match those in your development 
   environment.

2. Compile the example:

    cd group
    bldmake bldfiles
    abld reallyclean gcce
    abld build gcce urel
    
3. Make the sis:

    cd sis
    createsis create FileList_S60.pkg
    
4. Install the signed .sis file on an S60 3rd Edition device.
   - If you get a Certificate error during the installation of a self-signed 
     package, check that App.Manager > Settings > Software Installation is 
     set to All.
    

Emulator (WINSCW)
~~~~~~~~~~~~~~~~~
1. Compile the example:

    cd group
    bldmake bldfiles
    abld reallyclean winscw
    abld build winscw udeb

2. Start the emulator.

--------------------------------------------------------------------------------

COMPATIBILITY

S60 5th Edition
S60 3rd Edition, Feature Pack 2
S60 3rd Edition, Feature Pack 1
S60 3rd Edition

Tested with Nokia 5800 XpressMusic, Nokia E90 Communicator, Nokia N95, 
Nokia N96.

Developed and tested with: 
S60 3rd Edition SDK for Symbian OS, for C++, Maintenance Release

--------------------------------------------------------------------------------

VERSION HISTORY   

2.2 Old S60 2nd Edition SDK support removed and touch UI support checked. 
    SVG icon added.
2.1 Middle softkey functionality added and old macro definitions updated. 
    Backup & restore support added for 3rd Edition.
    Support for 1st Edition dropped.
2.0 Ported from S60 2nd to 3rd Edition.
    Download from:
    http://www.forum.nokia.com/info/sw.nokia.com/id/92747d5f-c17d-4660-b571-afd69cbe13c8/S60_Platform_FileList_Example_v2_0_en.zip.html
1.0 First release.
    Download from:
    http://www.forum.nokia.com/info/sw.nokia.com/id/c04558a9-47cb-41f8-95f7-c0039caf7aec/FileList_v1_0.zip.html