From 3e3fcf985f5d729437c3c40f568c8af1c42cc46d Mon Sep 17 00:00:00 2001 From: Joe Malin Date: Sun, 30 May 2010 18:35:53 -0700 Subject: [PATCH] Testing Documentation in the Dev Guide tab Change-Id: I36cb020642a7f094d2070509abb280c7c88f607f --- docs/html/guide/developing/testing/index.jd | 3 +- .../developing/testing/testing_eclipse.jd | 664 +++++----- .../developing/testing/testing_otheride.jd | 629 +++++----- docs/html/guide/guide_toc.cs | 27 +- .../guide/topics/testing/activity_testing.jd | 392 ++++++ .../topics/testing/contentprovider_testing.jd | 224 ++++ docs/html/guide/topics/testing/index.jd | 80 ++ .../guide/topics/testing/service_testing.jd | 178 +++ .../guide/topics/testing/testing_android.jd | 1114 +++++++++-------- .../html/guide/topics/testing/what_to_test.jd | 84 ++ .../images/testing/android_test_framework.png | Bin 82419 -> 47368 bytes docs/html/images/testing/test_framework.png | Bin 0 -> 43397 bytes 12 files changed, 2253 insertions(+), 1142 deletions(-) create mode 100644 docs/html/guide/topics/testing/activity_testing.jd create mode 100644 docs/html/guide/topics/testing/contentprovider_testing.jd create mode 100644 docs/html/guide/topics/testing/index.jd create mode 100644 docs/html/guide/topics/testing/service_testing.jd create mode 100644 docs/html/guide/topics/testing/what_to_test.jd create mode 100644 docs/html/images/testing/test_framework.png diff --git a/docs/html/guide/developing/testing/index.jd b/docs/html/guide/developing/testing/index.jd index ea61cc362d785..2164705295384 100644 --- a/docs/html/guide/developing/testing/index.jd +++ b/docs/html/guide/developing/testing/index.jd @@ -1,6 +1,5 @@ page.title=Testing Overview @jd:body -

Android includes powerful tools for setting up and running test applications. Whether you are working in Eclipse with ADT or working from the command line, these tools @@ -9,7 +8,7 @@ page.title=Testing Overview

If you aren't yet familiar with the Android testing framework, please read the topic - Testing and Instrumentation + Testing Fundamentals before you get started. For a step-by-step introduction to Android testing, try the Hello, Testing diff --git a/docs/html/guide/developing/testing/testing_eclipse.jd b/docs/html/guide/developing/testing/testing_eclipse.jd index da1c0f0b531d9..3258af9b4306a 100644 --- a/docs/html/guide/developing/testing/testing_eclipse.jd +++ b/docs/html/guide/developing/testing/testing_eclipse.jd @@ -1,28 +1,23 @@ page.title=Testing In Eclipse, with ADT @jd:body -

- +

- This topic explains how create and run tests of Android applications in Eclipse with ADT. - - with the basic processes for creating and running applications with ADT, as described in - Developing In Eclipse, with ADT. - - Before you read this topic, you should read about how to create a Android application with the - basic processes for creating and running applications with ADT, as described in - Developing In Eclipse, with ADT. - You may also want to read - Testing and Instrumentation, - which provides an overview of the Android testing framework. + This topic explains how create and run tests of Android applications in Eclipse with ADT. + Before you read this topic, you should read about how to create a Android application with the + basic processes for creating and running applications with ADT, as described in + Developing In Eclipse, with ADT. + You may also want to read + Testing Fundamentals, + which provides an overview of the Android testing framework.

ADT provides several features that help you set up and manage your testing environment @@ -32,20 +27,20 @@ page.title=Testing In Eclipse, with ADT

  • It lets you quickly create a test project and link it to the application under test. When it creates the test project, it automatically inserts the necessary - <instrumentation> element in the test application's manifest file. + <instrumentation> element in the test package's manifest file.
  • It lets you quickly import the classes of the application under test, so that your tests can inspect them.
  • - It lets you create run configurations for your test application and include in + It lets you create run configurations for your test package and include in them flags that are passed to the Android testing framework.
  • - It lets you run your test application without leaving Eclipse. ADT builds both the - application under test and the test application automatically, installs them if - necessary to your device or emulator, runs the test application, and displays the + It lets you run your test package without leaving Eclipse. ADT builds both the + application under test and the test package automatically, installs them if + necessary to your device or emulator, runs the test package, and displays the results in a separate window in Eclipse.
    • @@ -55,305 +50,396 @@ page.title=Testing In Eclipse, with ADT Testing in Other IDEs.

    Creating a Test Project

    -

    +

    To set up a test environment for your Android application, you must first create a separate - application project that holds the test code. The new project follows the directory structure + project that holds the test code. The new project follows the directory structure used for any Android application. It includes the same types of content and files, such as - source code, resources, a manifest file, and so forth. The test application you + source code, resources, a manifest file, and so forth. The test package you create is connected to the application under test by an <instrumentation> element in its manifest file. -

    -

    - The New Android Test Project dialog makes it easy for you to generate a - new test project that has the proper structure, including the - <instrumentation> element in the manifest file. You can use the New Android - Test Project dialog to generate the test project at any time. The dialog appears just after you - create a new Android main application project, but you can also run it to create a test project - for a project that you created previously. -

    +

    - To create a test project in Eclipse with ADT: + The New Android Test Project dialog makes it easy for you to generate a + new test project that has the proper structure, including the + <instrumentation> element in the manifest file. You can use the New + Android Test Project dialog to generate the test project at any time. The dialog appears + just after you create a new Android main application project, but you can also run it to + create a test project for a project that you created previously. +

    +

    + To create a test project in Eclipse with ADT:

      -
    1. - In Eclipse, select File > New > Other. This - opens the Select a Wizard dialog. -
      2. -
    2. - In the dialog, in the Wizards drop-down list, - find the entry for Android, then click the toggle to the left. Select - Android Test Project, then at the bottom - of the dialog click Next. The New Android Test Project wizard appears. -
      3. -
    3. - Enter a project name. You may use any name, but you may want to - associate the name with the project name for your Application. One - way to do this is to take the Application's project name, append the - string "Test" to it, and then use this as the test case project name. -
      4. -
    4. - In the Test Target panel, set - An Existing Android Project, click - Browse, then select your Android application from - the list. You now see that the wizard has completed the Test - Target Package, Application Name, and - Package Name fields for you (the latter two are in - the Properties panel). -
      5. -
    5. - In the Build Target panel, select the Android SDK - platform that you will use to test your application. Make this the same as the - build target of the application under test. -
      6. -
    6. - Click Finish to complete the wizard. If - Finish is disabled, look - for error messages at the top of the wizard dialog, and then fix - any problems. -
      7. +
    7. + In Eclipse, select File > New > Other. This opens the Select a + Wizard dialog. +
      8. +
    8. + In the dialog, in the Wizards drop-down list, find the entry for Android, then + click the toggle to the left. Select Android Test Project, then at the + bottom of the dialog click Next. The New Android Test Project + wizard appears. +
      9. +
    9. + Next to Test Project Name, enter a name for the project. You may use any name, + but you may want to associate the name with the project name for the application under test. + One way to do this is to take the application's project name, append the string "Test" to + it, and then use this as the test package project name. +

      + The name becomes part of the suggested project path, but you can change this in the + next step. +

      +
      10. +
    10. + In the Content panel, examine the suggested path to the project. + If Use default location is set, then the wizard will suggest a path that is + a concatenation of the workspace path and the project name you entered. For example, + if your workspace path is /usr/local/workspace and your project name is + MyTestApp, then the wizard will suggest + /usr/local/workspace/MyTestApp. To enter your own + choice for a path, unselect Use default location, then enter or browse to the + path where you want your project. +

      + To learn more about choosing the location of test projects, please read + + Testing Fundamentals. +

      +
      11. +
    11. + In the Test Target panel, set An Existing Android Project, click Browse, then select your + Android application from the list. You now see that the wizard has completed the Test + Target Package, Application Name, and Package Name fields for you (the latter two are in + the Properties panel). +
      12. +
    12. + In the Build Target panel, select the Android SDK platform that the application under test + uses. +
      13. +
    13. + Click Finish to complete the wizard. If Finish is disabled, look for error messages at the + top of the wizard dialog, and then fix any problems. +
      14. +
    +

    Creating a Test Package

    +

    + Once you have created a test project, you populate it with a test package. This package does not + require an Activity, although you can define one if you wish. Although your test package can + combine Activity classes, test case classes, or ordinary classes, your main test case + should extend one of the Android test case classes or JUnit classes, because these provide the + best testing features. +

    +

    + Test packages do not need to have an Android GUI. When you run the package in + Eclipse with ADT, its results appear in the JUnit view. Running tests and seeing the results is + described in more detail in the section Running Tests. +

    + +

    + To create a test package, start with one of Android's test case classes defined in + {@link android.test android.test}. These extend the JUnit + {@link junit.framework.TestCase TestCase} class. The Android test classes for Activity objects + also provide instrumentation for testing an Activity. To learn more about test case + classes, please read the topic + Testing Fundamentals. +

    +

    + Before you create your test package, you choose the Java package identifier you want to use + for your test case classes and the Android package name you want to use. To learn more + about this, please read + + Testing Fundamentals. +

    +

    + To add a test case class to your project: +

    +
      +
    1. + In the Project Explorer tab, open your test project, then open the src + folder. +
      2. +
    2. + Find the Java package identifier set by the projection creation wizard. If you haven't + added classes yet, this node won't have any children, and its icon will not be filled in. + If you want to change the identifier value, right-click the identifier and select + Refactor > Rename, then enter the new name. +
      3. +
    3. + When you are ready, right-click the Java package identifier again and select + New > Class. This displays the New Java Class + dialog, with the Source folder and Package values already set. +
      4. +
    4. + In the Name field, enter a name for the test case class. One way to choose a + class name is to append the string "Test" to the class of the component you are testing. + For example, if you are testing the class MyAppActivity, your test case class + name would be MyAppActivityTest. Leave the modifiers set to public. +
      5. +
    5. + In the Superclass field, enter the name of the Android test case class you + are extending. You can also browse the available classes. +
      6. +
    6. + In Which method stubs would you like to create?, unset all the options, then + click Finish. You will set up the constructor manually. +
      7. +
    7. + Your new class appears in a new Java editor pane. +

    - -

    -

    Creating a Test Application

    -

    - Once you have created a test project, you populate it with a test - Android application. This application does not require an {@link android.app.Activity Activity}, - although you can define one if you wish. Although your test application can - combine Activities, Android test class extensions, JUnit extensions, or - ordinary classes, you should extend one of the Android test classes or JUnit classes, - because these provide the best testing features. + You now have to ensure that the constructor is set up correctly. Create a constructor for your + class that has no arguments; this is required by JUnit. As the first statement in this + constructor, add a call to the base class' constructor. Each base test case class has its + own constructor signature. Refer to the class documentation in the documentation for + {@link android.test} for more information.

    - Test applications do not have an Android GUI. Instead, when you run the application in - Eclipse with ADT, its results appear in the JUnit view. If you run - your tests with {@link android.test.InstrumentationTestRunner InstrumentationTestRunner} (or a related test runner), - then it will run all the methods in each class. You can modify this behavior - by using the {@link junit.framework.TestSuite TestSuite} class. -

    - -

    - To create a test application, start with one of Android's test classes in the Java package {@link android.test android.test}. - These extend the JUnit {@link junit.framework.TestCase TestCase} class. With a few exceptions, the Android test classes - also provide instrumentation for testing. -

    -

    - For test classes that extend {@link junit.framework.TestCase TestCase}, you probably want to override - the setUp() and tearDown() methods: + To control your test environment, you will want to override the setUp() and + tearDown() methods:

    - Another useful convention is to add the method testPreConditions() to your test - class. Use this method to test that the application under test is initialized correctly. If this - test fails, you know that that the initial conditions were in error. When this happens, further test - results are suspect, regardless of whether or not the tests succeeded. + Another useful convention is to add the method testPreconditions() to your test + class. Use this method to test that the application under test is initialized correctly. If this + test fails, you know that that the initial conditions were in error. When this happens, further + test results are suspect, regardless of whether or not the tests succeeded.

    - The Resources tab contains an Activity Testing - tutorial with more information about creating test classes and methods. + The Resources tab contains an + Activity Testing + tutorial with more information about creating test classes and methods.

    Running Tests

    -
    -
    -

    Running tests from the command line

    -

    - If you've created your tests in Eclipse, you can still run your tests and test - suites by using command-line tools included with the Android SDK. You may want to - do this, for example, if you have a large number of tests to run, if you have a - large test case, or if you want a fine level of control over which tests are run at - a particular time. -

    -

    - To run tests created in Eclipse with ADT with command-line tools, you must first - install additional files into the test project using the android tool's - "create test-project" option. To see how to do this, read the section - - Creating a test project in the topic - Testing in Other - IDEs. -

    +
    +
    +

    Running tests from the command line

    +

    + If you've created your tests in Eclipse, you can still run your tests and test + suites by using command-line tools included with the Android SDK. You may want + to do this, for example, if you have a large number of tests to run, if you + have a large test case, or if you want a fine level of control over which + tests are run at a particular time. +

    +

    + To run tests created in Eclipse with ADT with command-line tools, you must first + install additional files into the test project using the android + tool's "create test-project" option. To see how to do this, read + + Testing in Other IDEs. +

    +
    -

    - When you run a test application in Eclipse with ADT, the output appears in - an Eclipse view panel. You can run the entire test application, one class, or one - method of a class. To do this, Eclipse runs the adb command for running a test application, and - displays the output, so there is no difference between running tests inside Eclipse and running them from the command line. + When you run a test package in Eclipse with ADT, the output appears in the Eclipse JUnit view. + You can run the entire test package or one test case class. To do run tests, Eclipse runs the + adb command for running a test package, and displays the output, so there is no + difference between running tests inside Eclipse and running them from the command line.

    - As with any other application, to run a test application in Eclipse with ADT you must either attach a device to your - computer or use the Android emulator. If you use the emulator, you must have an Android Virtual Device (AVD) that uses - the same target + As with any other package, to run a test package in Eclipse with ADT you must either attach a + device to your computer or use the Android emulator. If you use the emulator, you must have an + Android Virtual Device (AVD) that uses the same target as the test package.

    - To run a test in Eclipse, you have two choices:

    -
      -
    1. - Run a test just as you run an application, by selecting - Run As... > Android JUnit Test from the project's context menu or - from the main menu's Run item. -
      2. -
    2. - Create an Eclipse run configuration for your test project. This is useful if you want multiple test suites, each consisting of selected tests from the project. To run - a test suite, you run the test configuration. -

      - Creating and running test configurations is described in the next section. -

      -
      3. -
    -

    To create and run a test suite using a run configuration:

    -
      -
    1. - In the Package Explorer, select the test - project, then from the main menu, select - Run > Run Configurations.... The - Run Configurations dialog appears. -
      2. -
    2. - In the left-hand pane, find the - Android JUnit Test entry. - In the right-hand pane, click the Test tab. - The Name: text box - shows the name of your project. The - Test class: dropdown box shows one your project's classes - test classes in your project. -
      3. -
    3. - To run one test class, click Run a single test, then enter your project - name in the Project: text box and the class name in the - Test class: text box. -

      - To run all the test classes, - click Run all tests in the selected project or package, - then enter the project or package name in the text box. -

      -
      4. -
    4. - Now click the Target tab. -
        -
      • - Optional: If you are using the emulator, click - Automatic, then in the Android Virtual Device (AVD) - selection table, select an existing AVD. -
        • -
      • - In the Emulator Launch Parameters pane, set the - Android emulator flags you want to use. These are documented in the topic - Emulator Startup Options. -
        • -
      -
    5. - Click the Common tab. In the - Save As pane, click Local to save - this run configuration locally, or click Shared to - save it to another project. -
      6. -
    6. - Optional: Add the configuration to the Run toolbar and the Favorites - menu: in the Display in Favorites pane - click the checkbox next to Run. -
      7. -
    7. - Optional: To add this configuration to the Debug menu and toolbar, click - the checkbox next to Debug. -
      8. -
    8. - To save your settings, click Close.
      -

      Note: Although you can run the test immediately by - clicking Run, you should save the test first and then - run it by selecting it from the Eclipse standard toolbar.

      -
      9. -
    9. - On the Eclipse standard toolbar, click the down arrow next to the - green Run arrow. This displays a menu of saved Run and Debug - configurations. -
      10. -
    10. - Select the test run configuration you just created. -
      11. -
    11. - The progress of your test appears in the Console view. - You should see the following messages, among others: -
        -
      • - Performing Android.test.InstrumentationTestRunner JUnit launch
        - The class name that proceeds "JUnit" depends on the Android instrumentation - class you have chosen. -
        • -
      • - If you are using an emulator and you have not yet started it, then you will see - the message: + To run a test in Eclipse, you have two choices:

        +
          +
        • + Run a test just as you run an application, by selecting + Run As... > Android JUnit Test from the project's context menu or + from the main menu's Run item. +
          • +
        • + Create an Eclipse run configuration for your test project. This is useful if you want + multiple test suites, each consisting of selected tests from the project. To run + a test suite, you run the test configuration.

          - Automatic Target Mode: launching new emulator with compatible - AVD avdname
          (where avdname is the name of - the AVD you are using.) + Creating and running test configurations is described in the next section.

          -
          • -
        • - If you have not already installed your test application, then you will see - the message: +
          • +
        +

        + To create and run a test suite using a run configuration: +

        +
          +
        1. + In the Package Explorer, select the test project, then from the main menu, select + Run > Run Configurations.... The Run Configurations dialog appears. +
          2. +
        2. + In the left-hand pane, find the Android JUnit Test entry. In the right-hand pane, click the + Test tab. The Name: text box shows the name of your project. The Test class: dropdown box + shows one of the test classes in your project. +
          3. +
        3. + To run one test class, click Run a single test, then enter your project name in the + Project: text box and the class name in the Test class: text box.

          - Uploading testclass.apk onto device 'device-id'
          - where testclass is the name of your unit test class and device-id - is the name and port for your test device or emulator, followed by the message Installing testclass.apk + To run all the test classes, click Run all tests in the selected project or package, + then enter the project or package name in the text box.

          -
          4. -
        4. - Launching instrumentation Android.test.InstrumentationTestRunner on device device-id.
          - This indicates that Android's Instrumentation system is now testing your code. Again, the - instrumentation class name depends on the Android instrumentation class you have chosen. -
          5. -
        5. - Test run complete.
          When you see this, your unit tests have finished. -
          6. -
      +
      12. +
    12. + Now click the Target tab. +
        +
      • + Optional: If you are using the emulator, click Automatic, then in the Android + Virtual Device (AVD) selection table, select an existing AVD. +
        • +
      • + In the Emulator Launch Parameters pane, set the Android emulator flags you want to + use. These are documented in the topic + + Android Emulator. +
        • +
      +
    13. + Click the Common tab. In the Save As pane, click Local to save this run configuration + locally, or click Shared to save it to another project. +
      14. +
    14. + Optional: Add the configuration to the Run toolbar and the Favorites + menu: in the Display in Favorites pane click the checkbox next to Run. +
      15. +
    15. + Optional: To add this configuration to the Debug menu and toolbar, click + the checkbox next to Debug. +
      16. +
    16. + To save your settings, click Close.
      +

      Note: + Although you can run the test immediately by clicking Run, you should save the test + first and then run it by selecting it from the Eclipse standard toolbar. +

      +
      17. +
    17. + On the Eclipse standard toolbar, click the down arrow next to the green Run arrow. This + displays a menu of saved Run and Debug configurations. +
      18. +
    18. + Select the test run configuration you just created. The test starts. +

    - The test results appear in the JUnit view. This is divided into an upper summary pane, - and a lower stack trace pane. + The progress of your test appears in the Console view as a series of messages. Each message is + preceded by a timestamp and the Android package name to which it applies. + In the following description of these messages, devicename is the name of + the device or emulator you are using to run the test, and port is the + port number for the device. The name and port number are in the format used by the + adb devices + command. Also, testpackage is the name of the test package you are + running, and app_package is the label for the application under test. +

    + +

    + The test results appear in the JUnit view. This is divided into an upper summary pane, + and a lower stack trace pane.

    - The upper pane contains test information. In the pane's header, you see the following - information: + The upper pane contains test information. In the pane's header, you see the following + information:

    - +

    The body of the upper pane contains the details of the test run. For each test case class that was run, you see a line with the class name. To look at the results for the individual diff --git a/docs/html/guide/developing/testing/testing_otheride.jd b/docs/html/guide/developing/testing/testing_otheride.jd index 2bdf4d0b0b70d..523a8e57f36e3 100644 --- a/docs/html/guide/developing/testing/testing_otheride.jd +++ b/docs/html/guide/developing/testing/testing_otheride.jd @@ -2,122 +2,128 @@ page.title=Testing In Other IDEs @jd:body

    - This document describes how to create and run tests directly from the command line. - You can use the techniques described here if you are developing in an IDE other than Eclipse - or if you prefer to work from the command line. This document assumes that you already know how - to create a Android application in your programming environment. Before you start this - document, you should read the document Testing and Instrumentation, - which provides an overview of Android testing. + This document describes how to create and run tests directly from the command line. + You can use the techniques described here if you are developing in an IDE other than Eclipse + or if you prefer to work from the command line. This document assumes that you already know how + to create a Android application in your programming environment. Before you start this + document, you should read the topic + Testing Fundamentals, + which provides an overview of Android testing.

    - If you are developing in Eclipse with ADT, you can set up and run your tests -directly in Eclipse. For more information, please read Testing in Eclipse, with ADT. + If you are developing in Eclipse with ADT, you can set up and run your tests + directly in Eclipse. For more information, please read + + Testing in Eclipse, with ADT.

    Working with Test Projects

    - You use the android tool to create test projects. - You also use android to convert existing test code into an Android test project, - or to add the run-tests Ant target to an existing Android test project. - These operations are described in more detail in the section Updating a test project. - The run-tests target is described in Quick build and run with Ant. + You use the android tool to create test projects. + You also use android to convert existing test code into an Android test project, + or to add the run-tests Ant target to an existing Android test project. + These operations are described in more detail in the section + Updating a test project. The run-tests target is described in + Quick build and run with Ant.

    Creating a test project

    - To create a test project with the android tool, enter: -

    android create test-project -m <main_path> -n <project_name> -p <test_path>
    + To create a test project with the android tool, enter: +

    +
    +android create test-project -m <main_path> -n <project_name> -p <test_path>
+

    - You must supply all the flags. The following table explains them in detail: + You must supply all the flags. The following table explains them in detail:

    - - - - - - - - + + + + + + + - - - - - - - - - - + + + + + + + + + + + +
    FlagValueDescription
    -m, --main - Path to the project of the application under test, relative to the test application - directory. - - For example, if the application under test is in source/HelloAndroid, and you - want to create the test project in source/HelloAndroidTest, then the value of - --main should be ../HelloAndroid. +
    FlagValueDescription
    -m, --main + Path to the project of the application under test, relative to the test package + directory.
    -n, --nameName that you want to give the test project. 
    -p, --pathDirectory in which you want to create the new test project. - The android tool creates the test project files and directory structure in this - directory. If the directory does not exist, android creates it. -
    + For example, if the application under test is in source/HelloAndroid, and + you want to create the test project in source/HelloAndroidTest, then the + value of --main should be ../HelloAndroid. +

    + To learn more about choosing the location of test projects, please read + + Testing Fundamentals. +

    +
    -n, --nameName that you want to give the test project. 
    -p, --pathDirectory in which you want to create the new test project. + The android tool creates the test project files and directory structure + in this directory. If the directory does not exist, android creates it. +

    If the operation is successful, android lists to STDOUT the names of the files @@ -135,11 +141,10 @@ directly in Eclipse. For more information, please read

    - For example, suppose you create the Hello, World tutorial application - in the directory ~/source/HelloAndroid. In the tutorial, this application uses the - package name com.example.helloandroid and the activity name - HelloAndroid. You can to create the test for this in + For example, suppose you create the + Hello, World tutorial application in the directory ~/source/HelloAndroid. + In the tutorial, this application uses the package name com.example.helloandroid + and the activity name HelloAndroid. You can to create the test for this in ~/source/HelloAndroidTest. To do so, you enter: 

    @@ -196,7 +201,7 @@ $ android create test-project -m ../HelloAndroid -n HelloAndroidTest -p HelloAnd
 
    
     Note: If you change the Android package name of the application under test,
     you must manually change the value of the <android:targetPackage>
-    attribute within the AndroidManifest.xml file of the test application.
+    attribute within the AndroidManifest.xml file of the test package.
     Running android update test-project does not do this.
 
    
 
    
@@ -205,38 +210,38 @@ $ android create test-project -m ../HelloAndroid -n HelloAndroidTest -p HelloAnd
 
    android update-test-project -m <main_path> -p <test_path>
    
 
 
-
-  
-  
-  
-
-
-  
-  
-  
-
-
-  
-  
-  
-
+    
+        
+        
+        
+    
+    
+        
+        
+        
+    
+    
+        
+        
+        
+    
    FlagValueDescription
    -m, --mainThe path to the project of the application under test, relative to the test project
-    For example, if the application under test is in source/HelloAndroid, and
-    the test project is in source/HelloAndroidTest, then the value for
-    --main is ../HelloAndroid.
-  
    -p, --pathThe of the test project.
-    For example, if the test project is in source/HelloAndroidTest, then the
-    value for --path is HelloAndroidTest.
-  
    FlagValueDescription
    -m, --mainThe path to the project of the application under test, relative to the test project
+            For example, if the application under test is in source/HelloAndroid, and
+            the test project is in source/HelloAndroidTest, then the value for
+            --main is ../HelloAndroid.
+        
    -p, --pathThe of the test project.
+            For example, if the test project is in source/HelloAndroidTest, then the
+            value for --path is HelloAndroidTest.
+        
    
 
    
 
    
     If the operation is successful, android lists to STDOUT the names of the files
     and directories it has created.
 
    
-
    Creating a Test Application
    
+
    Creating a Test Package
    
 
    
-    Once you have created a test project, you populate it with a test application.
+    Once you have created a test project, you populate it with a test package.
     The application does not require an {@link android.app.Activity Activity},
-    although you can define one if you wish. Although your test application can
+    although you can define one if you wish. Although your test package can
     combine Activities, Android test class extensions, JUnit extensions, or
     ordinary classes, you should extend one of the Android test classes or JUnit classes,
     because these provide the best testing features.
@@ -248,7 +253,7 @@ $ android create test-project -m ../HelloAndroid -n HelloAndroidTest -p HelloAnd
 
    
 
 
    
-    To create a test application, start with one of Android's test classes in the Java package
+    To create a test package, start with one of Android's test classes in the Java package
     {@link android.test android.test}. These extend the JUnit
     {@link junit.framework.TestCase TestCase} class. With a few exceptions, the Android test
     classes also provide instrumentation for testing.
@@ -282,24 +287,17 @@ $ android create test-project -m ../HelloAndroid -n HelloAndroidTest -p HelloAnd
     test results are suspect, regardless of whether or not the tests succeeded.
 
    
 
    
-    To learn more about creating test applications, see the topic Testing and Instrumentation,
+    To learn more about creating test packages, see the topic Testing Fundamentals,
     which provides an overview of Android testing. If you prefer to follow a tutorial,
     try the Activity Testing
     tutorial, which leads you through the creation of tests for an actual Android application.
 
    
 
    Running Tests
    
 
    
-    If you are not developing in Eclipse with ADT, you need to run tests from the command line.
-    You can do this either with Ant or with the {@link android.app.ActivityManager ActivityManager}
-    command line interface.
-
    
-
    
-    You can also run tests from the command line even if you are using Eclipse with ADT to develop
-    them. To do this, you need to create the proper files and directory structure in the test
-    project, using the android tool with the option create test-project.
-    This is described in the section Working with Test Projects.
+    You run tests from the command line, either with Ant or with an
+    
+    Android Debug Bridge (adb) shell.
 
    
 
    Quick build and run with Ant
    
 
    
@@ -316,57 +314,63 @@ $ android create test-project -m ../HelloAndroid -n HelloAndroidTest -p HelloAnd
     You can update an existing test project to use this feature. To do this, use the
     android tool with the update test-project option. This is described
     in the section Updating a test project.
+
    
 
    Running tests on a device or emulator
    
 
    
-    When you run tests from the command line with the ActivityManager (am)
-    command-line tool, you get more options for choosing the tests to run than with any other
-    method. You can select individual test methods, filter tests according to their annotation, or
-    specify testing options. Since the test run is controlled entirely from a command line, you can
-    customize your testing with shell scripts in various ways.
+    When you run tests from the command line with
+    
+    Android Debug Bridge (adb), you get more options for choosing the tests
+    to run than with any other method. You can select individual test methods, filter tests
+    according to their annotation, or specify testing options. Since the test run is controlled
+    entirely from a command line, you can customize your testing with shell scripts in various ways.
 
    
 
    
-    You run the am tool on an Android device or emulator using the
-    Android Debug Bridge
-    (adb) shell. When you do this, you use the ActivityManager
-    instrument option to run your test application using an Android test runner
-    (usually {@link android.test.InstrumentationTestRunner}). You set am
-    options with command-line flags.
+    To run a test from the command line, you run adb shell to start a command-line
+    shell on your device or emulator, and then in the shell run the am instrument
+    command. You control am and your tests with command-line flags.
 
    
 
    
-    To run a test with am:
+    As a shortcut, you can start an adb shell, call am instrument, and
+    specify command-line flags all on one input line. The shell opens on the device or emulator,
+    runs your tests, produces output, and then returns to the command line on your computer.
+
    
+
    
+    To run a test with am instrument:
 
    
 
      
-  
    1. 
-    If necessary, re-build your main application and test application.
-  
      2. 
-  
    2. 
-    Install your test application and main application Android package files
-    (.apk files) to your current Android device or emulator
      3. 
-  
    3. 
-    At the command line, enter:
+    
    4. 
+        If necessary, rebuild your main application and test package.
+    
      5. 
+    
    5. 
+        Install your test package and main application Android package files
+        (.apk files) to your current Android device or emulator
      6. 
+    
    6. 
+        At the command line, enter:
 
       $ adb shell am instrument -w <test_package_name>/<runner_class>
 
      
-
      
-    where <test_package_name> is the Android package name of your test
-    application, and <runner_class> is the name of the Android test runner
-    class you are using. The Android package name is the value of the package
-    attribute of the manifest element in the manifest file
-    (AndroidManifest.xml) of your test application. The Android test runner
-    class is usually InstrumentationTestRunner.
-
      
-
      Your test results appear in STDOUT.
      
-  
      7. 
+        
      
+            where <test_package_name> is the Android package name of your test
+            application, and <runner_class> is the name of the Android test
+            runner class you are using. The Android package name is the value of the
+            package attribute of the manifest element in the manifest file
+            (AndroidManifest.xml) of your test package. The Android test runner
+            class is usually {@link android.test.InstrumentationTestRunner}.
+        
      
+        
      
+            Your test results appear in STDOUT.
+        
      
+    
 
    
 
    
-    This operation starts an adb shell, then runs am instrument in it
+    This operation starts an adb shell, then runs am instrument
     with the specified parameters. This particular form of the command will run all of the tests
-    in your test application. You can control this behavior with flags that you pass to
+    in your test package. You can control this behavior with flags that you pass to
     am instrument. These flags are described in the next section.
 
    
-
    Using the Instrument Command
    
+
    Using the am instrument Command
    
 
    
-  The general syntax of the am instrument command is:
+    The general syntax of the am instrument command is:
 
    
 
         am instrument [flags] <test_package>/<runner_class>
@@ -391,11 +395,11 @@ $ adb shell am instrument -w <test_package_name>/<runner_class>
             <test_package>
         
         
-            The Android package name of the test application.
+            The Android package name of the test package.
         
         
             The value of the package attribute of the manifest
-            element in the test application's manifest file.
+            element in the test package's manifest file.
         
     
     
@@ -411,7 +415,7 @@ $ adb shell am instrument -w <test_package_name>/<runner_class>
     
 
 
    
-The flags for am instrument are described in the following table:
+    The flags for am instrument are described in the following table:
 
    
 
@@ -461,20 +465,21 @@ The flags for am instrument are described in the following table:
              <test_options>
         
    
     
    
         
-            Provides testing options , in the form of key-value pairs. The
+            Provides testing options as key-value pairs. The
             am instrument tool passes these to the specified instrumentation class
             via its onCreate() method. You can specify multiple occurrences of
-            -e <test_options. The keys and values are described in the next table.
+            -e <test_options>. The keys and values are described in the
+            section am instrument options.
             
    
-                The only instrumentation class that understands these key-value pairs is
-                InstrumentationTestRunner (or a subclass). Using them with
+                The only instrumentation class that uses these key-value pairs is
+                {@link android.test.InstrumentationTestRunner} (or a subclass). Using them with
                 any other class has no effect.
             
    
             		
     
    
 
    
 
-
    Instrument options
    
+
    am instrument options
    
 
    
     The am instrument tool passes testing options to
     InstrumentationTestRunner or a subclass in the form of key-value pairs,
@@ -484,123 +489,127 @@ The flags for am instrument are described in the following table:
     -e <key> <value>
 
    
 
    
-    Where applicable, a <key> may have multiple values separated by a comma (,).
+    Some keys accept multiple values. You specify multiple values in a comma-separated list.
     For example, this invocation of InstrumentationTestRunner provides multiple
     values for the package key:
+
    
 
    -$ adb shell am instrument -w -e package com.android.test.package1,com.android.test.package2 com.android.test/android.test.InstrumentationTestRunner
+$ adb shell am instrument -w -e package com.android.test.package1,com.android.test.package2 \
+> com.android.test/android.test.InstrumentationTestRunner
 
    
 
    
     The following table describes the key-value pairs and their result. Please review the
     Usage Notes following the table.
 
    
 
-
-    
-    
-    
-
-
-    
-    
-    
-
-
-    
-    
-    
-
-
-    
-    
-
-
-    
-    
-    
-
-
-    
-    
-    
-
-
-    
-    
-    
-
-
-    
-    
-    
-
-
-    
-    
-    
-
-
-    
-    
-    
-
-
-    
-    
-    
-
-
-    
-    
-    
-
+    
+        
+        
+        
+    
+    
+        
+        
+        
+    
+    
+        
+        
+        
+    
+    
+        
+        
+    
+    
+        
+        
+        
+    
+    
+        
+        
+        
+    
+    
+        
+        
+        
+    
+    
+        
+        
+        
+    
+    
+        
+        
+        
+    
+    
+        
+        
+        
+    
+    
+        
+        
+        
+    
+    
+        
+        
+        
+    
    KeyValueDescription
    
-        package
-    
-        <Java_package_name>
-    
-        The fully-qualified Java package name for one of the packages in the test
-        application. Any test case class that uses this package name is executed. Notice that this
-        is not an Android package name; a test application has a single Android package
-        name but may have several Java packages within it.
-    
    class<class_name>
-        The fully-qualified Java class name for one of the test case classes. Only this test case
-        class is executed.
-    
    <class_name>#method name
-        A fully-qualified test case class name, and one of its methods. Only this method is
-        executed. Note the hash mark (#) between the class name and the method name.
-    
    functrue
-        Runs all test classes that extend {@link android.test.InstrumentationTestCase}.
-    
    unittrue
-        Runs all test classes that do not extend either
-        {@link android.test.InstrumentationTestCase} or {@link android.test.PerformanceTestCase}.
-    
    size[small | medium | large]
-    
-        Runs a test method annotated by size. The  annotations are @SmallTest,
-        @MediumTest, and @LargeTest.
-    
    perftrue
-        Runs all test classes that implement {@link android.test.PerformanceTestCase}.
-        When you use this option, also specify the -r flag for
-        am instrument, so that the output is kept in raw format and not
-        re-formatted as test results.
-    
    debugtrue
-        Runs tests in debug mode.
-    
    logtrue
-        Loads and logs all specified tests, but does not run them. The test
-        information appears in STDOUT. Use this to verify combinations of other filters
-        and test specifications.
-    
    emmatrue
-        Runs an EMMA code coverage analysis and writes the output to /data//coverage.ec
-        on the device. To override the file location, use the coverageFile key that
-        is described in the following entry.
-        
    
-            Note: This option requires an EMMA-instrumented build of the test
-            application, which you can generate with the coverage target.
-        
    
-    
    coverageFile<filename>
-        Overrides the default location of the EMMA coverage file on the device. Specify this
-        value as a path and filename in UNIX format. The default filename is described in the
-        entry for the emma key.
-    
    KeyValueDescription
    
+            package
+        
+            <Java_package_name>
+        
+            The fully-qualified Java package name for one of the packages in the test
+            application. Any test case class that uses this package name is executed. Notice that
+            this is not an Android package name; a test package has a single
+            Android package name but may have several Java packages within it.
+        
    class<class_name>
+            The fully-qualified Java class name for one of the test case classes. Only this test
+            case class is executed.
+        
    <class_name>#method name
+            A fully-qualified test case class name, and one of its methods. Only this method is
+            executed. Note the hash mark (#) between the class name and the method name.
+        
    functrue
+            Runs all test classes that extend {@link android.test.InstrumentationTestCase}.
+        
    unittrue
+            Runs all test classes that do not extend either
+            {@link android.test.InstrumentationTestCase} or
+            {@link android.test.PerformanceTestCase}.
+        
    size
+            [small | medium | large]
+        
+            Runs a test method annotated by size. The  annotations are @SmallTest,
+            @MediumTest, and @LargeTest.
+        
    perftrue
+            Runs all test classes that implement {@link android.test.PerformanceTestCase}.
+            When you use this option, also specify the -r flag for
+            am instrument, so that the output is kept in raw format and not
+            re-formatted as test results.
+        
    debugtrue
+            Runs tests in debug mode.
+        
    logtrue
+            Loads and logs all specified tests, but does not run them. The test
+            information appears in STDOUT. Use this to verify combinations of other
+            filters and test specifications.
+        
    emmatrue
+            Runs an EMMA code coverage analysis and writes the output to
+            /data//coverage.ec on the device. To override the file location, use the
+            coverageFile key that is described in the following entry.
+            
    
+                Note: This option requires an EMMA-instrumented build of the test
+                application, which you can generate with the coverage target.
+            
    
+        
    coverageFile<filename>
+            Overrides the default location of the EMMA coverage file on the device. Specify this
+            value as a path and filename in UNIX format. The default filename is described in the
+            entry for the emma key.
+        
    
 
    
 -e Flag Usage Notes
 
      
@@ -618,13 +627,13 @@ $ adb shell am instrument -w -e package com.android.test.package1,com.android.te
         The func key and unit key are mutually exclusive.
     
 
    
-
    Instrument examples
    
+
    Usage examples
    
 
    
-Here are some examples of using am instrument to run tests. They are based on
-the following structure:
    
+The following sections provide examples of using am instrument to run tests.
+They are based on the following structure:
    
 
      
     
    • 
-        The test application has the Android package name com.android.demo.app.tests
+        The test package has the Android package name com.android.demo.app.tests
     
      • 
     
    • 
         There are three test classes:
@@ -647,35 +656,35 @@ the following structure:
      
         The test runner is {@link android.test.InstrumentationTestRunner}.
     
      • 
 
    
-
    Running the Entire Test Application
    
+
    Running the entire test package
    
 
    
-    To run all of the test classes in the test application, enter:
+    To run all of the test classes in the test package, enter:
 
    
 
     $ adb shell am instrument -w com.android.demo.app.tests/android.test.InstrumentationTestRunner
 
    
-
    Running All Tests in a Test Case Class
    
+
    Running all tests in a test case class
    
 
    
     To run all of the tests in the class UnitTests, enter:
 
    
 
     $ adb shell am instrument -w  \
--e class com.android.demo.app.tests.UnitTests \
-com.android.demo.app.tests/android.test.InstrumentationTestRunner
+> -e class com.android.demo.app.tests.UnitTests \
+> com.android.demo.app.tests/android.test.InstrumentationTestRunner
 
    
 
    
   am instrument gets the value of the -e flag, detects the
   class keyword, and runs all the methods in the UnitTests class.
 
    
-
    Selecting a Subset of Tests
    
+
    Selecting a subset of tests
    
 
    
-  To run all of the tests in UnitTests, and the testCamera method in
-  FunctionTests, enter:
+    To run all of the tests in UnitTests, and the testCamera method in
+    FunctionTests, enter:
 
    
 
     $ adb shell am instrument -w \
--e class com.android.demo.app.tests.UnitTests,com.android.demo.app.tests.FunctionTests#testCamera \
-com.android.demo.app.tests/android.test.InstrumentationTestRunner
+> -e class com.android.demo.app.tests.UnitTests,com.android.demo.app.tests.FunctionTests#testCamera \
+> com.android.demo.app.tests/android.test.InstrumentationTestRunner
 
    
 
    
     You can find more examples of the command in the documentation for
diff --git a/docs/html/guide/guide_toc.cs b/docs/html/guide/guide_toc.cs
index 35ce17e26eaea..9793748e8ce6e 100644
--- a/docs/html/guide/guide_toc.cs
+++ b/docs/html/guide/guide_toc.cs
@@ -254,9 +254,30 @@
             
  • Searchable Configuration
    • 
           
       
-      
  • 
-            Testing and Instrumentation
-            new!
    • 
+      
  • 
+           
    
+                
+                   Testing
+                new!
+           
    
+           
+      
    • 
     
   
 
diff --git a/docs/html/guide/topics/testing/activity_testing.jd b/docs/html/guide/topics/testing/activity_testing.jd
new file mode 100644
index 0000000000000..6392ad7e64907
--- /dev/null
+++ b/docs/html/guide/topics/testing/activity_testing.jd
@@ -0,0 +1,392 @@
+page.title=Activity Testing
+@jd:body
+
+
    
+  
    
+  
    In this document
    
+  
      
+    
    1. 
+      The Activity Testing API
+      
        
+        
      1. 
+            ActivityInstrumentationTestCase2
+        
        2. 
+        
      2. 
+            ActivityUnitTestCase
+        
        3. 
+        
      3. 
+            SingleLaunchActivityTestCase
+        
        4. 
+        
      4. 
+            Mock objects and activity testing
+        
        5. 
+        
      5. 
+            Assertions for activity testing
+        
        6. 
+      
      
+    
      2. 
+    
    2. 
+        What to Test
+    
      3. 
+    
    3. 
+        Next Steps
+    
      4. 
+    
    4. 
+      Appendix: UI Testing Notes
+      
        
+        
      1. 
+          Testing on the UI thread
+        
        2. 
+        
      2. 
+          Turning off touch mode
+        
        3. 
+        
      3. 
+          Unlocking the Emulator or Device
+        
        4. 
+        
      4. 
+          Troubleshooting UI tests
+        
        5. 
+      
      
+    
      5. 
+    
    
+
    Key Classes
    
+    
      
+      
    1. {@link android.test.InstrumentationTestRunner}
      2. 
+      
    2. {@link android.test.ActivityInstrumentationTestCase2}
      3. 
+      
    3. {@link android.test.ActivityUnitTestCase}
      4. 
+    
    
+
    Related Tutorials
    
+    
      
+      
    1. 
+        
+        Hello, Testing
+      
      2. 
+      
    2. 
+         Activity Testing
+      
      3. 
+    
    
+
    See Also
    
+      
      
+        
    1. 
+          
+          Testing in Eclipse, with ADT
+        
      2. 
+        
    2. 
+          
+          Testing in Other IDEs
+        
      3. 
+      
    
+  
    
+
    
+
    
+    Activity testing is particularly dependent on the the Android instrumentation framework.
+    Unlike other components, activities have a complex lifecycle based on callback methods; these
+    can't be invoked directly except by instrumentation. Also, the only way to send events to the
+    user interface from a program is through instrumentation.
+
    
+
    
+    This document describes how to test activities using instrumentation and other test
+    facilities. The document assumes you have already read
+    Testing Fundamentals,
+    the introduction to the Android testing and instrumentation framework.
+
    
+
    The Activity Testing API
    
+
    
+    The activity testing API base class is {@link android.test.InstrumentationTestCase},
+    which provides instrumentation to the test case subclasses you use for Activities.
+
    
+
    
+    For activity testing, this base class provides these functions:
+
    
+
      
+    
    • 
+        Lifecycle control: With instrumentation, you can start the activity under test, pause it,
+        and destroy it, using methods provided by the test case classes.
+    
      • 
+    
    • 
+        Dependency injection: Instrumentation allows you to create mock system objects such as
+        Contexts or Applications and use them to run the activity under test. This
+        helps you control the test environment and isolate it from production systems. You can
+        also set up customized Intents and start an activity with them.
+    
      • 
+    
    • 
+        User interface interaction: You use instrumentation to send keystrokes or touch events
+        directly to the UI of the activity under test.
+    
      • 
+
    
+
    
+    The activity testing classes also provide the JUnit framework by extending
+    {@link junit.framework.TestCase} and {@link junit.framework.Assert}.
+
    
+
    
+    The two main testing subclasses are {@link android.test.ActivityInstrumentationTestCase2} and
+    {@link android.test.ActivityUnitTestCase}. To test an Activity that is launched in a mode
+    other than standard, you use {@link android.test.SingleLaunchActivityTestCase}.
+
    
+
    ActivityInstrumentationTestCase2
    
+
    
+    The {@link android.test.ActivityInstrumentationTestCase2} test case class is designed to do
+    functional testing of one or more Activities in an application, using a normal system
+    infrastructure. It runs the Activities in a normal instance of the application under test,
+    using a standard system Context. It allows you to send mock Intents to the activity under
+    test, so you can use it to test an activity that responds to multiple types of intents, or
+    an activity that expects a certain type of data in the intent, or both. Notice, though, that it
+    does not allow mock Contexts or Applications, so you can not isolate the test from the rest of
+    a production system.
+
    
+
    ActivityUnitTestCase
    
+
    
+    The {@link android.test.ActivityUnitTestCase} test case class tests a single activity in
+    isolation. Before you start the activity, you can inject a mock Context or Application, or both.
+    You use it to run activity tests in isolation, and to do unit testing of methods
+    that do not interact with Android. You can not send mock Intents to the activity under test,
+    although you can call
+    {@link android.app.Activity#startActivity(Intent) Activity.startActivity(Intent)} and then
+    look at arguments that were received.
+
    
+
    SingleLaunchActivityTestCase
    
+
    
+    The {@link android.test.SingleLaunchActivityTestCase} class is a convenience class for
+    testing a single activity in an environment that doesn't change from test to test.
+    It invokes {@link junit.framework.TestCase#setUp() setUp()} and
+    {@link junit.framework.TestCase#tearDown() tearDown()} only once, instead of once per
+    method call. It does not allow you to inject any mock objects.
+
    
+
    
+    This test case is useful for testing an activity that runs in a mode other than
+    standard. It ensures that the test fixture is not reset between tests. You
+    can then test that the activity handles multiple calls correctly.
+
    
+
    Mock objects and activity testing
    
+
    
+    This section contains notes about the use of the mock objects defined in
+    {@link android.test.mock} with activity tests.
+
    
+
    
+    The mock object {@link android.test.mock.MockApplication} is only available for activity
+    testing if you use the {@link android.test.ActivityUnitTestCase} test case class.
+    By default, ActivityUnitTestCase, creates a hidden MockApplication
+    object that is used as the application under test. You can inject your own object using
+    {@link android.test.ActivityUnitTestCase#setApplication(Application) setApplication()}.
+
    
+
    Assertions for activity testing
    
+
    
+    {@link android.test.ViewAsserts} defines assertions for Views. You use it to verify the
+    alignment and position of View objects, and to look at the state of ViewGroup objects.
+
    
+
    What To Test
    
+
      
+    
    • 
+        Input validation: Test that an activity responds correctly to input values in an
+        EditText View. Set up a keystroke sequence, send it to the activity, and then
+        use {@link android.view.View#findViewById(int)} to examine the state of the View. You can
+        verify that a valid keystroke sequence enables an OK button, while an invalid one leaves the
+        button disabled. You can also verify that the Activity responds to invalid input by
+        setting error messages in the View.
+    
      • 
+    
    • 
+        Lifecycle events: Test that each of your application's activities handles lifecycle events
+        correctly. In general, lifecycle events are actions, either from the system or from the
+        user, that trigger a callback method such as onCreate() or
+        onClick(). For example, an activity should respond to pause or destroy events
+        by saving its state. Remember that even a change in screen orientation causes the current
+        activity to be destroyed, so you should test that accidental device movements don't
+        accidentally lose the application state.
+    
      • 
+    
    • 
+        Intents: Test that each activity correctly handles the intents listed in the intent
+        filter specified in its manifest. You can use
+        {@link android.test.ActivityInstrumentationTestCase2} to send mock Intents to the
+        activity under test.
+    
      • 
+    
    • 
+        Runtime configuration changes: Test that each activity responds correctly to the
+        possible changes in the device's configuration while your application is running. These
+        include a change to the device's orientation, a change to the current language, and so
+        forth. Handling these changes is described in detail in the topic
+        Handling Runtime
+        Changes.
+    
      • 
+    
    • 
+        Screen sizes and resolutions: Before you publish your application, make sure to test it on
+        all of the screen sizes and densities on which you want it to run. You can test the
+        application on multiple sizes and densities using AVDs, or you can test your application
+        directly on the devices that you are targeting. For more information, see the topic
+        Supporting Multiple Screens.
+    
      • 
+
    
+
    Next Steps
    
+
    
+    To learn how to set up and run tests in Eclipse, please refer to Testing in
+    Eclipse, with ADT. If you're not working in Eclipse, refer to Testing in Other
+    IDEs.
+
    
+
    
+    If you want a step-by-step introduction to testing activities, try one of the
+    testing tutorials:
+
    
+
      
+    
    • 
+        The Hello,
+        Testing tutorial introduces basic testing concepts and procedures in the
+        context of the Hello, World application.
+    
      • 
+    
    • 
+        The Activity
+        Testing tutorial is an excellent follow-up to the Hello, Testing tutorial.
+        It guides you through a more complex testing scenario that you develop against a
+        more realistic activity-oriented application.
+    
      • 
+
    
+
    Appendix: UI Testing Notes
    
+
    
+    The following sections have tips for testing the UI of your Android application, specifically
+    to help you handle actions that run in the UI thread, touch screen and keyboard events, and home
+    screen unlock during testing.
+
    
+
    Testing on the UI thread
    
+
    
+    An application's activities run on the application's UI thread. Once the
+    UI is instantiated, for example in the activity's onCreate() method, then all
+    interactions with the UI must run in the UI thread. When you run the application normally, it
+    has access to the thread and does not have to do anything special.
+
    
+
    
+    This changes when you run tests against the application. With instrumentation-based classes,
+    you can invoke methods against the UI of the application under test. The other test classes
+    don't allow this. To run an entire test method on the UI thread, you can annotate the thread
+    with @UIThreadTest. Notice that this will run all of the method statements
+    on the UI thread.  Methods that do not interact with the UI are not allowed; for example, you
+    can't invoke Instrumentation.waitForIdleSync().
+
    
+
    
+    To run a subset of a test method on the UI thread, create an anonymous class of type
+    Runnable, put the statements you want in the run() method, and
+    instantiate a new instance of the class as a parameter to the method
+    appActivity.runOnUiThread(), where appActivity is
+    the instance of the application you are testing.
+
    
+
    
+    For example, this code instantiates an activity to test, requests focus (a UI action) for the
+    Spinner displayed by the activity, and then sends a key to it. Notice that the calls to
+    waitForIdleSync and sendKeys aren't allowed to run on the UI thread:
+
    
+
    +  private MyActivity mActivity; // MyActivity is the class name of the app under test
+  private Spinner mSpinner;
+
+  ...
+
+  protected void setUp() throws Exception {
+      super.setUp();
+      mInstrumentation = getInstrumentation();
+
+      mActivity = getActivity(); // get a references to the app under test
+
+      /*
+       * Get a reference to the main widget of the app under test, a Spinner
+       */
+      mSpinner = (Spinner) mActivity.findViewById(com.android.demo.myactivity.R.id.Spinner01);
+
+  ...
+
+  public void aTest() {
+      /*
+       * request focus for the Spinner, so that the test can send key events to it
+       * This request must be run on the UI thread. To do this, use the runOnUiThread method
+       * and pass it a Runnable that contains a call to requestFocus on the Spinner.
+       */
+      mActivity.runOnUiThread(new Runnable() {
+          public void run() {
+              mSpinner.requestFocus();
+          }
+      });
+
+      mInstrumentation.waitForIdleSync();
+
+      this.sendKeys(KeyEvent.KEYCODE_DPAD_CENTER);
+
    
+
+
    Turning off touch mode
    
+
    
+    To control the emulator or a device with key events you send from your tests, you must turn off
+    touch mode. If you do not do this, the key events are ignored.
+
    
+
    
+    To turn off touch mode, you invoke
+    ActivityInstrumentationTestCase2.setActivityTouchMode(false)
+    before you call getActivity() to start the activity. You must invoke the
+    method in a test method that is not running on the UI thread. For this reason, you
+    can't invoke the touch mode method from a test method that is annotated with
+    @UIThread. Instead, invoke the touch mode method from setUp().
+
    
+
    Unlocking the emulator or device
    
+
    
+    You may find that UI tests don't work if the emulator's or device's home screen is disabled with
+    the keyguard pattern. This is because the application under test can't receive key events sent
+    by sendKeys(). The best way to avoid this is to start your emulator or device
+    first and then disable the keyguard for the home screen.
+
    
+
    
+    You can also explicitly disable the keyguard. To do this,
+    you need to add a permission in the manifest file (AndroidManifest.xml) and
+    then disable the keyguard in your application under test. Note, though, that you either have to
+    remove this before you publish your application, or you have to disable it with code in
+    the published application.
+
    
+
    
+    To add the the permission, add the element
+    <uses-permission android:name="android.permission.DISABLE_KEYGUARD"/>
+    as a child of the <manifest> element. To disable the KeyGuard, add the
+    following code to the onCreate() method of activities you intend to test:
+
    
+
    +  mKeyGuardManager = (KeyguardManager) getSystemService(KEYGUARD_SERVICE);
+  mLock = mKeyGuardManager.newKeyguardLock("activity_classname");
+  mLock.disableKeyguard();
+
    
+
    where activity_classname is the class name of the activity.
    
+
    Troubleshooting UI tests
    
+
    
+    This section lists some of the common test failures you may encounter in UI testing, and their
+    causes:
+
    
+
    
+    
    WrongThreadException
    
+    
    
+      
    Problem:
    
+      For a failed test, the Failure Trace contains the following error message:
+      
+        android.view.ViewRoot$CalledFromWrongThreadException: Only the original thread that created
+        a view hierarchy can touch its views.
+      
+      
    Probable Cause:
    
+        This error is common if you tried to send UI events to the UI thread from outside the UI
+        thread. This commonly happens if you send UI events from the test application, but you don't
+        use the @UIThread annotation or the runOnUiThread() method. The
+        test method tried to interact with the UI outside the UI thread.
+      
    Suggested Resolution:
    
+        Run the interaction on the UI thread. Use a test class that provides instrumentation. See
+        the previous section Testing on the UI Thread
+        for more details.
+    
    
+    
    java.lang.RuntimeException
    
+    
    
+      
    Problem:
    
+        For a failed test, the Failure Trace contains the following error message:
+      
+        java.lang.RuntimeException: This method can not be called from the main application thread
+      
+      
    Probable Cause:
    
+        This error is common if your test method is annotated with @UiThreadTest but
+        then tries to do something outside the UI thread or tries to invoke
+        runOnUiThread().
+      
    Suggested Resolution:
    
+        Remove the @UiThreadTest annotation, remove the runOnUiThread()
+        call, or re-factor your tests.
+    
    
+
    
diff --git a/docs/html/guide/topics/testing/contentprovider_testing.jd b/docs/html/guide/topics/testing/contentprovider_testing.jd
new file mode 100644
index 0000000000000..893b5c9b43299
--- /dev/null
+++ b/docs/html/guide/topics/testing/contentprovider_testing.jd
@@ -0,0 +1,224 @@
+page.title=Content Provider Testing
+@jd:body
+
+
    
+  
    
+  
    In this document
    
+  
      
+    
    1. 
+        Content Provider Design and Testing
+    
      2. 
+    
    2. 
+      The Content Provider Testing API
+      
        
+        
      1. 
+          ProviderTestCase2 
+        
        2. 
+        
      2. 
+          Mock object classes
+        
        3. 
+      
      
+    
      3. 
+    
    3. 
+        What To Test
+    
      4. 
+    
    4. 
+        Next Steps
+    
      5. 
+  
    
+  
    Key Classes
    
+    
      
+      
    1. {@link android.test.InstrumentationTestRunner}
      2. 
+      
    2. {@link android.test.ProviderTestCase2}
      3. 
+      
    3. {@link android.test.IsolatedContext}
      4. 
+      
    4. {@link android.test.mock.MockContentResolver}
      5. 
+    
    
+  
    See Also
    
+      
      
+        
    1. 
+          
+          Testing Fundamentals
+        
      2. 
+        
    2. 
+          
+          Testing in Eclipse, with ADT
+        
      3. 
+        
    3. 
+          
+          Testing in Other IDEs
+        
      4. 
+      
    
+  
    
+
    
+
    
+    Content providers, which store and retrieve data and make it accessible across applications,
+    are a key part of the Android API. As an application developer you're allowed to provide your
+    own public providers for use by other applications. If you do, then you should test them
+    using the API you publish.
+
    
+
    
+    This document describes how to test public content providers, although the information is
+    also applicable to providers that you keep private to your own application. If you aren't
+    familiar with content  providers or the Android testing framework, please read
+    Content Providers,
+    the guide to developing content providers, and
+    Testing Fundamentals,
+    the introduction to the Android testing and instrumentation framework.
+
    
+
    Content Provider Design and Testing
    
+
    
+    In Android, content providers are viewed externally as data APIs that provide
+    tables of data, with their internals hidden from view. A content provider may have many
+    public constants, but it usually has few if any public methods and no public variables.
+    This suggests that you should write your tests based only on the provider's public members.
+    A content provider that is designed like this is offering a contract between itself and its
+    users.
+
    
+
    
+    The base test case class for content providers,
+    {@link android.test.ProviderTestCase2}, allows you to test your content provider in an
+    isolated environment. Android mock objects such as {@link android.test.IsolatedContext} and
+    {@link android.test.mock.MockContentResolver} also help provide an isolated test environment.
+
    
+
    
+    As with other Android tests, provider test packages are run under the control of the test
+    runner {@link android.test.InstrumentationTestRunner}. The section
+    
+    Running Tests With InstrumentationTestRunner describes the test runner in
+    more detail. The topic 
+    Testing in Eclipse, with ADT shows you how to run a test package in Eclipse, and the
+    topic 
+    Testing in Other IDEs
+    shows you how to run a test package from the command line.
+
    
+
    Content Provider Testing API
    
+
    
+    The main focus of the provider testing API is to provide an isolated testing environment. This
+    ensures that tests always run against data dependencies set explicitly in the test case. It
+    also prevents tests from modifying actual user data. For example, you want to avoid writing
+    a test that fails because there was data left over from a previous test, and you want to
+    avoid adding or deleting contact information in a actual provider.
+
    
+
    
+    The test case class and mock object classes for provider testing set up this isolated testing
+    environment for you.
+
    
+
    ProviderTestCase2
    
+
    
+    You test a provider with a subclass of {@link android.test.ProviderTestCase2}. This base class
+    extends {@link android.test.AndroidTestCase}, so it provides the JUnit testing framework as well
+    as Android-specific methods for testing application permissions. The most important
+    feature of this class is its initialization, which creates the isolated test environment.
+
    
+
    
+    The initialization is done in the constructor for {@link android.test.ProviderTestCase2}, which
+    subclasses call in their own constructors. The {@link android.test.ProviderTestCase2}
+    constructor creates an {@link android.test.IsolatedContext} object that allows file and
+    database operations but stubs out other interactions with the Android system.
+    The file and database operations themselves take place in a directory that is local to the
+    device or emulator and has a special prefix.
+
    
+
    
+    The constructor then creates a {@link android.test.mock.MockContentResolver} to use as the
+    resolver for the test. The {@link android.test.mock.MockContentResolver} class is described in
+    detail in the section
+    Mock object classes.
+
    
+
    
+    Lastly, the constructor creates an instance of the provider under test. This is a normal
+    {@link android.content.ContentProvider} object, but it takes all of its environment information
+    from the {@link android.test.IsolatedContext}, so it is restricted to
+    working in the isolated test environment. All of the tests done in the test case class run
+    against this isolated object.
+
    
+
    Mock object classes
    
+
    
+    {@link android.test.ProviderTestCase2} uses {@link android.test.IsolatedContext} and
+    {@link android.test.mock.MockContentResolver}, which are standard mock object classes. To
+    learn more about them, please read
+    
+    Testing Fundamentals.
+
    
+
    What To Test
    
+
    
+    The topic What To Test
+    lists general considerations for testing Android components.
+    Here are some specific guidelines for testing content providers.
+
    
+
      
+    
    • 
+        Test with resolver methods: Even though you can instantiate a provider object in
+        {@link android.test.ProviderTestCase2}, you should always test with a resolver object
+        using the appropriate URI. This ensures that you are testing the provider using the same
+        interaction that a regular application would use.
+    
      • 
+    
    • 
+        Test a public provider as a contract: If you intent your provider to be public and
+        available to other applications, you should test it as a contract. This includes
+        the following ideas:
+        
        
+            
      • 
+                Test with constants that your provider publicly exposes. For
+                example, look for constants that refer to column names in one of the provider's
+                data tables. These should always be constants publicly defined by the provider.
+            
        • 
+            
      • 
+                Test all the URIs offered by your provider. Your provider may offer several URIs,
+                each one referring to a different aspect of the data. The
+                Note Pad sample,
+                for example, features a provider that offers one URI for retrieving a list of notes,
+                another for retrieving an individual note by it's database ID, and a third for
+                displaying notes in a live folder. The sample test package for Note Pad,
+                 Note Pad Test, has
+                unit tests for two of these URIs.
+            
        • 
+            
      • 
+                Test invalid URIs: Your unit tests should deliberately call the provider with an
+                invalid URI, and look for errors. Good provider design is to throw an
+                IllegalArgumentException for invalid URIs.
+
+            
        • 
+        
      
+    
      • 
+    
    • 
+        Test the standard provider interactions: Most providers offer six access methods:
+        query, insert, delete, update, getType, and onCreate(). Your tests should verify that all
+        of these methods work. These are described in more detail in the topic
+        Content Providers.
+    
      • 
+    
    • 
+        Test business logic: Don't forget to test the business logic that your provider should
+        enforce. Business logic includes handling of invalid values, financial or arithmetic
+        calculations, elimination or combining of duplicates, and so forth. A content provider
+        does not have to have business logic, because it may be implemented by activities that
+        modify the data. If the provider does implement business logic, you should test it.
+    
      • 
+
    
+
    Next Steps
    
+
    
+    To learn how to set up and run tests in Eclipse, please refer to Testing in
+    Eclipse, with ADT. If you're not working in Eclipse, refer to Testing in Other
+    IDEs.
+
    
+
    
+    If you want a step-by-step introduction to testing activities, try one of the
+    testing tutorials:
+
    
+
      
+    
    • 
+        The Hello,
+        Testing tutorial introduces basic testing concepts and procedures in the
+        context of the Hello, World application.
+    
      • 
+    
    • 
+        The Activity
+        Testing tutorial is an excellent follow-up to the Hello, Testing tutorial.
+        It guides you through a more complex testing scenario that you develop against a
+        more realistic activity-oriented application.
+    
      • 
+
    
diff --git a/docs/html/guide/topics/testing/index.jd b/docs/html/guide/topics/testing/index.jd
new file mode 100644
index 0000000000000..92ed5a703b9a6
--- /dev/null
+++ b/docs/html/guide/topics/testing/index.jd
@@ -0,0 +1,80 @@
+page.title=Testing
+@jd:body
+
    
+    The Android development environment includes an integrated testing framework that helps you
+    test all aspects of your application.
+
    
+
    Fundamentals
    
+
    
+    To start learning how to use the framework to create tests for your applications, please
+    read the topic 
+    Testing Fundamentals.
+
    
+
    Concepts
    
+
      
+    
    • 
+        Testing Tools describes the Eclipse with ADT and command-line tools you use to test
+        Android applications.
+    
      • 
+    
    • 
+        What to Test is an overview of the types of testing you should do. It focuses on testing
+        system-wide aspects of Android that can affect every component in your application.
+    
      • 
+    
    • 
+        
+        Activity Testing focuses on testing activities. It describes how instrumentation allows
+        you to control activities outside the normal application lifecycle. It also lists
+        activity-specific features you should test, and it provides tips for testing Android
+        user interfaces.
+    
      • 
+    
    • 
+        
+        Content Provider Testing focuses on testing content providers. It describes the
+        mock system objects you can use, provides tips for designing providers so that they
+        can be tested, and lists provider-specific features you should test.
+    
      • 
+    
    • 
+        
+        Service Testing focuses on testing services. It also lists service-specific features
+        you should test.
+    
      • 
+
    
+
    Procedures
    
+
+
    Tutorials
    
+
      
+    
    • 
+        The 
+        Hello, Testing tutorial introduces basic testing concepts and procedures.
+    
      • 
+    
    • 
+        For a more advanced tutorial, try
+        Activity Testing,
+        which guides you through a more complex testing scenario.
+    
      • 
+
    
+
    Samples
    
+
      
+    
    • 
+        Note Pad Provider
+        Test is a test package for the
+        Note Pad sample
+        application. It provides a simple example of unit testing
+        a {@link android.content.ContentProvider}.
+    
      • 
+    
    • 
+        The Alarm Service Test
+        is a test package for the Alarm
+        sample application. It provides a simple example of unit
+        testing a {@link android.app.Service}.
+    
      • 
+
    
diff --git a/docs/html/guide/topics/testing/service_testing.jd b/docs/html/guide/topics/testing/service_testing.jd
new file mode 100644
index 0000000000000..3979f3c8d6bfc
--- /dev/null
+++ b/docs/html/guide/topics/testing/service_testing.jd
@@ -0,0 +1,178 @@
+page.title=Service Testing
+@jd:body
+
+
    
+  
    
+  
    In this document
    
+  
      
+    
    1. 
+        Service Design and Testing
+    
      2. 
+    
    2. 
+        ServiceTestCase
+    
      3. 
+    
    3. 
+        Mock object classes
+    
      4. 
+    
    4. 
+        What to Test
+    
      5. 
+  
    
+  
    Key Classes
    
+    
      
+      
    1. {@link android.test.InstrumentationTestRunner}
      2. 
+      
    2. {@link android.test.ServiceTestCase}
      3. 
+      
    3. {@link android.test.mock.MockApplication}
      4. 
+      
    4. {@link android.test.RenamingDelegatingContext}
      5. 
+    
    
+  
    Related Tutorials
    
+    
      
+        
    1. 
+            
+            Hello, Testing
+        
      2. 
+        
    2. 
+            Activity Testing
+        
      3. 
+    
    
+  
    See Also
    
+      
      
+        
    1. 
+          
+          Testing in Eclipse, with ADT
+        
      2. 
+        
    2. 
+          
+          Testing in Other IDEs
+        
      3. 
+      
    
+  
    
+
    
+
    
+    Android provides a testing framework for Service objects that can run them in
+    isolation and provides mock objects. The test case class for Service objects is
+    {@link android.test.ServiceTestCase}. Since the Service class assumes that it is separate
+    from its clients, you can test a Service object without using instrumentation.
+
    
+
    
+    This document describes techniques for testing Service objects. If you aren't familiar with the
+    Service class, please read 
+    Application Fundamentals. If you aren't familiar with Android testing, please read
+    Testing Fundamentals,
+    the introduction to the Android testing and instrumentation framework.
+
    
+
    Service Design and Testing
    
+
    
+    When you design a Service, you should consider how your tests can examine the various states
+    of the Service lifecycle. If the lifecycle methods that start up your Service, such as
+    {@link android.app.Service#onCreate() onCreate()} or
+    {@link android.app.Service#onStartCommand(Intent, int, int) onStartCommand()} do not normally
+    set a global variable to indicate that they were successful, you may want to provide such a
+    variable for testing purposes.
+
    
+
    
+    Most other testing is facilitated by the methods in the {@link android.test.ServiceTestCase}
+    test case class. For example, the {@link android.test.ServiceTestCase#getService()} method
+    returns a handle to the Service under test, which you can test to confirm that the Service is
+    running even at the end of your tests.
+
    
+
    ServiceTestCase
    
+
    
+    {@link android.test.ServiceTestCase} extends the JUnit {@link junit.framework.TestCase} class
+    with with methods for testing application permissions and for controlling the application and
+    Service under test. It also provides mock application and Context objects that isolate your
+    test from the rest of the system.
+
    
+
    
+    {@link android.test.ServiceTestCase} defers initialization of the test environment until you
+    call {@link android.test.ServiceTestCase#startService(Intent) ServiceTestCase.startService()} or
+    {@link android.test.ServiceTestCase#bindService(Intent) ServiceTestCase.bindService()}. This
+    allows you to set up your test environment, particularly your mock objects, before the Service
+    is started.
+
    
+
    
+    Notice that the parameters to ServiceTestCase.bindService()are different from
+    those for Service.bindService(). For the ServiceTestCase version,
+    you only provide an Intent. Instead of returning a boolean,
+    ServiceTestCase.bindService() returns an object that subclasses
+    {@link android.os.IBinder}.
+
    
+
    
+    The {@link android.test.ServiceTestCase#setUp()} method for {@link android.test.ServiceTestCase}
+    is called before each test. It sets up the test fixture by making a copy of the current system
+    Context before any test methods touch it. You can retrieve this Context by calling
+    {@link android.test.ServiceTestCase#getSystemContext()}. If you override this method, you must
+    call super.setUp() as the first statement in the override.
+
    
+
    
+    The methods {@link android.test.ServiceTestCase#setApplication(Application) setApplication()}
+    and {@link android.test.AndroidTestCase#setContext(Context)} setContext()} allow you to set
+    a mock Context or mock Application (or both) for the Service, before you start it. These mock
+    objects are described in Mock object classes.
+
    
+
    
+    By default, {@link android.test.ServiceTestCase} runs the test method
+    {@link android.test.AndroidTestCase#testAndroidTestCaseSetupProperly()}, which asserts that
+    the base test case class successfully set up a Context before running.
+
    
+
    Mock object classes
    
+
    
+    ServiceTestCase assumes that you will use a mock Context or mock Application
+    (or both) for the test environment. These objects isolate the test environment from the
+    rest of the system. If you don't provide your own instances of these objects before you
+    start the Service, then {@link android.test.ServiceTestCase} will create its own internal
+    instances and inject them into the Service. You can override this behavior by creating and
+    injecting your own instances before starting the Service
+
    
+
    
+    To inject a mock Application object into the Service under test, first create a subclass of
+    {@link android.test.mock.MockApplication}. MockApplication is a subclass of
+    {@link android.app.Application} in which all the methods throw an Exception, so to use it
+    effectively you subclass it and override the methods you need. You then inject it into the
+    Service with the
+    {@link android.test.ServiceTestCase#setApplication(Application) setApplication()} method.
+    This mock object allows you to control the application values that the Service sees, and
+    isolates it from the real system. In addition, any hidden dependencies your Service has on
+    its application reveal themselves as exceptions when you run the test.
+
    
+
    
+    You inject a mock Context into the Service under test with the
+    {@link android.test.AndroidTestCase#setContext(Context) setContext()} method. The mock
+    Context classes you can use are described in more detail in
+    
+    Testing Fundamentals.
+
    
+
    What to Test
    
+
    
+    The topic What To Test
+    lists general considerations for testing Android components.
+    Here are some specific guidelines for testing a Service:
+
    
+
      
+    
    • 
+        Ensure that the {@link android.app.Service#onCreate()} is called in response to
+        {@link android.content.Context#startService(Intent) Context.startService()} or
+    {@link android.content.Context#bindService(Intent,ServiceConnection,int) Context.bindService()}.
+        Similarly, you should ensure that {@link android.app.Service#onDestroy()} is called in
+        response to {@link android.content.Context#stopService(Intent) Context.stopService()},
+        {@link android.content.Context#unbindService(ServiceConnection) Context.unbindService()},
+        {@link android.app.Service#stopSelf()}, or
+        {@link android.app.Service#stopSelfResult(int) stopSelfResult()}.
+    
      • 
+    
    • 
+        Test that your Service correctly handles multiple calls from
+        Context.startService(). Only the first call triggers
+        Service.onCreate(), but all calls trigger a call to
+        Service.onStartCommand().
+        
      
+            In addition, remember that startService() calls don't
+            nest, so a single call to Context.stopService() or
+            Service.stopSelf() (but not stopSelf(int))
+            will stop the Service. You should test that your Service stops at the correct point.
+        
      
+    
      • 
+    
    • 
+        Test any business logic that your Service implements. Business logic includes checking for
+        invalid values, financial and arithmetic calculations, and so forth.
+    
      • 
+
    
diff --git a/docs/html/guide/topics/testing/testing_android.jd b/docs/html/guide/topics/testing/testing_android.jd
index 9ace1cbd872c2..513e4728d1239 100755
--- a/docs/html/guide/topics/testing/testing_android.jd
+++ b/docs/html/guide/topics/testing/testing_android.jd
@@ -1,4 +1,4 @@
-page.title=Testing and Instrumentation
+page.title=Testing Fundamentals
 @jd:body
 
 
    
@@ -6,60 +6,56 @@ page.title=Testing and Instrumentation
   
    In this document
    
   
      
     
    1. 
-        Overview
+        Test Structure
+    
      2. 
+    
    2. 
+        Test Projects
     
      3. 
     
    3. 
       The Testing API
       
        
         
      1. 
-          JUnit test case classes
+          JUnit
         
        2. 
         
      2. 
-          Instrumentation test case classes
+          Instrumentation
         
        3. 
         
      3. 
-          Assert classes
+            Test case classes
         
        4. 
         
      4. 
-          Mock object classes
+          Assertion classes
         
        5. 
         
      5. 
-          Instrumentation Test Runner
+          Mock object classes
         
        6. 
       
      
     
      4. 
     
    4. 
-     Working in the Test Environment
+        Running Tests
     
      5. 
     
    5. 
-        What to Test
+        Seeing Test Results
     
      6. 
     
    6. 
-      Appendix: UI Testing Notes
-      
        
-        
      1. 
-          Testing on the UI thread
-        
        2. 
-        
      2. 
-          Turning off touch mode
-        
        3. 
-        
      3. 
-          Unlocking the Emulator or Device
-        
        4. 
-        
      4. 
-          Troubleshooting UI tests
-        
        5. 
-      
      
+        Monkey and MonkeyRunner
+    
      7. 
+    
    7. 
+       Working With Package Names
+    
      8. 
+    
    8. 
+        What To Test
+    
      9. 
+    
    9. 
+        Next Steps
     
      10. 
   
    
-  
    Key Classes
    
+  
    Key Classes and Packages
    
     
      
       
    1. {@link android.test.InstrumentationTestRunner}
      2. 
-      
    2. {@link android.test.ActivityInstrumentationTestCase2}
      3. 
-      
    3. {@link android.test.ActivityUnitTestCase}
      4. 
-      
    4. {@link android.test.ApplicationTestCase}
      5. 
-      
    5. {@link android.test.ProviderTestCase2}
      6. 
-      
    6. {@link android.test.ServiceTestCase}
      7. 
+      
    7. {@link android.test}
      8. 
+      
    8. {@link android.test.mock}
      9. 
+      
    9. {@link junit.framework}
      10. 
     
    
   
    Related Tutorials
    
     
      
@@ -84,65 +80,546 @@ page.title=Testing and Instrumentation
    - -

    Android includes a powerful set of testing tools that extend the -industry-standard JUnit test framework with features specific to the Android -environment. Although you can test an Android application with JUnit, the -Android tools allow you to write much more sophisticated tests for every aspect -of your application, both at the unit and framework levels.

    - -

    Key features of the Android testing environment include:

    - - - -

    This document is an overview of the Android testing environment and the way -you use it. The document assumes you have a basic knowledge of Android -application programming and JUnit testing methodology.

    - -

    Overview

    - -

    At the heart of the Android testing environment is an instrumentation -framework that your test application uses to precisely control the application -under test. With instrumentation, you can set up mock system objects such as -Contexts before the main application starts, control your application at various -points of its lifecycle, send UI events to the application, and examine the -application's state during its execution. The instrumentation framework -accomplishes this by running both the main application and the test application -in the same process.

    - -

    Your test application is linked to the application under test by means of an - - <instrumentation> element in the test application's manifest file. - The attributes of the element specify the package name of the application under test and also - tell Android how to run the test application. Instrumentation is described in more detail - in the section Instrumentation Test Runner. -

    - -

    The following diagram summarizes the Android testing environment:

    - - -

    - In Android, test applications are themselves Android applications, so you - write them in much the same way as the application you are testing. The SDK - tools help you create a main application project and its test project at the same - time. You can run Android tests within Eclipse with ADT or from the command - line. Eclipse with ADT provides an extensive set of tools for creating tests, - running them, and viewing their results. You can also use the adb - tool to run tests, or use a built-in Ant target. + The Android testing framework, an integral part of the development environment, + provides an architecture and powerful tools that help you test every aspect of your application + at every level from unit to framework. +

    +

    + The testing framework has these key features: +

    + +

    + This document describes the fundamentals of the Android testing framework, including the + structure of tests, the APIs that you use to develop tests, and the tools that you use to run + tests and view results. The document assumes you have a basic knowledge of Android application + programming and JUnit testing methodology. +

    +

    + The following diagram summarizes the testing framework: +

    +
    + + The Android testing framework + +
    +

    Test Structure

    +

    + Android's build and test tools assume that test projects are organized into a standard + structure of tests, test case classes, test packages, and test projects. +

    +

    + Android testing is based on JUnit. In general, a JUnit test is a method whose + statements test a part of the application under test. You organize test methods into classes + called test cases (or test suites). Each test is an isolated test of an individual module in + the application under test. Each class is a container for related test methods, although it + often provides helper methods as well. +

    +

    + In JUnit, you build one or more test source files into a class file. Similarly, in Android you + use the SDK's build tools to build one or more test source files into class files in an + Android test package. In JUnit, you use a test runner to execute test classes. In Android, you + use test tools to load the test package and the application under test, and the tools then + execute an Android-specific test runner. +

    +

    Test Projects

    +

    + Tests, like Android applications, are organized into projects. +

    +

    + A test project is a directory or Eclipse project in which you create the source code, manifest + file, and other files for a test package. The Android SDK contains tools for Eclipse with ADT + and for the command line that create and update test projects for you. The tools create the + directories you use for source code and resources and the manifest file for the test package. + The command-line tools also create the Ant build files you need. +

    +

    + You should always use Android tools to create a test project. Among other benefits, + the tools: +

    + +

    + You can create a test project anywhere in your file system, but the best approach is to + add the test project so that its root directory tests/ is at the same level + as the src/ directory of the main application's project. This helps you find the + tests associated with an application. For example, if your application project's root directory + is MyProject, then you should use the following directory structure: +

    +
    +  MyProject/
+      AndroidManifest.xml
+      res/
+          ... (resources for main application)
+      src/
+          ... (source code for main application) ...
+      tests/
+          AndroidManifest.xml
+          res/
+              ... (resources for tests)
+          src/
+              ... (source code for tests)
+
    +

    The Testing API

    +

    + The Android testing API is based on the JUnit API and extended with a instrumentation + framework and Android-specific testing classes. +

    +

    JUnit

    +

    + You can use the JUnit {@link junit.framework.TestCase TestCase} class to do unit testing on + a plain Java object. TestCase is also the base class for + {@link android.test.AndroidTestCase}, which you can use to test Android-dependent objects. + Besides providing the JUnit framework, AndroidTestCase offers Android-specific setup, + teardown, and helper methods. +

    +

    + You use the JUnit {@link junit.framework.Assert} class to display test results. + The assert methods compare values you expect from a test to the actual results and + throw an exception if the comparison fails. Android also provides a class of assertions that + extend the possible types of comparisons, and another class of assertions for testing the UI. + These are described in more detail in the section + Assertion classes +

    +

    + To learn more about JUnit, you can read the documentation on the + junit.org home page. + Note that the Android testing API supports JUnit 3 code style, but not JUnit 4. Also, you must + use Android's instrumented test runner {@link android.test.InstrumentationTestRunner} to run + your test case classes. This test runner is described in the + section Running Tests. +

    +

    Instrumentation

    +

    + Android instrumentation is a set of control methods or "hooks" in the Android system. These hooks + control an Android component independently of its normal lifecycle. They also control how + Android loads applications. +

    +

    + Normally, an Android component runs in a lifecycle determined by the system. For example, an + Activity object's lifecycle starts when the Activity is activated by an Intent. The object's + onCreate() method is called, followed by onResume(). When the user + starts another application, the onPause() method is called. If the Activity + code calls the finish() method, the onDestroy() method is called. + The Android framework API does not provide a way for your code to invoke these callback + methods directly, but you can do so using instrumentation. +

    +

    + Also, the system runs all the components of an application into the same + process. You can allow some components, such as content providers, to run in a separate process, + but you can't force an application to run in the same process as another application that is + already running. +

    +

    + With Android instrumentation, though, you can invoke callback methods in your test code. + This allows you to run through the lifecycle of a component step by step, as if you were + debugging the component. The following test code snippet demonstrates how to use this to + test that an Activity saves and restores its state: +

    + +
    +    // Start the main activity of the application under test
+    mActivity = getActivity();
+
+    // Get a handle to the Activity object's main UI widget, a Spinner
+    mSpinner = (Spinner)mActivity.findViewById(com.android.example.spinner.R.id.Spinner01);
+
+    // Set the Spinner to a known position
+    mActivity.setSpinnerPosition(TEST_STATE_DESTROY_POSITION);
+
+    // Stop the activity - The onDestroy() method should save the state of the Spinner
+    mActivity.finish();
+
+    // Re-start the Activity - the onResume() method should restore the state of the Spinner
+    mActivity = getActivity();
+
+    // Get the Spinner's current position
+    int currentPosition = mActivity.getSpinnerPosition();
+
+    // Assert that the current position is the same as the starting position
+    assertEquals(TEST_STATE_DESTROY_POSITION, currentPosition);
+
    +

    + The key method used here is + {@link android.test.ActivityInstrumentationTestCase2#getActivity()}, which is a + part of the instrumentation API. The Activity under test is not started until you call this + method. You can set up the test fixture in advance, and then call this method to start the + Activity. +

    +

    + Also, instrumentation can load both a test package and the application under test into the + same process. Since the application components and their tests are in the same process, the + tests can invoke methods in the components, and modify and examine fields in the components. +

    +

    Test case classes

    +

    + Android provides several test case classes that extend {@link junit.framework.TestCase} and + {@link junit.framework.Assert} with Android-specific setup, teardown, and helper methods. +

    +

    AndroidTestCase

    +

    + A useful general test case class, especially if you are + just starting out with Android testing, is {@link android.test.AndroidTestCase}. It extends + both {@link junit.framework.TestCase} and {@link junit.framework.Assert}. It provides the + JUnit-standard setUp() and tearDown() methods, as well as well as + all of JUnit's Assert methods. In addition, it provides methods for testing permissions, and a + method that guards against memory leaks by clearing out certain class references. +

    +

    Component-specific test cases

    +

    + A key feature of the Android testing framework is its component-specific test case classes. + These address specific component testing needs with methods for fixture setup and + teardown and component lifecycle control. They also provide methods for setting up mock objects. + These classes are described in the component-specific testing topics: +

    + +

    + Android does not provide a separate test case class for BroadcastReceiver. Instead, test a + BroadcastReceiver by testing the component that sends it Intent objects, to verify that the + BroadcastReceiver responds correctly. +

    +

    ApplicationTestCase

    +

    + You use the {@link android.test.ApplicationTestCase} test case class to test the setup and + teardown of {@link android.app.Application} objects. These objects maintain the global state of + information that applies to all the components in an application package. The test case can + be useful in verifying that the <application> element in the manifest file is correctly + set up. Note, however, that this test case does not allow you to control testing of the + components within your application package. +

    +

    InstrumentationTestCase

    +

    + If you want to use instrumentation methods in a test case class, you must use + {@link android.test.InstrumentationTestCase} or one of its subclasses. The + {@link android.app.Activity} test cases extend this base class with other functionality that + assists in Activity testing.

    +

    Assertion classes

    +

    + Because Android test case classes extend JUnit, you can use assertion methods to display the + results of tests. An assertion method compares an actual value returned by a test to an + expected value, and throws an AssertionException if the comparison test fails. Using assertions + is more convenient than doing logging, and provides better test performance. +

    +

    + Besides the JUnit {@link junit.framework.Assert} class methods, the testing API also provides + the {@link android.test.MoreAsserts} and {@link android.test.ViewAsserts} classes: +

    + +

    Mock object classes

    +

    + To facilitate dependency injection in testing, Android provides classes that create mock system + objects such as {@link android.content.Context} objects, + {@link android.content.ContentProvider} objects, {@link android.content.ContentResolver} + objects, and {@link android.app.Service} objects. Some test cases also provide mock + {@link android.content.Intent} objects. You use these mocks both to isolate tests + from the rest of the system and to facilitate dependency injection for testing. These classes + are found in the Java packages {@link android.test} and {@link android.test.mock}. +

    +

    + Mock objects isolate tests from a running system by stubbing out or overriding + normal operations. For example, a {@link android.test.mock.MockContentResolver} + replaces the normal resolver framework with its own local framework, which is isolated + from the rest of the system. MockContentResolver also also stubs out the + {@link android.content.ContentResolver#notifyChange(Uri, ContentObserver, boolean)} method + so that observer objects outside the test environment are not accidentally triggered. +

    +

    + Mock object classes also facilitate dependency injection by providing a subclass of the + normal object that is non-functional except for overrides you define. For example, the + {@link android.test.mock.MockResources} object provides a subclass of + {@link android.content.res.Resources} in which all the methods throw Exceptions when called. + To use it, you override only those methods that must provide information. +

    +

    + These are the mock object classes available in Android: +

    +

    Simple mock object classes

    +

    + {@link android.test.mock.MockApplication}, {@link android.test.mock.MockContext}, + {@link android.test.mock.MockContentProvider}, {@link android.test.mock.MockCursor}, + {@link android.test.mock.MockDialogInterface}, {@link android.test.mock.MockPackageManager}, and + {@link android.test.mock.MockResources} provide a simple and useful mock strategy. They are + stubbed-out versions of the corresponding system object class, and all of their methods throw an + {@link java.lang.UnsupportedOperationException} exception if called. To use them, you override + the methods you need in order to provide mock dependencies. +

    +

    Note: + {@link android.test.mock.MockContentProvider} + and {@link android.test.mock.MockCursor} are new as of API level 8. +

    +

    Resolver mock objects

    +

    + {@link android.test.mock.MockContentResolver} provides isolated testing of content providers by + masking out the normal system resolver framework. Instead of looking in the system to find a + content provider given an authority string, MockContentResolver uses its own internal table. You + must explicitly add providers to this table using + {@link android.test.mock.MockContentResolver#addProvider(String,ContentProvider)}. +

    +

    + With this feature, you can associate a mock content provider with an authority. You can create + an instance of a real provider but use test data in it. You can even set the provider for an + authority to null. In effect, a MockContentResolver object isolates your test + from providers that contain real data. You can control the + function of the provider, and you can prevent your test from affecting real data. +

    +

    Contexts for testing

    +

    + Android provides two Context classes that are useful for testing: +

    + +

    Running Tests

    +

    + Test cases are run by a test runner class that loads the test case class, set ups, + runs, and tears down each test. An Android test runner must also be instrumented, so that + the system utility for starting applications can control how the test package + loads test cases and the application under test. You tell the Android platform + which instrumented test runner to use by setting a value in the test package's manifest file. +

    +

    + {@link android.test.InstrumentationTestRunner} is the primary Android test runner class. It + extends the JUnit test runner framework and is also instrumented. It can run any of the test + case classes provided by Android and supports all possible types of testing. +

    +

    + You specify InstrumentationTestRunner or a subclass in your test package's + manifest file, in the + instrumentation element. Also, InstrumentationTestRunner code resides + in the shared library android.test.runner, which is not normally linked to + Android code. To include it, you must specify it in a + uses-library element. + You do not have to set up these elements yourself. Both Eclipse with ADT and the + android command-line tool construct them automatically and add them to your + test package's manifest file. +

    +

    + Note: If you use a test runner other than + InstrumentationTestRunner, you must change the <instrumentation> + element to point to the class you want to use. +

    +

    + To run {@link android.test.InstrumentationTestRunner}, you use internal system classes called by + Android tools. When you run a test in Eclipse with ADT, the classes are called automatically. + When you run a test from the command line, you run these classes with + Android Debug Bridge (adb). +

    +

    + The system classes load and start the test package, kill any processes that + are running an instance of the application under test, and then load a new instance of the + application under test. They then pass control to + {@link android.test.InstrumentationTestRunner}, which runs + each test case class in the test package. You can also control which test cases and + methods are run using settings in Eclipse with ADT, or using flags with the command-line tools. +

    +

    + Neither the system classes nor {@link android.test.InstrumentationTestRunner} run + the application under test. Instead, the test case does this directly. It either calls methods + in the application under test, or it calls its own methods that trigger lifecycle events in + the application under test. The application is under the complete control of the test case, + which allows it to set up the test environment (the test fixture) before running a test. This + is demonstrated in the previous code snippet that tests an + Activity that displays a Spinner widget. +

    +

    + To learn more about running tests, please read the topics + + Testing in Eclipse, with ADT or + + Testing in Other IDes. +

    +

    Seeing Test Results

    +

    + The Android testing framework returns test results back to the tool that started the test. + If you run a test in Eclipse with ADT, the results are displayed in a new JUnit view pane. If + you run a test from the command line, the results are displayed in STDOUT. In + both cases, you see a test summary that displays the name of each test case and method that + was run. You also see all the assertion failures that occurred. These include pointers to the + line in the test code where the failure occurred. Assertion failures also list the expected + value and actual value. +

    +

    + The test results have a format that is specific to the IDE that you are using. The test + results format for Eclipse with ADT is described in + + Testing in Eclipse, with ADT. The test results format for tests run from the + command line is described in + + Testing in Other IDEs. +

    +

    Monkey and MonkeyRunner

    +

    + The SDK provides two tools for functional-level application testing: +

    + +

    Working With Package names

    +

    + In the test environment, you work with both Android application package names and + Java package identifiers. Both use the same naming format, but they represent substantially + different entities. You need to know the difference to set up your tests correctly. +

    +

    + An Android package name is a unique system name for a .apk file, set by the + "android:package" attribute of the <manifest> element in the package's + manifest. The Android package name of your test package must be different from the + Android package name of the application under test. By default, Android tools create the + test package name by appending ".test" to the package name of the application under test. +

    +

    + The test package also uses an Android package name to target the application package it + tests. This is set in the "android:targetPackage" attribute of the + <instrumentation> element in the test package's manifest. +

    +

    + A Java package identifier applies to a source file. This package name reflects the directory + path of the source file. It also affects the visibility of classes and members to each other. +

    +

    + Android tools that create test projects set up an Android test package name for you. + From your input, the tools set up the test package name and the target package name for the + application under test. For these tools to work, the application project must already exist. +

    +

    + By default, these tools set the Java package identifier for the test class to be the same + as the Android package identifier. You may want to change this if you want to expose + members in the application under test by giving them package visibility. If you do this, + change only the Java package identifier, not the Android package names, and change only the + test case source files. Do not change the Java package name of the generated + R.java class in your test package, because it will then conflict with the + R.java class in the application under test. Do not change the Android package name + of your test package to be the same as the application it tests, because then their names + will no longer be unique in the system. +

    +

    What to Test

    +

    + The topic What To Test + describes the key functionality you should test in an Android application, and the key + situations that might affect that functionality. +

    +

    + Most unit testing is specific to the Android component you are testing. + The topics Activity Testing, + + Content Provider Testing, and + Service Testing each have a section entitled "What To Test" that lists possible testing + areas. +

    +

    + When possible, you should run these tests on an actual device. If this is not possible, you can + use the Android Emulator with + Android Virtual Devices configured for + the hardware, screens, and versions you want to test. +

    +

    Next Steps

    To learn how to set up and run tests in Eclipse, please refer to Testing in @@ -150,12 +627,10 @@ in the same process.

    href="{@docRoot}guide/developing/testing/testing_otheride.html">Testing in Other IDEs.

    -

    If you want a step-by-step introduction to Android testing, try one of the - testing tutorials: + testing tutorials or sample test packages:

    - -

    The Testing API

    -

    - For writing tests and test applications in the Java programming language, Android provides a - testing API that is based in part on the JUnit test framework. Adding to that, Android includes - a powerful instrumentation framework that lets your tests access the state and runtime objects - of the application under tests. -

    -

    - The sections below describe the major components of the testing API available in Android. -

    -

    JUnit test case classes

    -

    - Some of the classes in the testing API extend the JUnit {@link junit.framework.TestCase TestCase} - but do not use the instrumentation framework. These classes contain methods for accessing system - objects such as the Context of the application under test. With this Context, you can look at its - resources, files, databases, and so forth. The base class is {@link android.test.AndroidTestCase}, - but you usually use a subclass associated with a particular component. -

    - The subclasses are: -

    - -

    Instrumentation test case classes

    -

    - The API for testing activities extends the JUnit {@link junit.framework.TestCase TestCase} class - and also uses the instrumentation framework. With instrumentation, Android can automate UI - testing by sending events to the application under test, precisely control the start of an - activity, and monitor the state of the activity during its life cycle. -

    -

    - The base class is {@link android.test.InstrumentationTestCase}. All of its subclasses have - the ability to send a keystroke or touch event to the UI of the application - under test. The subclasses can also inject a mock Intent. The subclasses are: -

    - -

    Assert classes

    -

    - Android also extends the JUnit {@link junit.framework.Assert} class that is the basis of - assert() calls in tests. There are two extensions to this class, - {@link android.test.MoreAsserts} and {@link android.test.ViewAsserts}: -

    - -

    Mock object classes

    -

    - Android has convenience classes for creating mock system objects such as applications, contexts, - content resolvers, and resources. Android also provides methods in some test classes for - creating mock Intents. Use these mocks to facilitate dependency injection, since they are - easier to use than creating their real counterparts. These convenience classes are found in - {@link android.test} and {@link android.test.mock}. They are: -

    - -

    Instrumentation Test Runner

    -

    - Android provides a custom class for running tests with instrumentation called called - {@link android.test.InstrumentationTestRunner}. This class - controls of the application under test, runs the test application and the main application in the - same process, and routes test output to the appropriate place. Using instrumentation is key to the - ability of InstrumentationTestRunner to control the entire test - environment at runtime. Notice that you use this test runner even if your test class does not - itself use instrumentation. -

    -

    - When you run a test application, you first run a system utility called Activity Manager. Activity - Manager uses the instrumentation framework to start and control the test runner, which in turn - uses instrumentation to shut down any running instances of the main application, starts the test - application, and then starts the main application in the same process. This allows various - aspects of the test application to work directly with the main application. -

    -

    - If you are developing in Eclipse, the ADT plugin assists you in the setup of - InstrumentationTestRunner or other test runners. The plugin UI prompts you to specify - the test runner class to use, as well as the package name of the application under test. - The plugin then adds an <instrumentation> element with appropriate attributes - to the manifest file of the test application. Eclipse with ADT automatically starts a test - application under the control of Activity Manager using instrumentation, and redirects the test - output to the Eclipse window's JUnit view. -

    -

    - If you prefer working from the command line, you can use Ant and the android - tool to help you set up your test projects. To run tests with instrumentation, you can access the - Activity Manager through the Android Debug - Bridge (adb) tool and the output is directed to STDOUT. -

    -

    Working in the Test Environment

    -

    - The tests for an Android application are contained in a test application, which itself is an - Android application. A test application resides in a separate Android project that has the - same files and directories as a regular Android application. The test project is linked to the - project of the application it tests (known as the application under test) by its manifest file. -

    -

    - Each test application contains one or more test case classes based on an Android class for a - particular type of component. The test case class contains methods that define tests on some - part of the application under test. When you run the test application, Android - starts it, loads the application under test into the same process, and then invokes each method - in the test case class. -

    -

    - The tools and procedures you use with testing depend on the development environment you are - using. If you use Eclipse, then the ADT plug in for Eclipse provides tools that allow you to - develop and run tests entirely within Eclipse. This is documented in the topic - - Testing in Eclipse, with ADT. If you use another development environment, then you use - Android's command-line tools, as documented in the topic - Testing in Other IDEs. -

    -

    Working with test projects

    -

    - To start testing an Android application, you create a test project for it using Android tools. - The tools create the project directory and the files and subdirectories needed. - The tools also create a manifest file that links the application in the test project to the - application under test. The procedure for creating a test project in Eclipse with ADT is - documented in - Testing in Eclipse, with ADT. The procedure for creating a test project for use with - development tools other than Eclipse is documented in - Testing in Other IDEs. -

    -

    Working with test case classes

    -

    - A test application contains one or more test case classes that extend an Android test case - class. You choose a test case class based on the type of Android component you are testing and - the tests you are doing. A test application can test different components, but each test case - class is designed to test a single type of component. The Android test case classes are - described in the section The Testing API. -

    -

    - Some Android components have more than one associated test case class. In this case, you choose - among the available classes based on the type of tests you want to do. For activities, for - example, you have the choice of either {@link android.test.ActivityInstrumentationTestCase2} or - {@link android.test.ActivityUnitTestCase}. -

    - ActivityInstrumentationTestCase2 is designed to do functional testing, so it tests - activities in a normal system infrastructure. You can inject mocked Intents, but not - mocked Contexts. In general, you can't mock dependencies for the activity under test. -

    -

    - In comparison, ActivityUnitTestCase is designed for unit testing, so it tests - activities in an isolated system infrastructure. You can inject mocked or wrappered - dependencies for the activity under test, particularly mocked Contexts. On the other hand, - when you use this test case class the activity under test runs in isolation and can't interact - with other activities. -

    -

    - As a rule of thumb, if you wanted to test an activity's interaction with the rest of Android, - you would use ActivityInstrumentationTestCase2. If you wanted to do regression - testing on an activity, you would use ActivityUnitTestCase. -

    -

    Working with test methods

    -

    - Each test case class provides methods that you use to set up the test environment and control - the application under test. For example, all test case classes provide the JUnit - {@link junit.framework.TestCase#setUp() setUp()} method that you can override to set up - fixtures. In addition, you add methods to the class to define individual tests. Each method you - add is run once each time you run the test application. If you override the setUp() - method, it runs before each of your methods. Similarly, the JUnit - {@link junit.framework.TestCase#tearDown() tearDown()} method is run once after each of - your methods. -

    -

    - The test case classes give you substantial control over starting and stopping components. For - this reason, you have to specifically tell Android to start a component before you run tests - against it. For example, you use the - {@link android.test.ActivityInstrumentationTestCase2#getActivity()} method to start the activity - under test. You can call this method once during the entire test case, or once for each test - method. You can even destroy the activity under test by calling its - {@link android.app.Activity#finish()} method and then restart it with - getActivity() within a single test method. -

    -

    Running tests and seeing the results

    -

    - To run your tests, you build your test project and then run the test application using the - system utility Activity Manager with instrumentation. You provide to Activity Manager the name - of the test runner (usually {@link android.test.InstrumentationTestRunner}) you specified for - your application; the name includes both your test application's package name and the test - runner class name. Activity Manager loads and starts your test application, kills any instances - of the application under test, loads an instance of the application under test into the same - process as the test application, and then passes control to the first test case class in your - test application. The test runner then takes control of the tests, running each of your test - methods against the application under test until all the methods in all the classes have been - run. -

    -

    - If you run a test within Eclipse with ADT, the output appears in a new JUnit view pane. If you - run a test from the command line, the output goes to STDOUT. -

    -

    What to Test

    -

    - In addition to the functional areas you would normally test, here are some areas - of Android application testing that you should consider: -

    - -

    - When possible, you should run these tests on an actual device. If this is not possible, you can - use the Android Emulator with - Android Virtual Devices configured for - the hardware, screens, and versions you want to test. -

    -

    Appendix: UI Testing Notes

    -

    - The following sections have tips for testing the UI of your Android application, specifically - to help you handle actions that run in the UI thread, touch screen and keyboard events, and home - screen unlock during testing. -

    -

    Testing on the UI thread

    -

    - An application's activities run on the application's UI thread. Once the - UI is instantiated, for example in the activity's onCreate() method, then all - interactions with the UI must run in the UI thread. When you run the application normally, it - has access to the thread and does not have to do anything special. -

    -

    - This changes when you run tests against the application. With instrumentation-based classes, - you can invoke methods against the UI of the application under test. The other test classes - don't allow this. To run an entire test method on the UI thread, you can annotate the thread - with @UIThreadTest. Notice that this will run all of the method statements - on the UI thread. Methods that do not interact with the UI are not allowed; for example, you - can't invoke Instrumentation.waitForIdleSync(). -

    -

    - To run a subset of a test method on the UI thread, create an anonymous class of type - Runnable, put the statements you want in the run() method, and - instantiate a new instance of the class as a parameter to the method - appActivity.runOnUiThread(), where appActivity is - the instance of the app you are testing. -

    -

    - For example, this code instantiates an activity to test, requests focus (a UI action) for the - Spinner displayed by the activity, and then sends a key to it. Notice that the calls to - waitForIdleSync and sendKeys aren't allowed to run on the UI thread: -

    -
    -  private MyActivity mActivity; // MyActivity is the class name of the app under test
-  private Spinner mSpinner;
-
-  ...
-
-  protected void setUp() throws Exception {
-      super.setUp();
-      mInstrumentation = getInstrumentation();
-
-      mActivity = getActivity(); // get a references to the app under test
-
-      /*
-       * Get a reference to the main widget of the app under test, a Spinner
-       */
-      mSpinner = (Spinner) mActivity.findViewById(com.android.demo.myactivity.R.id.Spinner01);
-
-  ...
-
-  public void aTest() {
-      /*
-       * request focus for the Spinner, so that the test can send key events to it
-       * This request must be run on the UI thread. To do this, use the runOnUiThread method
-       * and pass it a Runnable that contains a call to requestFocus on the Spinner.
-       */
-      mActivity.runOnUiThread(new Runnable() {
-          public void run() {
-              mSpinner.requestFocus();
-          }
-      });
-
-      mInstrumentation.waitForIdleSync();
-
-      this.sendKeys(KeyEvent.KEYCODE_DPAD_CENTER);
-
    - -

    Turning off touch mode

    -

    - To control the emulator or a device with key events you send from your tests, you must turn off - touch mode. If you do not do this, the key events are ignored. -

    -

    - To turn off touch mode, you invoke - ActivityInstrumentationTestCase2.setActivityTouchMode(false) - before you call getActivity() to start the activity. You must invoke the - method in a test method that is not running on the UI thread. For this reason, you - can't invoke the touch mode method from a test method that is annotated with - @UIThread. Instead, invoke the touch mode method from setUp(). -

    -

    Unlocking the emulator or device

    -

    - You may find that UI tests don't work if the emulator's or device's home screen is disabled with - the keyguard pattern. This is because the application under test can't receive key events sent ' - by sendKeys(). The best way to avoid this is to start your emulator or device - first and then disable the keyguard for the home screen. -

    -

    - You can also explicitly disable the keyguard. To do this, - you need to add a permission in the manifest file (AndroidManifest.xml) and - then disable the keyguard in your application under test. Note, though, that you either have to - remove this before you publish your application, or you have to disable it programmatically in - the published app. -

    -

    - To add the the permission, add the element - <uses-permission android:name="android.permission.DISABLE_KEYGUARD"/> - as a child of the <manifest> element. To disable the KeyGuard, add the - following code to the onCreate() method of activities you intend to test: -

    -
    -  mKeyGuardManager = (KeyguardManager) getSystemService(KEYGUARD_SERVICE);
-  mLock = mKeyGuardManager.newKeyguardLock("activity_classname");
-  mLock.disableKeyguard();
-
    -

    where activity_classname is the class name of the activity.

    -

    Troubleshooting UI tests

    -

    - This section lists some of the common test failures you may encounter in UI testing, and their - causes: -

    -
    -
    WrongThreadException
    -
    -

    Problem:

    - For a failed test, the Failure Trace contains the following error message: - - android.view.ViewRoot$CalledFromWrongThreadException: Only the original thread that created - a view hierarchy can touch its views. - -

    Probable Cause:

    - This error is common if you tried to send UI events to the UI thread from outside the UI - thread. This commonly happens if you send UI events from the test application, but you don't - use the @UIThread annotation or the runOnUiThread() method. The - test method tried to interact with the UI outside the UI thread. -

    Suggested Resolution:

    - Run the interaction on the UI thread. Use a test class that provides instrumentation. See - the previous section Testing on the UI Thread - for more details. -
    -
    java.lang.RuntimeException
    -
    -

    Problem:

    - For a failed test, the Failure Trace contains the following error message: - - java.lang.RuntimeException: This method can not be called from the main application thread - -

    Probable Cause:

    - This error is common if your test method is annotated with @UiThreadTest but - then tries to do something outside the UI thread or tries to invoke - runOnUiThread(). -

    Suggested Resolution:

    - Remove the @UiThreadTest annotation, remove the runOnUiThread() - call, or re-factor your tests. -
    -
    - diff --git a/docs/html/guide/topics/testing/what_to_test.jd b/docs/html/guide/topics/testing/what_to_test.jd new file mode 100644 index 0000000000000..e13538ad139d8 --- /dev/null +++ b/docs/html/guide/topics/testing/what_to_test.jd @@ -0,0 +1,84 @@ +page.title=What To Test +@jd:body +

    + As you develop Android applications, knowing what to test is as important as knowing how to + test. This document lists some most common Android-related situations that you should consider + when you test, even at the unit test level. This is not an exhaustive list, and you consult the + documentation for the features that you use for more ideas. The + android-developers Google Groups + site is another resource for information about testing. +

    +

    Ideas for Testing

    +

    + The following sections are organized by behaviors or situations that you should test. Each + section contains a scenario that further illustrates the situation and the test or tests you + should do. +

    +

    Change in orientation

    +

    + For devices that support multiple orientations, Android detects a change in orientation when + the user turns the device so that the display is "landscape" (long edge is horizontal) instead + of "portrait" (long edge is vertical). +

    +

    + When Android detects a change in orientation, its default behavior is to destroy and then + re-start the foreground Activity. You should consider testing the following: +

    + +

    Change in configuration

    +

    + A situation that is more general than a change in orientation is a change in the device's + configuration, such as a change in the availability of a keyboard or a change in system + language. +

    +

    + A change in configuration also triggers the default behavior of destroying and then restarting + the foreground Activity. Besides testing that the application maintains the UI and its + transaction state, you should also test that the application updates itself to respond + correctly to the new configuration. +

    +

    Battery life

    +

    + Mobile devices primarily run on battery power. A device has finite "battery budget", and when it + is gone, the device is useless until it is recharged. You need to write your application to + minimize battery usage, you need to test its battery performance, and you need to test the + methods that manage battery usage. +

    +

    + Techniques for minimizing battery usage were presented at the 2010 Google I/O conference in the + presentation + + Coding for Life -- Battery Life, That Is. This presentation describes the impact on battery + life of various operations, and the ways you can design your application to minimize these + impacts. When you code your application to reduce battery usage, you also write the + appropriate unit tests. +

    +

    Dependence on external resources

    +

    + If your application depends on network access, SMS, Bluetooth, or GPS, then you should + test what happens when the resource or resources are not available. +

    +

    + For example, if your application uses the network,it can notify the user if access is + unavailable, or disable network-related features, or do both. For GPS, it can switch to + IP-based location awareness. It can also wait for WiFi access before doing large data transfers, + since WiFi transfers maximize battery usage compared to transfers over 3G or EDGE. +

    +

    + You can use the emulator to test network access and bandwidth. To learn more, please see + Network Speed Emulation. + To test GPS, you can use the emulator console and {@link android.location.LocationManager}. To + learn more about the emulator console, please see + + Using the Emulator Console. +

    diff --git a/docs/html/images/testing/android_test_framework.png b/docs/html/images/testing/android_test_framework.png index 6f80530021d749d43369c02201663142e218da43..459975c06c124072a6c76d7f13561621670d021f 100755 GIT binary patch literal 47368 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%0AH<*!cPPDZ$)>ttUR{_Yp= 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 X_6+LhqpP4GKX2sKs;I_ECE)v{b@9h75 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 Jmn)e+`5(X-Ah`el literal 0 HcmV?d00001