Initial sample push for Espresso 2.0 and AndroidJUnitRunner samples

- All samples can be build with gradle and AS
- README files to walk through sample usage
- Basic eclipse sample for static jar usage

Author: slinzner

.gitignore

@@ -0,0 +1,5 @@
+.idea
+*.iml
+local.properties
+build
+.gradle

build.gradle

@@ -0,0 +1,42 @@
+// Top-level build file where you can add configuration options common to all sub-projects/modules.
+
+buildscript {
+    repositories {
+        jcenter()
+    }
+    dependencies {
+        classpath 'com.android.tools.build:gradle:1.0.0'
+
+        // NOTE: Do not place your application dependencies here; they belong
+        // in the individual module build.gradle files
+    }
+}
+
+allprojects {
+    repositories {
+        jcenter()
+    }
+
+    apply plugin: 'findbugs'
+
+    task findbugs(type: FindBugs) {
+        ignoreFailures = true
+        effort = "max"
+        reportLevel = "high"
+        //excludeFilter = new File("${project.rootDir}/config/quality/findbugs/findbugs-filter.xml")
+        classes = files("$project.buildDir/intermediates/classes/")
+
+        source 'src'
+        include '**/*.java'
+        exclude '**/gen/**'
+
+        reports {
+            xml {
+                destination "$project.buildDir/reports/findbugs/findbugs.xml"
+                xml.withMessages true
+            }
+        }
+
+        classpath = files()
+    }
+}

espresso/BasicSample/.gitignore

@@ -0,0 +1,6 @@
+.gradle
+local.properties
+.idea
+.DS_Store
+build
+*.iml

espresso/BasicSample/README.md

@@ -0,0 +1,24 @@
+# Basic sample for Espresso
+
+*If you are new to Espresso, try this sample first.*
+
+This project uses the Gradle build system. You don't need an IDE to build and execute it but Android Studio is recommended.
+
+1. Download the project code, preferably using `git clone`.
+1. Open the Android SDK Manager (*Tools* Menu | *Android*) and make sure you have installed the *Android testing support library Repository* under *Extras*.
+1. In Android Studio, select *File* | *Open...* and point to the `./build.gradle` file.
+1. Check out the relevant code:
+    * The application under test is located in `src/main/java`
+    * Tests are in `src/androidTest/java`
+1. Create the test configuration with a custom runner: `android.support.test.runner.AndroidJUnitRunner`
+    * Open *Run* menu | *Edit Configurations*
+    * Add a new *Android Tests* configuration
+    * Choose a module
+    * Add a *Specific instrumentation runner*: `android.support.test.runner.AndroidJUnitRunner`
+1. Connect a device or start an emulator
+    * Turn animations off [link link]
+1. Run the newly created configuration
+
+The application will be started on the device/emulator and a series of actions will be performed automatically.
+
+If you are using Android Studio, the *Run* window will show the test results.

espresso/BasicSample/app/build.gradle

@@ -0,0 +1,32 @@
+apply plugin: 'com.android.application'
+
+android {
+    compileSdkVersion 21
+    buildToolsVersion '21.1.2'
+
+    defaultConfig {
+        applicationId "com.example.android.testing.espresso.BasicSample"
+        minSdkVersion 10
+        targetSdkVersion 21
+        versionCode 1
+        versionName "1.0"
+
+        testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"
+    }
+    packagingOptions {
+        exclude 'LICENSE.txt'
+    }
+    lintOptions {
+        abortOnError false
+    }
+}
+
+dependencies {
+    // App dependencies
+    compile 'com.android.support:support-annotations:21.0.3'
+    compile 'com.google.guava:guava:18.0'
+
+    // Testing-only dependencies
+    androidTestCompile 'com.android.support.test:testing-support-lib:0.1'
+    androidTestCompile 'com.android.support.test.espresso:espresso-core:2.0'
+}

espresso/BasicSample/app/src/androidTest/java/com/example/android/testing/espresso/BasicSample/ChangeTextBehaviorTest.java

@@ -0,0 +1,75 @@
+/*
+ * Copyright 2014, The Android Open Source Project
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.example.android.testing.espresso.BasicSample;
+
+import static android.support.test.espresso.Espresso.onView;
+import static android.support.test.espresso.action.ViewActions.click;
+import static android.support.test.espresso.action.ViewActions.closeSoftKeyboard;
+import static android.support.test.espresso.action.ViewActions.typeText;
+import static android.support.test.espresso.assertion.ViewAssertions.matches;
+import static android.support.test.espresso.matcher.ViewMatchers.withId;
+import static android.support.test.espresso.matcher.ViewMatchers.withText;
+
+import android.app.Activity;
+import android.test.ActivityInstrumentationTestCase2;
+
+import android.support.test.espresso.action.ViewActions;
+import android.support.test.espresso.matcher.ViewMatchers;
+
+
+/**
+ * Basic tests showcasing simple view matchers and actions like {@link ViewMatchers#withId},
+ * {@link ViewActions#click} and {@link ViewActions#typeText}.
+ * <p>
+ * Note that there is no need to tell Espresso that a view is in a different {@link Activity}.
+ * </p>
+ */
+public class ChangeTextBehaviorTest extends ActivityInstrumentationTestCase2<MainActivity> {
+
+    public static final String STRING_TO_BE_TYPED = "Espresso";
+
+    public ChangeTextBehaviorTest() {
+        super(MainActivity.class);
+    }
+
+    @Override
+    protected void setUp() throws Exception {
+        super.setUp();
+        // For each test method invocation, the Activity will not actually be created
+        // until the first time this method is called.
+        getActivity();
+    }
+
+    public void testChangeText_sameActivity() {
+        // Type text and then press the button.
+        onView(withId(R.id.editTextUserInput))
+                .perform(typeText(STRING_TO_BE_TYPED), closeSoftKeyboard());
+        onView(withId(R.id.changeTextBt)).perform(click());
+
+        // Check that the text was changed.
+        onView(withId(R.id.textToBeChanged)).check(matches(withText(STRING_TO_BE_TYPED)));
+    }
+
+    public void testChangeText_newActivity() {
+        // Type text and then press the button.
+        onView(withId(R.id.editTextUserInput)).perform(typeText(STRING_TO_BE_TYPED));
+        onView(withId(R.id.activityChangeTextBtn)).perform(click());
+
+        // This view is in a different Activity, no need to tell Espresso.
+        onView(withId(R.id.show_text_view)).check(matches(withText(STRING_TO_BE_TYPED)));
+    }
+}

espresso/BasicSample/app/src/main/AndroidManifest.xml

@@ -0,0 +1,36 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!--
+~ Copyright (C) 2014 The Android Open Source Project
+~
+~ Licensed under the Apache License, Version 2.0 (the "License");
+~ you may not use this file except in compliance with the License.
+~ You may obtain a copy of the License at
+~
+~   http://www.apache.org/licenses/LICENSE-2.0
+~
+~ Unless required by applicable law or agreed to in writing, software
+~ distributed under the License is distributed on an "AS IS" BASIS,
+~ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+~ See the License for the specific language governing permissions and
+~ limitations under the License.
+-->
+
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+    package="com.example.android.testing.espresso.BasicSample" >
+
+    <application
+        android:icon="@drawable/ic_launcher"
+        android:label="@string/app_name"
+        android:theme="@style/AppTheme" >
+        <activity
+            android:name="com.example.android.testing.espresso.BasicSample.MainActivity"
+            android:label="@string/app_name" >
+            <intent-filter>
+                <action android:name="android.intent.action.MAIN" />
+                <category android:name="android.intent.category.LAUNCHER" />
+            </intent-filter>
+        </activity>
+        <activity android:name="com.example.android.testing.espresso.BasicSample.ShowTextActivity"/>
+    </application>
+
+</manifest>

espresso/BasicSample/app/src/main/java/com/example/android/testing/espresso/BasicSample/MainActivity.java

@@ -0,0 +1,69 @@
+/*
+ * Copyright 2014, The Android Open Source Project
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.example.android.testing.espresso.BasicSample;
+
+import android.app.Activity;
+import android.content.Intent;
+import android.os.Bundle;
+import android.view.View;
+import android.widget.EditText;
+import android.widget.TextView;
+
+/**
+ * An {@link Activity} that gets a text string from the user and displays it back when the user
+ * clicks on one of the two buttons. The first one shows it in the same activity and the second
+ * one opens another activity and displays the message.
+ */
+public class MainActivity extends Activity implements View.OnClickListener {
+
+    // The TextView used to display the message inside the Activity.
+    private TextView mTextView;
+
+    // The EditText where the user types the message.
+    private EditText mEditText;
+
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        setContentView(R.layout.activity_main);
+
+        // Set the listeners for the buttons.
+        findViewById(R.id.changeTextBt).setOnClickListener(this);
+        findViewById(R.id.activityChangeTextBtn).setOnClickListener(this);
+
+        mTextView = (TextView) findViewById(R.id.textToBeChanged);
+        mEditText = (EditText) findViewById(R.id.editTextUserInput);
+    }
+
+    @Override
+    public void onClick(View view) {
+        // Get the text from the EditText view.
+        final String text = mEditText.getText().toString();
+
+        switch (view.getId()) {
+            case R.id.changeTextBt:
+                // First button's interaction: set a text in a text view.
+                mTextView.setText(text);
+                break;
+            case R.id.activityChangeTextBtn:
+                // Second button's interaction: start an activity and send a message to it.
+                Intent intent = ShowTextActivity.newStartIntent(this, text);
+                startActivity(intent);
+                break;
+        }
+    }
+}

espresso/BasicSample/app/src/main/java/com/example/android/testing/espresso/BasicSample/ShowTextActivity.java

@@ -0,0 +1,60 @@
+/*
+ * Copyright 2014, The Android Open Source Project
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.example.android.testing.espresso.BasicSample;
+
+import com.google.common.base.Strings;
+
+import android.app.Activity;
+import android.content.Context;
+import android.content.Intent;
+import android.os.Bundle;
+import android.widget.TextView;
+
+/**
+ * A simple {@link Activity} that shows a message.
+ */
+public class ShowTextActivity extends Activity {
+
+    // The name of the extra data sent through an {@link Intent}.
+    public final static String KEY_EXTRA_MESSAGE =
+            "com.example.android.testing.espresso.basicsample.MESSAGE";
+
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        setContentView(R.layout.activity_show_text);
+
+        // Get the message from the Intent.
+        Intent intent = getIntent();
+        String message = Strings.nullToEmpty(intent.getStringExtra(KEY_EXTRA_MESSAGE));
+
+        // Show message.
+        ((TextView)findViewById(R.id.show_text_view)).setText(message);
+    }
+
+    /**
+     * Creates an {@link Intent} for {@link ShowTextActivity} with the message to be displayed.
+     * @param context the {@link Context} where the {@link Intent} will be used
+     * @param message a {@link String} with text to be displayed
+     * @return an {@link Intent} used to start {@link ShowTextActivity}
+     */
+    static protected Intent newStartIntent(Context context, String message) {
+        Intent newIntent = new Intent(context, ShowTextActivity.class);
+        newIntent.putExtra(KEY_EXTRA_MESSAGE, message);
+        return newIntent;
+    }
+}