1page.title=Setting Up Your Test Environment 2trainingnavtop=true 3 4@jd:body 5 6<!-- This is the training bar --> 7<div id="tb-wrapper"> 8<div id="tb"> 9 10<h2>This lesson teaches you to</h2> 11<ol> 12 <li><a href="#eclipse">Set Up Eclipse for Testing</a></li> 13 <li><a href="#cmdline">Set Up the Command Line Interface for Testing</a></li> 14</ol> 15 16<h2>You should also read</h2> 17<ul> 18<li><a href="{@docRoot}sdk/index.html">Getting the SDK Bundle</a></li> 19<li><a href="{@docRoot}tools/testing/testing_eclipse.html">Testing from Eclipse 20with ADT</a></li> 21<li><a href="{@docRoot}tools/testing/testing_otheride.html">Testing from Other 22IDEs</a></li> 23</ul> 24 25<h2>Try it out</h2> 26<div class="download-box"> 27 <a href="http://developer.android.com/shareables/training/AndroidTestingFun.zip" 28class="button">Download the demo</a> 29 <p class="filename">AndroidTestingFun.zip</p> 30</div> 31 32</div> 33</div> 34 35<p>Before you start writing and running your tests, you should set up your test 36development environment. This lesson teaches you how to set up the Eclipse 37IDE to build and run tests, and how to 38build and run tests with the Gradle framework by using the command line 39interface.</p> 40 41<p class="note"><strong>Note:</strong> To help you get started, the lessons are 42based on Eclipse with the ADT plugin. However, for your own test development, you 43are free to use the IDE of your choice or the command-line.</p> 44 45<h2 id="eclipse">Set Up Eclipse for Testing</h2> 46<p>Eclipse with the Android Developer Tools (ADT) plugin provides an integrated 47development environment for you to create, build, and run Android application 48test cases from a graphical user interface (GUI). A convenient feature that 49Eclipse provides is the ability to auto-generate a new test project that 50corresponds with your Android application project</a>. 51 52<p>To set up your test environment in Eclipse:</p> 53 54<ol> 55<li><a href="{@docRoot}sdk/installing/bundle.html">Download and install the 56Eclipse ADT plugin</a>, if you haven’t installed it yet.</li> 57<li>Import or create the Android application project that you want to test 58against.</li> 59<li>Generate a test project that corresponds to the application project under 60test. To generate a test project for the app project that you imported:</p> 61 <ol type="a"> 62 <li>In the Package Explorer, right-click on your app project, then 63select <strong>Android Tools</strong> > <strong>New Test Project</strong>.</li> 64 <li>In the New Android Test Project wizard, set the property 65values for your test project then click <strong>Finish</strong>.</li> 66 </ol> 67</li> 68</ol> 69<p>You should now be able to create, build, and run test 70cases from your Eclipse environment. To learn how to perform these tasks in 71Eclipse, proceed to <a href="activity-basic-testing.html">Creating and Running 72a Test Case</a>.</p> 73 74<h2 id="cmdline">Set Up the Command Line Interface for Testing</h2> 75<p>If you are using Gradle version 1.6 or higher as your build environment, you 76can build and run your Android application tests from the command line by using 77the Gradle Wrapper. Make sure that in your {@code gradle.build} file, the 78<a href={@docRoot}guide/topics/manifest/uses-sdk-element.html#min>minSdkVersion</a> 79attribute in the {@code defaultConfig} section is set to 8 or higher. You can 80refer to the sample {@code gradle.build} file that is 81included in the download bundle for this training class.</p> 82<p>To run your tests with the Gradle Wrapper:</p> 83<ol> 84 <li>Connect a physical Android device to your machine or launch the Android 85Emulator.</li> 86 <li>Run the following command from your project directory: 87 <pre>./gradlew build connectedCheck</pre> 88 </li> 89</ol> 90<p>To learn more about using Gradle for Android testing, see the 91<a href="//tools.android.com/tech-docs/new-build-system/user-guide#TOC-Testing">Gradle Plugin User Guide</a>.</p> 92<p>To learn more about using command line tools other than Gradle for test 93development, see 94<a href="{@docRoot}tools/testing/testing_otheride.html">Testing from Other IDEs</a>.</p> 95 96