1 page.title=Running Your App 2 parent.title=Building Your First App 3 parent.link=index.html 4 5 trainingnavtop=true 6 page.tags=emulator 7 8 @jd:body 9 10 11 <!-- This is the training bar --> 12 <div id="tb-wrapper"> 13 <div id="tb"> 14 15 <h2>This lesson teaches you to</h2> 16 17 <ol> 18 <li><a href="#RealDevice">Run on a Real Device</a></li> 19 <li><a href="#Emulator">Run on an Emulator</a></li> 20 </ol> 21 22 <h2>You should also read</h2> 23 24 <ul> 25 <li><a href="{@docRoot}tools/device.html">Using Hardware Devices</a></li> 26 <li><a href="{@docRoot}tools/devices/managing-avds.html">Managing AVDs with AVD Manager</a></li> 27 </ul> 28 29 30 </div> 31 </div> 32 33 34 <p>In the <a href="creating-project.html">previous lesson</a>, you created an 35 Android project that displays "Hello World." You can now run the app on a real 36 device or on an emulator. If you don't have a real device available, skip to 37 <a href="#Emulator">Run on an Emulator</a>.</p> 38 39 40 <h2 id="RealDevice">Run on a Real Device</h2> 41 42 <p>Set up your device as follows:</p> 43 44 <ol> 45 <li>Connect your device to your development machine with a USB cable. 46 If you're developing on Windows, you might need to install the appropriate USB driver for your 47 device. For help installing drivers, see the <a href="{@docRoot}studio/run/oem-usb.html">OEM 48 USB Drivers</a> document.</li> 49 <li>Enable <strong>USB debugging</strong> on your device by going to 50 <strong>Settings > Developer options</strong>. 51 <p class="note"><strong>Note:</strong> On Android 4.2 and newer, <strong>Developer 52 options</strong> is hidden by default. To make it available, go 53 to <strong>Settings > About phone</strong> and tap <strong>Build number</strong> 54 seven times. Return to the previous screen to find <strong>Developer options</strong>.</p> 55 </li> 56 </ol> 57 58 <p>Run the app from Android Studio as follows:</p> 59 60 <ol> 61 <li>In Android Studio, select your project and click 62 <strong>Run</strong> <img src="{@docRoot}images/tools/as-run.png" 63 style="vertical-align:baseline;margin:0; max-height:1em" /> 64 from the toolbar.</li> 65 <li>In the <strong>Select Deployment Target</strong> window, 66 select your device, and click <strong>OK</strong>.</li> 67 </ol> 68 <p>Android Studio installs the app on your connected device and starts it.</p> 69 70 71 <h2 id="Emulator">Run on an Emulator</h2> 72 73 <p>Before you run your app on an emulator, you need to create an 74 <a href="{@docRoot}tools/devices/index.html">Android Virtual Device</a> (AVD) 75 definition. An AVD definition defines the characteristics of an Android phone, 76 tablet, Android Wear, or Android TV device that you want to simulate in the 77 Android Emulator.</p> 78 79 <p>Create an AVD Definition as follows:</p> 80 <ol> 81 <li>Launch the Android Virtual Device Manager by selecting 82 <strong>Tools > Android > AVD Manager</strong>, or by clicking 83 the AVD Manager icon <img src="{@docRoot}images/tools/avd-manager-studio.png" 84 style="vertical-align:bottom;margin:0;height:19px"> in the toolbar.</li> 85 <li>In the <b>Your Virtual Devices</b> screen, click <strong>Create Virtual Device</strong>.</li> 86 <li>In the <b>Select Hardware</b> screen, select a phone device, such as Nexus 6, 87 and then click <strong>Next</strong>. 88 </li> 89 <li>In the <b>System Image</b> screen, choose the desired system image for the AVD and 90 click <strong>Next</strong>. 91 <p>If you don't have a particular system image installed, 92 you can get it by clicking the <b>download</b> link.</p> 93 </li> 94 <li>Verify the configuration settings (for your first AVD, leave all the 95 settings as they are), and then click <strong>Finish</strong>. 96 </li> 97 </ol> 98 99 <p>For more information about using AVDs, see 100 <a href="{@docRoot}studio/run/managing-avds.html">Create and Manage Virtual Devices</a>.</p> 101 102 <p>Run the app from Android Studio as follows:</p> 103 <ol> 104 <li>In <strong>Android Studio</strong>, select your project and click 105 <strong>Run</strong> <img src="{@docRoot}images/tools/as-run.png" 106 style="vertical-align:baseline;margin:0; max-height:1em" /> 107 from the toolbar.</li> 108 <li>In the <strong>Select Deployment Target</strong> window, 109 select your emulator and click <strong>OK</strong>.</li> 110 </ol> 111 <p>It can take a few minutes for the emulator to start. You may have to unlock the screen. 112 When you do, <em>My First App</em> appears on the emulator screen.</p> 113 114 115 <p>That's how you build and run your Android app on the emulator! 116 To start developing, continue to the <a href="building-ui.html">next 117 lesson</a>.</p>
