::::::::::::::::::::::::::::::::::::::::::
::                                      ::
:: SmartFoxServer Client Java API       ::
:: (c) 2008-2009 gotoAndPlay            ::
:: www.smartfoxserver.com               ::
:: www.gotoandplay.it                   ::
::                                      ::
::::::::::::::::::::::::::::::::::::::::::

August 3rd, 2009

-------------------------------------------------------
>> Testing the Android Examples. Prerequisites:
-------------------------------------------------------
You will need the following software:

Android SDK: http://developer.android.com/sdk/
Eclipse IDE (we recommend version 3.4 or higher): http://www.eclipse.org/downloads/
The Android Eclipse plugin: http://developer.android.com/sdk/1.5_r3/index.html

We recommend that you read the instructions related on how to setup the SDK and Eclipse at this page:
http://developer.android.com/sdk/1.5_r3/installing.html


-------------------------------------------------------
>> Setting UP the Android examples
-------------------------------------------------------
In order to import the example project in your Eclipse IDE do as follows:

From the Eclipse menu choose: File > Import
From "General" choose "Existing Projects into Workspace"
Browse your file system and locate the folder of the example project that you want to import

Once the import is done you will still need add the necessary library dependencies.
Right click on the imported project and select "Properties"
Click on "Java Build Path" and then click "Add external jars"
Locate the Java API folder, open the "bin" directory, select all jar files and confirm.
The project should be compiled successfully.


-------------------------------------------------------
>> Running the Android examples
-------------------------------------------------------
When you run a project for the first time you need to create a Run or Debug profile.
Right click on the imported project. choose "Debug As" and click on "Android Application"
If you are asked to create a Virtual Device create one with any name and use "Android 1.1" as the Target


-------------------------------------------------------
>> Known bugs or problems
-------------------------------------------------------
The following warning message is shown during compilation: 
"warning: Ignoring InnerClasses attribute for an anonymous inner class that doesn't come with an associated EnclosingMethod attribute. (This class was probably produced by a broken compiler.)" 
This is just because the log4j dependency is compiled with an older compiler. The warning doesn't affect the proper functioning of the API

When you open the main.xml of the Simple Chat example in the Android Layout editor it will dsiplay "NullPointerException: null" instead of the preview. This is a known issue with the Android tabs UI components.
