calabash-android 0.2.11 → 0.2.12

data/CHANGES.txt

@@ -1,3 +1,9 @@
+0.2.12:
+      Various small improvements and bug fixes.
+
+      Fixed support for scenario outline.
+      Added support for interacting with Google Maps.
+
 0.2.11:
       Added is_enabled action that determines if a view is enabled.
 

data/features-skeleton/support/app_installation_hooks.rb

@@ -5,7 +5,12 @@ AfterConfiguration do |config|
 end
 
 Before do |scenario|
-  feature_name = scenario.feature.name
+  @scenario_is_outline = (scenario.class == Cucumber::Ast::OutlineTable::ExampleRow)
+  if @scenario_is_outline 
+    scenario = scenario.scenario_outline 
+  end 
+
+  feature_name = scenario.feature.title
   if FeatureNameMemory.feature_name != feature_name \
       or ENV["RESET_BETWEEN_SCENARIOS"] == "1"
     if ENV["RESET_BETWEEN_SCENARIOS"] == "1"
@@ -18,11 +23,14 @@ Before do |scenario|
     install_app(ENV["TEST_APP_PATH"])
     install_app(ENV["APP_PATH"])
     FeatureNameMemory.feature_name = feature_name
-	end
+	FeatureNameMemory.invocation = 1
+  else
+    FeatureNameMemory.invocation += 1
+  end
 end
 
 FeatureNameMemory = Class.new
 class << FeatureNameMemory
   @feature_name = nil
-  attr_accessor :feature_name
+  attr_accessor :feature_name, :invocation
 end

data/features-skeleton/support/app_life_cycle_hooks.rb

@@ -1,6 +1,15 @@
 require 'calabash-android/management/adb'
 
 Before do |scenario|
+  # John Gallagher provided the "scenario_is_outline" fix: https://groups.google.com/forum/?fromgroups#!topic/calabash-ios/ICA4f24eSsY
+  # ...there may be a better way of doing this...
+  @scenario_is_outline = (scenario.class == Cucumber::Ast::OutlineTable::ExampleRow) 
+  if @scenario_is_outline 
+    scenario = scenario.scenario_outline
+    # Still need to call connect_to_test_server...
+  elsif scenario.failed?
+    return #No need to start the server is anything before this has failed.
+  end
 
   return if scenario.failed? #No need to start the server is anything before this has failed.
   start_test_server_in_background

data/features-skeleton/support/hooks.rb

@@ -1,13 +1,29 @@
 
 Before do |scenario|
+  # https://groups.google.com/forum/?fromgroups#!topic/calabash-ios/ICA4f24eSsY
+  @scenario_is_outline = (scenario.class == Cucumber::Ast::OutlineTable::ExampleRow) 
+  if @scenario_is_outline 
+    scenario = scenario.scenario_outline 
+  end 
+
   StepCounter.step_index = 0
-  StepCounter.step_line = scenario.raw_steps[StepCounter.step_index].line
+  # https://github.com/calabash/calabash-android/issues/58#issuecomment-6745642
+  if scenario.respond_to? :raw_steps
+    StepCounter.step_line = scenario.raw_steps[StepCounter.step_index].line
+  else
+    StepCounter.step_line = 0
+  end
 end
 
 AfterStep do |scenario|
   #Handle multiline steps
   StepCounter.step_index = StepCounter.step_index + 1
-  StepCounter.step_line = scenario.raw_steps[StepCounter.step_index].line unless scenario.raw_steps[StepCounter.step_index].nil?
+  # https://github.com/calabash/calabash-android/issues/58#issuecomment-6745642
+  if scenario.respond_to? :raw_steps
+    StepCounter.step_line = scenario.raw_steps[StepCounter.step_index].line unless scenario.raw_steps[StepCounter.step_index].nil?
+  else
+    StepCounter.step_line = StepCounter.step_line + 1
+  end
 end
 
 StepCounter = Class.new

data/lib/calabash-android/operations.rb

@@ -200,7 +200,7 @@ module Operations
       filename_prefix = FeatureNameMemory.feature_name.gsub(/\s+/, '_').downcase
       begin
         Timeout.timeout(30) do
-          file_name = "#{path}/#{filename_prefix}_#{StepCounter.step_line}.png"
+          file_name = "#{path}/#{filename_prefix}_#{FeatureNameMemory.invocation}_#{StepCounter.step_line}.png"
           image = http("/screenshot")
           open(file_name ,"wb") { |file|
             file.write(image)

data/lib/calabash-android/steps/assert_steps.rb

@@ -29,4 +29,16 @@ Then /^I don't see "([^\"]*)"$/ do |text|
   performAction('assert_text', text, false) #second param indicated that the text should _not_ be found
 end
 
+# This step is more of an example or macro to be used within your own custom steps
+# Generally, assert_view_property takes 3 args, but for if 'property'='compoundDrawables', the next arg should be 'left'/'right'/'top'/'bottom', followed by the expected drawable ID.
+# @param view_id - the name of the view, eg: R.my_view_id
+# @param property - eg: 'visibility' (visible/invisible/gone), 'drawable' (expected drawable ID) 
+Then /^the view with id "([^\"]*)" should have property "([^\"]*)" = "([^\"]*)"$/ do | view_id, property, value |
+  # get_view_property is also available: performAction( 'get_view_property', 'my_view', 'visibility') 
+  performAction( 'assert_view_property', view_id, property, value )
+end
 
+Then /^the "([^\"]*)" activity should be open$/ do | expected_activity |
+  actual_activity = performAction('get_activity_name')['message']
+  raise "The current activity is #{actual_activity}" unless( actual_activity == expected_activity || actual_activity == expected_activity + 'Activity' )
+end

data/lib/calabash-android/steps/list_steps.rb

@@ -0,0 +1,40 @@
+# By default "get_list_item_text" returns an array of arrays of text for each entry in the first ListView
+# The "get_list_item_text" action also supports: 
+# (all items of 2nd list) <code>performAction( 'get_list_item_text', '2' )</code>
+# (1st item of 2nd list) <code>performAction( 'get_list_item_text', '2' , '1' )</code>
+Then /^I should see following list:$/ do | expected_table |
+  result = performAction('get_list_item_text')
+  response_table = result['bonusInformation']
+  response_table.each_with_index do | row_data, index |
+    row_data = JSON.parse( row_data )
+    response_table[index] = row_data
+  end
+  
+  expected_table.diff!(response_table)
+end
+
+# Note: This step is currently intended as more of an example rather than a rock-solid, well-tested step.
+#       (The server implementation works well for me, but my test steps that use it are application-specific)
+# Similarly to the "get_list_item_text" action, the "get_list_item_properties" action defaults to
+# all rows of the first ListView, but can be instructed to target a specific row (or all rows) of a specific ListView.
+# Example TextView row: {"id":"title", "text":"My Title", "color":0, "background":0, "compoundDrawables":["left"]}
+# Example ViewGroup row: {"children":[{"id":"title", "text":"My Title"}, {"id":"subtitle", "text":"Second line"}]}
+# Example TableLayout row: {"cells":[{"column":0, "id":"colA", "text": "This is a Test"}]}
+Then /^The "([^\"]*)" for row (\d+) should be "([^\"]*)"$/ do | view_id, row, value |
+  response = performAction( 'get_list_item_properties', '1' , row )['bonusInformation']
+  response = JSON.parse( response[0] ) 
+  
+  if( response['children'] )
+    found_id = false
+    response['children'] each do | view |
+	  if( view['id'] == view_id )
+	    raise "Text is #{view['text']}, expected #{value}" unless( view['text'] == value )
+		found_id = true
+	  end
+	end
+	raise "Could not find view with ID: #{view_id}" unless( found_id )
+  else
+    raise "ID is #{response['id']}, expected #{view_id}" unless( response['id'] == view_id )
+	raise "Text is #{response['text']}, expected #{view_id}" unless( response['text'] == value )
+  end
+end

data/lib/calabash-android/steps/map_steps.rb

@@ -0,0 +1,61 @@
+When /^I centre the map at (-?\d+\.\d+), (-?\d+\.\d+)$/ do | lat, lon |
+  performAction('set_map_center', lat, lon)
+end
+
+When /^I pan the map to (-?\d+\.\d+), (-?\d+\.\d+)$/ do | lat, lon |
+  performAction('pan_map_to', lat, lon)
+  performAction('wait', 1)
+end
+
+When /^(?:I )?set the map zoom level to (\d+)$/ do | zoom |
+  performAction('set_map_zoom', zoom)
+  sleep(0.2)
+end
+
+When /^(?:I )?zoom (in|out) on the map$/ do | zoom |
+  performAction('set_map_zoom', zoom)
+  sleep(0.2)
+end
+
+Then /^the map zoom level should be (\d+)$/ do | zoom |
+  result = performAction('get_map_zoom')
+  raise StandardError.new( "The map's zoom level should be #{zoom} but is #{result['message']}"  ) unless zoom.eql?( result['message'] )
+end
+
+When /^I tap the map marker "([^\"]*)"$/ do | marker_title |
+  performAction('tap_map_marker_by_title', marker_title, 60000)
+end
+
+When /^I double tap the map marker "([^\"]*)"$/ do | marker_title |
+  performAction('tap_map_marker_by_title', marker_title, 60000)
+  sleep(0.4)
+  performAction('tap_map_marker_by_title', marker_title, 100)
+end
+
+When /^I tap away from the markers$/ do
+  performAction('tap_map_away_from_markers')
+end
+
+Then /^I should see the following markers:$/ do | marker_table |
+  verify_map_markers( marker_table )
+end
+
+Then /^the map should be centred at (-?\d+\.\d+), (-?\d+\.\d+)$/ do | lat, lon |
+  result = performAction('get_map_center')
+  bonus_info = result['bonusInformation']
+  actual_lat = bonus_info[0].to_f
+  actual_lon = bonus_info[1].to_f
+  lat = lat.to_f
+  lon = lon.to_f
+  tol = 0.00001
+  if( (lat - actual_lat).abs > tol || (lon - actual_lon).abs > tol ) 
+    raise StandardError.new( "The map should have been centred on: #{lat},#{lon} but was actually centred on #{bonus_info.inspect}" )
+  end
+end
+
+Then /^the map marker "([^\"]*)" should be highlighted$/ do | marker_title |
+  result = performAction('get_map_marker', marker_title)
+  result = result['message']
+  result = JSON.parse( result )
+  raise StandardError.new( "The marker '#{marker_title}' was found, but is not highlighted" ) unless result['focused']
+end

data/lib/calabash-android/steps/navigation_steps.rb

@@ -23,10 +23,19 @@ Then /^I select "([^\"]*)" from the menu$/ do |item|
   performAction('select_from_menu', item)
 end
 
+Then /^I select tab number (\d+)$/ do | tab |
+  performAction('select_tab', tab)
+end
+
+# @param - the "tag" associated with the tab, or the text within the tab label
+Then /^I select the "([^\"]*)" tab$/ do | tab |
+  performAction('select_tab', tab)
+end
+
 Then /^I scroll down$/ do
   performAction('scroll_down')
 end
 
 Then /^I scroll up$/ do
   performAction('scroll_up')
-end
+end

data/lib/calabash-android/steps/progress_steps.rb

@@ -64,3 +64,8 @@ end
 Then /^I wait up to (\d+) seconds for the "([^\"]*)" screen to appear$/ do |timeout, text|
     performAction('wait_for_screen', text, timeout)
 end
+
+# @param - the "tag" associated with the tab, or the text within the tab label
+Then /^I wait for the "([^\"]*)" tab to appear$/ do | tab |
+  performAction('wait_for_tab', tab)
+end

data/lib/calabash-android/version.rb

@@ -1,6 +1,6 @@
 module Calabash
   module Android
-    VERSION = "0.2.11"
-    FRAMEWORK_VERSION = "0.2.11"
+    VERSION = "0.2.12"
+    FRAMEWORK_VERSION = "0.2.12"
   end
 end

data/test-server/AndroidManifest.xml

@@ -1,13 +1,13 @@
 <?xml version="1.0" encoding="utf-8"?>
 <manifest xmlns:android="http://schemas.android.com/apk/res/android"
       package="#TESTED_APP_PACKAGE#.test"
-      android:versionCode="1"
-      android:versionName="1.0">
+      android:versionCode="3"
+      android:versionName="0.3.0">
     <application android:label="instrumentation_backend">
-
-    <uses-library android:name="android.test.runner" />
+      <uses-library android:name="android.test.runner" />
+      <uses-library android:name="com.google.android.maps" android:required="false" />
     </application>
     <uses-sdk android:minSdkVersion="4" />
     <instrumentation android:targetPackage="#TESTED_APP_PACKAGE#" android:name="sh.calaba.instrumentationbackend.CalabashInstrumentationTestRunner" />
     <uses-permission android:name="android.permission.INTERNET" />
-</manifest> 
+</manifest> 

data/test-server/build.xml

@@ -89,6 +89,10 @@
     <target name="-prepare.testserver" description="Makes sure the testserver matches the tested application by looking at its manifest file">
       <copy todir="${staging.dir}">
 				<fileset dir="instrumentation-backend"/>
+      </copy>
+	  <copy todir="${staging.dir}/libs">
+        <!-- There may be a better way of doing this, but it works -->
+        <fileset dir="${env.ANDROID_HOME}/add-ons/addon-google_apis-google-${android.api.level}/libs"/>
       </copy>
       <copy todir="${staging.dir}/assets">
         <fileset dir="${calabashjs.dir}"/>

data/test-server/instrumentation-backend/.gitignore

@@ -0,0 +1 @@
+/bin

data/test-server/instrumentation-backend/AndroidManifest.xml

@@ -1,13 +1,14 @@
 <?xml version="1.0" encoding="utf-8"?>
 <manifest xmlns:android="http://schemas.android.com/apk/res/android"
     package="sh.calaba.test"
-    android:versionCode="1"
-    android:versionName="1.0" >
+    android:versionCode="3"
+    android:versionName="0.3.0" >
 
     <uses-sdk android:minSdkVersion="6" />
 
     <application android:label="CalabashTestServer" >
         <uses-library android:name="android.test.runner" />
+        <uses-library android:name="com.google.android.maps" android:required="false" />
     </application>
 
     <instrumentation
@@ -18,4 +19,4 @@
     <uses-permission android:name="android.permission.ACCESS_MOCK_LOCATION" />
     <uses-permission android:name="android.permission.INTERNET" />
 
-</manifest>
+</manifest>

data/test-server/instrumentation-backend/project.properties

@@ -8,4 +8,4 @@
 # project structure.
 
 # Project target.
-target=android-15
+target=Google Inc.:Google APIs:15

data/test-server/instrumentation-backend/src/com/jayway/android/robotium/solo/MapViewUtils.java

@@ -0,0 +1,328 @@
+package com.jayway.android.robotium.solo;
+
+import java.util.ArrayList;
+import java.util.List;
+
+import android.app.Instrumentation;
+import android.graphics.PixelFormat;
+import android.graphics.Point;
+import android.graphics.Rect;
+import android.graphics.Region;
+import android.os.SystemClock;
+import android.util.Log;
+
+import com.google.android.maps.GeoPoint;
+import com.google.android.maps.ItemizedOverlay;
+import com.google.android.maps.MapView;
+import com.google.android.maps.Overlay;
+import com.google.android.maps.OverlayItem;
+import com.google.android.maps.Projection;
+
+/**
+ * @author Nicholas Albion
+ */
+public class MapViewUtils {
+	private final Instrumentation inst;
+	private final ViewFetcher viewFetcher;
+	private final Sleeper sleeper;
+	private final Waiter waiter;
+	
+	/**
+	 * Constructs this object.
+	 *
+	 * @param inst the {@code Instrumentation} instance.
+	 * @param viewFetcher the {@code ViewFetcher} instance.
+	 * @param sleeper the {@code Sleeper} instance
+	 */
+	public MapViewUtils( Instrumentation inst, ViewFetcher viewFetcher, Sleeper sleeper, Waiter waiter ) {
+		this.inst = inst;
+		this.viewFetcher = viewFetcher;
+		this.sleeper = sleeper;
+		this.waiter = waiter;
+	}
+	
+	private MapView getMapView() {
+		return waiter.waitForAndGetView( 0, MapView.class );
+//		final ArrayList<View> viewList = RobotiumUtils.removeInvisibleViews(viewFetcher.getAllViews(true));
+//		ArrayList<MapView> maps = RobotiumUtils.filterViews( MapView.class, viewList );
+//		if( maps.size() == 0 ) {
+//			return null;
+//		}
+//		return maps.get(0);
+	}
+	
+	/**
+	 * @param lat
+	 * @param lon
+	 */
+	public void setCenter( double lat, double lon ) {
+		MapView mapView = getMapView();
+		mapView.getController().setCenter( new GeoPoint((int)(lat * 1E6), (int)(lon * 1E6)) );
+	}
+	
+	public double[] getMapCenter() {
+		MapView mapView = getMapView();
+		GeoPoint center = mapView.getMapCenter();
+		return new double[] { center.getLatitudeE6() / 1E6, center.getLongitudeE6() / 1E6 };
+	}
+	
+	/**
+	 * @param lat
+	 * @param lon
+	 */
+	public void panTo( double lat, double lon ) {
+		MapView mapView = getMapView();
+		mapView.getController().animateTo( new GeoPoint((int)(lat * 1E6), (int)(lon * 1E6)) );
+	}
+	
+	public int getZoom() {
+		MapView mapView = getMapView();
+		return mapView.getZoomLevel();
+	}
+	
+	public int setZoom( int zoomLevel ) {
+		MapView mapView = getMapView();
+		mapView.getController().stopAnimation(true);
+		return mapView.getController().setZoom( zoomLevel );
+	}
+		
+	public boolean zoomIn() {
+		MapView mapView = getMapView();
+		return mapView.getController().zoomIn();
+	}
+	
+	public boolean zoomOut() {
+		MapView mapView = getMapView();
+		return mapView.getController().zoomOut();
+	}
+	
+	/**
+	 * @return [top, right, bottom, left] in decimal degrees
+	 */
+	public List<String> getBounds() {
+		MapView mapView = getMapView();
+		GeoPoint center = mapView.getMapCenter();
+		int latCtr = center.getLatitudeE6();
+		int lonCtr = center.getLongitudeE6();
+		int latSpan = mapView.getLatitudeSpan() >> 1;
+		int lonSpan = mapView.getLongitudeSpan() >> 1;
+		
+		Log.i("MapView", "latSpan: " + latSpan);
+		
+		ArrayList<String> bounds = new ArrayList<String>(4);
+		bounds.add( Double.toString( (latCtr + latSpan) / 1E6 ) );
+		bounds.add( Double.toString( (lonCtr + lonSpan) / 1E6 ) );
+		bounds.add( Double.toString( (latCtr - latSpan) / 1E6 ) );
+		bounds.add( Double.toString( (lonCtr - lonSpan) / 1E6 ) );
+		return bounds;
+	}
+	
+	/**
+	 * @return A list of JSON strings representing the markers.
+	 * @see #getMarkerItem(String)
+	 * @see MapViewUtils#toString(OverlayItem, boolean)
+	 */
+	public List<String> getMarkerItems() {
+		ArrayList<String> markers = new ArrayList<String>();
+		
+		MapView mapView = getMapView();
+		for( Overlay overlay : mapView.getOverlays() ) {
+			if( overlay instanceof ItemizedOverlay ) {
+				@SuppressWarnings("rawtypes")
+				ItemizedOverlay markerOverlay = ((ItemizedOverlay)overlay);
+				int noOfMarkers = markerOverlay.size();
+				int lastFocused = markerOverlay.getLastFocusedIndex();
+				
+				Log.i("MapView", "Overlay " + markerOverlay + " has " + noOfMarkers + " markers");
+				markers.ensureCapacity( markers.size() + noOfMarkers );
+				for( int i = 0; i < noOfMarkers; i++ ) {
+					OverlayItem item = markerOverlay.getItem(i);
+					String str = toString( item, lastFocused == i );
+					markers.add( str );
+				}
+			}
+		}
+		
+		Log.i("MapView", "Sending response with " + markers.size() + " markers");
+		return markers;
+	}
+	
+	/**
+	 * @param title
+	 * @return null or (for example) {"latitude":-33.123456, "longitude":151.123456, "title":"My Marker", "snippet":"More Info about my marker"}
+	 */
+	public String getMarkerItem( String title ) {
+		ArrayList<String> markers = new ArrayList<String>();
+		
+		MapView mapView = getMapView();
+		for( Overlay overlay : mapView.getOverlays() ) {
+			if( overlay instanceof ItemizedOverlay ) {
+				@SuppressWarnings("rawtypes")
+				ItemizedOverlay markerOverlay = ((ItemizedOverlay)overlay);
+				int noOfMarkers = markerOverlay.size();
+				int lastFocused = markerOverlay.getLastFocusedIndex();
+				
+				Log.i("MapView", "Overlay " + markerOverlay + " has " + noOfMarkers + " markers");
+				markers.ensureCapacity( markers.size() + noOfMarkers );
+				for( int i = 0; i < noOfMarkers; i++ ) {
+					OverlayItem item = markerOverlay.getItem(i);
+					
+					if( title.equals(item.getTitle()) ) {
+						return toString( item, lastFocused == i );
+					}
+				}
+			}
+		}
+		return null;
+	}
+	
+	/**
+	 * @param title
+	 * @param timeout in ms
+	 * @return true if the marker was found and tapped upon
+	 */
+	public boolean tapMarkerItem( String title, long timeout ) {		
+		final long endTime = SystemClock.uptimeMillis() + timeout;
+		Log.i("TapMarker", "Looking for marker '" + title + "'");
+		
+		while( SystemClock.uptimeMillis() < endTime ) {
+			MapView mapView = getMapView();
+			for( Overlay overlay : mapView.getOverlays() ) {
+				if( overlay instanceof ItemizedOverlay ) {
+					@SuppressWarnings("rawtypes")
+					ItemizedOverlay markerOverlay = ((ItemizedOverlay)overlay);
+					int noOfMarkers = markerOverlay.size();
+					for( int i = 0; i < noOfMarkers; i++ ) {
+						OverlayItem item = markerOverlay.getItem(i);
+						String itemTitle = item.getTitle();
+//						Log.i("TapMarker", "  item title: " + itemTitle);
+						if( title.equals( itemTitle ) ) {
+							markerOverlay.onTap( item.getPoint(), mapView );
+							return true;
+						}
+					}
+				}
+			}
+			
+			Log.i("TapMarker", "Could not find marker '" + title + "', try again in a moment");
+			sleeper.sleep();
+		}
+		
+		Log.i("TapMarker", "Nope, could not find marker '" + title + "'");
+		return false;
+	}
+	
+	/**
+	 * @param step - number of pixels to step when searching for an empty piece of screen
+	 * @return true if it was possible to tap on the screen without tapping on a marker
+	 */
+	 @SuppressWarnings("rawtypes")
+	public boolean tapAwayFromMarkerItems( int step ) {		
+		MapView mapView = getMapView();
+		Projection proj = mapView.getProjection();
+		ItemizedOverlay overlayToTap = null;
+		Point markerPoint = new Point();
+		int w = mapView.getWidth();
+		int h = mapView.getHeight();
+		
+		for( int x = 0; x < w; x += step ) {
+NEXT_Y:			
+			for( int y = 0; y < h; y += step ) {
+				boolean tappedMarkerAtPoint = false;
+				for( Overlay overlay : mapView.getOverlays() ) {
+					if( overlay instanceof ItemizedOverlay ) {						
+						ItemizedOverlay markerOverlay = ((ItemizedOverlay)overlay);		
+//						if( markerOverlay.onTap( geoPoint, mapView ) ) {
+//							tappedMarkerAtPoint = true;
+//							break;
+//						}
+						int noOfMarkers = markerOverlay.size();
+						for( int i = 0; i < noOfMarkers; i++ ) {
+							OverlayItem item = markerOverlay.getItem(i);
+							proj.toPixels( item.getPoint(), markerPoint );
+							Rect markerBounds = item.getMarker(0).getBounds();
+							markerBounds.offset( markerPoint.x, markerPoint.y );
+							
+							Log.d("TapAwayFromMarkers", "markerBounds: " + markerBounds);
+							if( markerBounds.contains(x, y) ) {
+								Log.d("TapAwayFromMarkers", "Tapping at " + x + ", " + y + " would tap on " + item.getTitle());
+								continue NEXT_Y;
+							}
+						}
+						overlayToTap = markerOverlay;
+					}
+				}
+				
+				if( tappedMarkerAtPoint == false && overlayToTap != null ) {
+					Log.i("TapAwayFromMarkers", "Tapping away from markers at " + x + ", " + y);
+					GeoPoint geoPoint = proj.fromPixels(x, y);
+					overlayToTap.onTap(geoPoint, mapView);
+					return true;
+				}
+			}
+		}
+		
+		Log.i("TapMarker", "Nope, could not avoid tapping on any markers");
+		return false;
+	}
+	 
+	/**
+	 * @param item
+	 * @param isLastFocused
+	 * @return eg: {"latitude":-33.123456, "longitude":151.123456, "title":"My Marker", "snippet":"More Info about my marker"}
+	 */
+	private String toString( OverlayItem item, boolean isLastFocused ) {
+		GeoPoint point = item.getPoint();
+		StringBuilder str = new StringBuilder("{\"latitude\":\"").append(Double.toString( point.getLatitudeE6() / 1E6 ))
+				 						.append("\", \"longitude\":\"").append( Double.toString( point.getLongitudeE6() / 1E6 ))
+				 						.append("\", \"title\":\"").append( item.getTitle().replaceAll("\"", "\\\"") );
+		String snippet = item.getSnippet();
+		if( snippet != null && snippet.length() != 0 ) { 
+			str.append("\", \"snippet\":\"").append( snippet.replaceAll("\"", "\\\"") );
+		}
+		if( isLastFocused ) {
+			str.append("\", \"focused\":true");
+		} else {
+			str.append("\"");
+		}
+		
+		appendTransparency( str, item );
+		
+		str.append("}");
+		return str.toString();
+	}
+	
+	private void appendTransparency( StringBuilder str, OverlayItem item ) {
+		StringBuilder transparencyStr = new StringBuilder();  
+		appendTransparency( transparencyStr, item, "default", 0 );
+		appendTransparency( transparencyStr, item, "focused", OverlayItem.ITEM_STATE_FOCUSED_MASK );
+		appendTransparency( transparencyStr, item, "pressed", OverlayItem.ITEM_STATE_PRESSED_MASK );
+		appendTransparency( transparencyStr, item, "selected", OverlayItem.ITEM_STATE_SELECTED_MASK );
+		
+		if( transparencyStr.length() != 0 ) {
+			transparencyStr.deleteCharAt( transparencyStr.length() - 1 );
+			str.append(", \"transparency\":{").append(transparencyStr).append("}");
+		}
+	}
+	
+	private void appendTransparency( StringBuilder str, OverlayItem item, String stateName, int state ) {
+		switch( item.getMarker( OverlayItem.ITEM_STATE_FOCUSED_MASK ).getOpacity() ) {
+		case PixelFormat.UNKNOWN: break;
+		case PixelFormat.TRANSPARENT: 
+			str.append("\"").append(stateName).append("\":\"transparent\",");
+			return;
+		case PixelFormat.TRANSLUCENT: 
+			str.append("\"").append(stateName).append("\":\"translucent\",");
+			return;
+		case PixelFormat.OPAQUE: 
+			str.append("\"").append(stateName).append("\":\"opaque\",");
+			return;
+		}
+		
+		
+		Region region = item.getMarker(state).getTransparentRegion();
+		if( region != null ) {
+			str.append("\"").append(stateName).append("\":true,");
+		}
+	}
+}