• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1page.title=Managing AVDs with AVD Manager
2parent.title=Managing Virtual Devices
3parent.link=index.html
4@jd:body
5
6  <div id="qv-wrapper">
7    <div id="qv">
8      <h2>In this document</h2>
9
10      <ol>
11        <li><a href="#createavd">Creating an AVD</a>
12          <ol>
13            <li><a href="#hardwareopts">Hardware options</a></li>
14          </ol>
15        </li>
16      </ol>
17    </div>
18  </div>
19
20  <p>The AVD Manager is an easy to use user interface to manage your AVD (Android Virtual Device)
21  configurations. An AVD is a device configuration for the Android emulator that allows you to
22  model different configurations of Android-powered devices. When you start the AVD Manager in Eclipse
23  or run the <code>android</code> tool on the command line, you will see the AVD Manager as shown in
24  figure 1:</p>
25
26  <img src="{@docRoot}images/avd-manager.png">
27
28  <p class="img-caption"><strong>Figure 1. </strong>Screenshot of the AVD Manager. </p>
29
30  <p>From the main screen, you can create, delete, repair and start AVDs as well as see the details
31  of each AVD. </p>
32
33
34  <h2 id="createavd">Creating an AVD</h2>
35
36  <p>You can create as many AVDs as you would like to test on. It is recommended that you test your
37  applications on all API levels higher than the target API level for your application.</p>
38
39  <p>To create an AVD:</p>
40
41  <ol>
42    <li>Start the AVD Manager:
43
44      <ul>
45        <li>In Eclipse: select <strong>Window &gt; Android SDK and AVD Manager</strong>, or click
46        the Android SDK and AVD Manager icon in the Eclipse toolbar.</li>
47
48        <li>In other IDEs: Navigate to your SDK's <code>tools/</code> directory and execute the
49        <code>android</code> tool with no arguments.</li>
50      </ul>
51    </li>
52
53    <li><p>In the <em>Virtual Devices</em> panel, you'll see a list of existing AVDs. Click
54    <strong>New</strong> to create a new AVD. The <strong>Create New AVD</strong> dialog appears.</p>
55
56      <img src="{@docRoot}images/developing/avd-dialog.png" alt="AVD Dialog">
57      <p class="img-caption"><strong>Figure 2.</strong> Screenshot of the Create AVD window</p>
58    </li>
59
60    <li>Fill in the details for the AVD.
61
62      <p>Give it a name, a platform target, an SD card size, and a skin (HVGA is default). You can
63      also add specific hardware features of the emulated device by clicking the
64      <strong>New...</strong> button and selecting the feature. For a list of hardware features,
65      see <a href="#hardwareopts">Hardware options</a>.</p>
66
67      <p class="note"><strong>Note:</strong> Be sure to define a target for your AVD that satisfies
68      your application's Build Target (the AVD platform target must have an API Level equal to or
69      greater than the API Level that your application compiles against).</p>
70    </li>
71
72    <li>Click <strong>Create AVD</strong>.</li>
73  </ol>
74
75  <p>Your AVD is now ready and you can either close the SDK and AVD Manager, create more AVDs, or
76  launch an emulator with the AVD by selecting a device and clicking <strong>Start</strong>.</p>
77
78<h3 id="hardwareopts">Hardware options</h3>
79<p>If you are creating a new AVD, you can specify the following hardware options for the AVD
80to emulate:</p>
81
82  <table>
83    <tr>
84      <th>Characteristic</th>
85
86      <th>Description</th>
87
88      <th>Property</th>
89    </tr>
90
91    <tr>
92      <td>Device ram size</td>
93
94      <td>The amount of physical RAM on the device, in megabytes. Default value is "96".</td>
95
96      <td>hw.ramSize</td>
97    </tr>
98
99    <tr>
100      <td>Touch-screen support</td>
101
102      <td>Whether there is a touch screen or not on the device. Default value is "yes".</td>
103
104      <td>hw.touchScreen</td>
105    </tr>
106
107    <tr>
108      <td>Trackball support</td>
109
110      <td>Whether there is a trackball on the device. Default value is "yes".</td>
111
112      <td>hw.trackBall</td>
113    </tr>
114
115    <tr>
116      <td>Keyboard support</td>
117
118      <td>Whether the device has a QWERTY keyboard. Default value is "yes".</td>
119
120      <td>hw.keyboard</td>
121    </tr>
122
123    <tr>
124      <td>DPad support</td>
125
126      <td>Whether the device has DPad keys. Default value is "yes".</td>
127
128      <td>hw.dPad</td>
129    </tr>
130
131    <tr>
132      <td>GSM modem support</td>
133
134      <td>Whether there is a GSM modem in the device. Default value is "yes".</td>
135
136      <td>hw.gsmModem</td>
137    </tr>
138
139    <tr>
140      <td>Camera support</td>
141
142      <td>Whether the device has a camera. Default value is "no".</td>
143
144      <td>hw.camera</td>
145    </tr>
146
147    <tr>
148      <td>Maximum horizontal camera pixels</td>
149
150      <td>Default value is "640".</td>
151
152      <td>hw.camera.maxHorizontalPixels</td>
153    </tr>
154
155    <tr>
156      <td>Maximum vertical camera pixels</td>
157
158      <td>Default value is "480".</td>
159
160      <td>hw.camera.maxVerticalPixels</td>
161    </tr>
162
163    <tr>
164      <td>GPS support</td>
165
166      <td>Whether there is a GPS in the device. Default value is "yes".</td>
167
168      <td>hw.gps</td>
169    </tr>
170
171    <tr>
172      <td>Battery support</td>
173
174      <td>Whether the device can run on a battery. Default value is "yes".</td>
175
176      <td>hw.battery</td>
177    </tr>
178
179    <tr>
180      <td>Accelerometer</td>
181
182      <td>Whether there is an accelerometer in the device. Default value is "yes".</td>
183
184      <td>hw.accelerometer</td>
185    </tr>
186
187    <tr>
188      <td>Audio recording support</td>
189
190      <td>Whether the device can record audio. Default value is "yes".</td>
191
192      <td>hw.audioInput</td>
193    </tr>
194
195    <tr>
196      <td>Audio playback support</td>
197
198      <td>Whether the device can play audio. Default value is "yes".</td>
199
200      <td>hw.audioOutput</td>
201    </tr>
202
203    <tr>
204      <td>SD Card support</td>
205
206      <td>Whether the device supports insertion/removal of virtual SD Cards. Default value is
207      "yes".</td>
208
209      <td>hw.sdCard</td>
210    </tr>
211
212    <tr>
213      <td>Cache partition support</td>
214
215      <td>Whether we use a /cache partition on the device. Default value is "yes".</td>
216
217      <td>disk.cachePartition</td>
218    </tr>
219
220    <tr>
221      <td>Cache partition size</td>
222
223      <td>Default value is "66MB".</td>
224
225      <td>disk.cachePartition.size</td>
226    </tr>
227
228    <tr>
229      <td>Abstracted LCD density</td>
230
231      <td>Sets the generalized density characteristic used by the AVD's screen. Default value is
232      "160".</td>
233
234      <td>hw.lcd.density</td>
235    </tr>
236
237    <tr>
238      <td>Trackball support</td>
239
240      <td>Whether there is a trackball present.</td>
241
242      <td>hw.trackBall</td>
243    </tr>
244  </table>
245
246