add screenshots for android tutorial

Author: swapfoundation

doc/images/android-config-build-path-add-external-jars.png

@@ -0,0 +1,12 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<classpath>
+	<classpathentry kind="src" path="src"/>
+	<classpathentry kind="src" path="gen"/>
+	<classpathentry kind="con" path="com.android.ide.eclipse.adt.ANDROID_FRAMEWORK"/>
+	<classpathentry kind="con" path="com.android.ide.eclipse.adt.LIBRARIES"/>
+	<classpathentry kind="lib" path="/media/work/workspace/iqa/java/out/iQA.Runtime.Instrument.jar"/>
+	<classpathentry kind="lib" path="/media/work/workspace/iqa/java/out/iQA.Runtime.jar"/>
+	<classpathentry kind="lib" path="/media/work/workspace/iqa/java/lib/antlr-runtime-3.4.jar"/>
+	<classpathentry kind="lib" path="/media/work/workspace/iqa/java/lib/robotium-solo-3.1.jar"/>
+	<classpathentry kind="output" path="bin/classes"/>
+</classpath>

doc/images/android-config-build-path-jars.png

@@ -0,0 +1,33 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<projectDescription>
+	<name>tutorial</name>
+	<comment></comment>
+	<projects>
+	</projects>
+	<buildSpec>
+		<buildCommand>
+			<name>com.android.ide.eclipse.adt.ResourceManagerBuilder</name>
+			<arguments>
+			</arguments>
+		</buildCommand>
+		<buildCommand>
+			<name>com.android.ide.eclipse.adt.PreCompilerBuilder</name>
+			<arguments>
+			</arguments>
+		</buildCommand>
+		<buildCommand>
+			<name>org.eclipse.jdt.core.javabuilder</name>
+			<arguments>
+			</arguments>
+		</buildCommand>
+		<buildCommand>
+			<name>com.android.ide.eclipse.adt.ApkBuilder</name>
+			<arguments>
+			</arguments>
+		</buildCommand>
+	</buildSpec>
+	<natures>
+		<nature>com.android.ide.eclipse.adt.AndroidNature</nature>
+		<nature>org.eclipse.jdt.core.javanature</nature>
+	</natures>
+</projectDescription>

doc/images/android-config-build-path-menu.png

@@ -0,0 +1,19 @@
+<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+    package="cc.iqa.studio.demo.test"
+    android:versionCode="1"
+    android:versionName="1.0" >
+
+    <uses-sdk android:minSdkVersion="8" />
+
+    <instrumentation
+        android:name="android.test.InstrumentationTestRunner"
+        android:targetPackage="cc.iqa.studio.demo" />
+
+    <application
+        android:icon="@drawable/ic_launcher"
+        android:label="@string/app_name" >
+        <uses-library android:name="android.test.runner" />
+    </application>
+
+</manifest>

doc/images/android-create-new-test.png

@@ -0,0 +1,23 @@
+/* AUTO-GENERATED FILE.  DO NOT MODIFY.
+ *
+ * This class was automatically generated by the
+ * aapt tool from the resource data it found.  It
+ * should not be modified by hand.
+ */
+
+package cc.iqa.studio.demo.test;
+
+public final class R {
+    public static final class attr {
+    }
+    public static final class drawable {
+        public static final int ic_launcher=0x7f020000;
+    }
+    public static final class layout {
+        public static final int main=0x7f030000;
+    }
+    public static final class string {
+        public static final int app_name=0x7f040001;
+        public static final int hello=0x7f040000;
+    }
+}

doc/images/android-new-project-info.png

@@ -0,0 +1,40 @@
+-optimizationpasses 5
+-dontusemixedcaseclassnames
+-dontskipnonpubliclibraryclasses
+-dontpreverify
+-verbose
+-optimizations !code/simplification/arithmetic,!field/*,!class/merging/*
+
+-keep public class * extends android.app.Activity
+-keep public class * extends android.app.Application
+-keep public class * extends android.app.Service
+-keep public class * extends android.content.BroadcastReceiver
+-keep public class * extends android.content.ContentProvider
+-keep public class * extends android.app.backup.BackupAgentHelper
+-keep public class * extends android.preference.Preference
+-keep public class com.android.vending.licensing.ILicensingService
+
+-keepclasseswithmembernames class * {
+    native <methods>;
+}
+
+-keepclasseswithmembers class * {
+    public <init>(android.content.Context, android.util.AttributeSet);
+}
+
+-keepclasseswithmembers class * {
+    public <init>(android.content.Context, android.util.AttributeSet, int);
+}
+
+-keepclassmembers class * extends android.app.Activity {
+   public void *(android.view.View);
+}
+
+-keepclassmembers enum * {
+    public static **[] values();
+    public static ** valueOf(java.lang.String);
+}
+
+-keep class * implements android.os.Parcelable {
+  public static final android.os.Parcelable$Creator *;
+}

doc/images/android-new-project-name.png

@@ -0,0 +1,11 @@
+# This file is automatically generated by Android Tools.
+# Do not modify this file -- YOUR CHANGES WILL BE ERASED!
+#
+# This file must be checked in Version Control Systems.
+#
+# To customize properties used by the Ant build system use,
+# "ant.properties", and override values to adapt the script to your
+# project structure.
+
+# Project target.
+target=android-8

doc/images/android-new-project-target.png

@@ -0,0 +1,12 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
+    android:layout_width="fill_parent"
+    android:layout_height="fill_parent"
+    android:orientation="vertical" >
+
+    <TextView
+        android:layout_width="fill_parent"
+        android:layout_height="wrap_content"
+        android:text="@string/hello" />
+
+</LinearLayout>

doc/images/android-run-tutorial-tests.png

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+
+    <string name="hello">Hello World!</string>
+    <string name="app_name">Tutorial</string>
+
+</resources>

doc/images/android-test-manifest-file.png

@@ -0,0 +1,95 @@
+package cc.iqa.studio.demo.test;
+
+
+import java.io.*;
+import java.util.*;
+import org.antlr.runtime.*;
+
+import junit.framework.Assert;
+import cc.iqa.iquery.*;
+import cc.iqa.iquery.android.*;
+
+import com.jayway.android.robotium.solo.*;
+
+import android.test.ActivityInstrumentationTestCase2;
+import android.view.*;
+
+@SuppressWarnings("rawtypes")
+public class DemoOnlyTest extends ActivityInstrumentationTestCase2 {
+	private static String LAUNCHER_ACTIVITY_FULL_CLASSNAME = "cc.iqa.studio.demo.MainActivity";
+	private static String TARGET_PACKAGE_ID = "cc.iqa.studio.demo";
+
+	private Solo _solo;
+
+	@SuppressWarnings("unchecked")
+	public DemoOnlyTest() throws Exception {
+		super(TARGET_PACKAGE_ID, Class
+				.forName(LAUNCHER_ACTIVITY_FULL_CLASSNAME));
+	}
+
+	public void setUp() throws Exception {
+		this._solo = new Solo(this.getInstrumentation(), this.getActivity());
+	}
+
+	public void testParseElement() throws Exception {
+		List<ITreeNode> actual = parseQueryAgainst(
+				_solo.getCurrentViews().get(0), "LinearLayout >> TextView");
+		Assert.assertEquals(12, actual.size());
+
+		for (int i = 0; i < actual.size(); ++i) {
+			Assert.assertTrue(actual.get(i).getName().endsWith("TextView"));
+		}
+	}
+
+	public void testParseAttribute() throws Exception {
+			List<ITreeNode> actual = parseQueryAgainst(
+					_solo.getCurrentViews().get(0),
+					"LinearLayout >> TextView [mText = 'Down Under']");
+			Assert.assertEquals(2, actual.size());
+	
+			for (int i = 0; i < actual.size(); ++i) {
+				Assert.assertTrue(actual.get(i).getName().endsWith("TextView"));
+				Assert.assertEquals("Down Under", actual.get(i)
+						.getProperty("mText").getValue());
+			}
+	}
+
+	public void testParseAttributeNegative() throws Exception {
+		// remove supports to UNICODE attribute name for sake of consistent with iOS. 
+		List<ITreeNode> actual = parseQueryAgainst(
+				_solo.getCurrentViews().get(0),
+				"LinearLayout >> TextView [mText = 'Down Under']");
+		Assert.assertEquals(2, actual.size());
+	}
+	
+	public void testSimpleCreatingParserMethod() throws Exception {
+		iQueryParser parser = iQuery.createParser("LinearLayout >> TextView [mText = 'Down Under']");
+		List<ITreeNode> candidates = new ArrayList<ITreeNode>();
+		candidates.add(new SoloTreeNode(_solo.getCurrentViews().get(0)));
+		List<ITreeNode> result = parser.query(candidates);
+		
+		Assert.assertEquals(0, parser.getErrors().size());
+		Assert.assertEquals(2, result.size());
+	}
+	
+	public void testSimplifiedAPI() throws Exception {
+		List<SoloTreeNode> r1 = iQuery.query(
+				new SoloTreeNode(_solo.getCurrentViews().get(0)), 
+				"LinearLayout >> TextView [mText = 'Down Under']");
+		Assert.assertEquals(2, r1.size());				
+	}
+
+	private List<ITreeNode> parseQueryAgainst(View root, String iquery)
+			throws IOException, RecognitionException {
+		InputStream query = new ByteArrayInputStream(iquery.getBytes("utf8"));
+		ANTLRInputStream input = new ANTLRInputStream(query);
+		iQueryLexer lexer = new iQueryLexer(input);
+		CommonTokenStream tokens = new CommonTokenStream(lexer);
+		iQueryParser parser = new iQueryParser(tokens);
+
+		List<ITreeNode> candidates = new ArrayList<ITreeNode>();
+		candidates.add(new SoloTreeNode(root));
+		List<ITreeNode> result = parser.query(candidates);
+		return result;
+	}
+}