releasenotes.txt

symbian平台上多任务处理机制：多线程和Active

About S60 Platform: Thread And Active Objects Example
-----------------------------------------------------------------------------
The example demonstrates how to create an active scheduler and how to use active 
objects inside a new thread. Inside the mainthread (main program) the framework
creates the active scheduler automatically, but inside a new thread the active
scheduler must be created by the programmer. One active object is a Bluetooth device 
discoverer that searches Bluetooth devices in the vicinity and displays them in 
the listbox. 

The program
-----------
Searches Bluetooth devices and automatically refreshes the "found devices" list.
Refreshing is done every 20 seconds by default.

Prerequisites
------------
- Active objects
- Multitasking
- Symbian OS key concepts

Running the example
------------------------
1. Select "Start discovering devices" from the options menu.
   After that every found new Bluetooth device is displayed in the listbox.
   All Bluetooth devices are searched again after the refresh time has passed, cache
   is not used. Refresh loop (active object) runs continuously.

2. (optional)
   Set a new refresh time by selecting "Set refresh time" from the options menu.
   (Note! The refresh time cannot be less than 5 seconds due to slow Bluetooth
   device discovery). The refresh time is 20 seconds if not set.

3. Select a Bluetooth device using arrow UP or arrow DOWN. Press the select key. An information
   note displays the Bluetooth address of the selected device as hexadecimal.

4. In order to stop searching, press Exit.


Installation instructions
-----------------------
-----------------------

MOBILE DEVICE
------------------

S60 1st/2nd Edition:
  go to /ThreadAndActiveObjectsEx/group
  bldmake bldfiles
  abld build armi urel
  go to /ThreadAndActiveObjectsEx/sis
  makesis [Series60_v12_threadao.pkg | Series60_v21_threadao.pkg]
  install .sis to your device

S60 3rd Edition:
  go to /ThreadAndActiveObjectsEx/group
  bldmake bldfiles
  abld build [armv5 | gcce] urel
  go to /ThreadAndActiveObjectsEx/sis
  makesis [threadao_armv5.pkg | threadao_gcce.pkg]
    
    Sign the SIS package with the signsis utility
     - See the SDK Help for information about self-signed .sis packages, or
     www.symbiansigned.com for information about Developer Certificates.

   install the signed .sis file to your device

EMULATOR
------------------
  go to /ThreadAndActiveObjectsEx/group
  bldmake bldfiles
  abld build wins udeb (Visual Studio)
  or
  abld build winscw udeb (CodeWarrior)
  start the emulator



Known Issues
----------------------
No known issues.


Notes on porting to S60 3rd Edition
-----------------------------------
A new .mmp file (ThreadAO_s60_3rd_ed.mmp)  + ThreadAO_reg.rss + .pkg files for 
3rd Edition (both for armv5 and gcce) created. [The .mmp and .pkg files for 2nd Edition also renamed for clarity.]

icons_aif.mk and threadAO_loc.rss created.
EKA2 definition (for selecting the right .mmp) into the bld.inf file added.

Changes to the .mmp file:
	Target changed from .app to .exe.
	Resource definitions changed.
	VendorId 0x0 added.
	LocalServices capability added.

Changes to the source code:
	threadao.cpp: 
		E32Main function added (application started from eikstart.h) + conditional compiling
		macros to support both S60 3rd Edition and previous platforms.
	
	threadaoappui:
		ThreadAO_loc.rsg #included 
		BaseConstructL(EAknEnableSkin) added into the 2nd phase constructor to ensure skin support.

	threadaodocument:
		#include aknnotewrappers.h removed

	desctructors in various source files:
		Nulling/zeroing of deleted objects removed.

Compatibility
-------------
(S60 1st Edition)
S60 2nd Edition
S60 3rd Edition

Tested with Nokia 6600, Nokia 6630, and Nokia E60.

Version History
---------------
1.0	Original example
1.1	Support for S60 3rd Edition added

Additional Information
----------------------
For more information, see threadAndActiveObjectsEx\docs\S60_Platform_Thread_And_Active_Objects_Example_v1_1_en.pdf



Evaluate This Resource
----------------------
Please spare a moment to help us improve documentation quality and recognize the resources you find most valuable, by rating this resource.
http://www.forum.nokia.com/main/1%2C%2C90%2C00.html?surveyId=f43e5cb1-8825-444c-bdfb-068609e07076/S60_Platform_Thread_And_Active_Objects_Example_v1_1.zip