summaryrefslogtreecommitdiff
path: root/src/help/studio_help/src/topics/u_avd-startup-options.dita
blob: 812697aa6ae4a5f8ff7b97e2a33a13197d020cb1 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE reference PUBLIC "-//OASIS//DTD DITA Reference//EN" "../dtd/reference.dtd">
<reference id="u_avd-startup-options" xml:lang="en-us">
  <title>Startup Options</title>
  <shortdesc>This dialog lets you specify options that are applied when you start the emulator.</shortdesc>
  <prolog>
    <metadata>
      <keywords>
        <!--<indexterm></indexterm>-->
      </keywords>
    </metadata>
  </prolog>
  <refbody>
    <section>
      <p>This dialog contains a number of tabs, each with a number of fields. Note that beneath the tabbed sections is a
        non-editable field that presents your selected options, command-line style, as they will be passed to the
        emulator when it is started. See <xref
          href="http://d.android.com/guide/developing/tools/emulator.html#startup-options" format="html"
          scope="external">http://d.android.com/guide/developing/tools/emulator.html#startup-options</xref> for all of
        the possible command-line arguments.</p>
    </section>
    <section>
      <title>User Interface tab</title>
      <simpletable>
        <strow>
          <stentry><uicontrol>Screen Resolution</uicontrol></stentry>
          <stentry>A DPI value that represents a scaling factor to be applied to the emulator window. This allows you to
            alter the emulator's screen resolution to match the screen size of an actual device. By default, this value
            is 165. Click the <uicontrol>Calculate</uicontrol> button to calculate screen resolution and scale values
            that result in a life-sized image given the screen size of the device being emulated (in inches) and your
            development computer's display size (in inches) or density (DPI).</stentry>
        </strow>
        <strow>
          <stentry><uicontrol>Scale</uicontrol></stentry>
          <stentry>A value ranging from 0.1 to 3.0 that represents the scaling factor to be applied to the emulator
            window. To specify the scale as a DPI value, include a suffix of "dpi". Click the <uicontrol
            >Calculate</uicontrol> button to calculate screen resolution and scale values that result in a life-sized
            image given the screen size of the device being emulated (in inches) and your development computer's display
            size (in inches) or density (DPI).</stentry>
        </strow>
        <strow>
          <stentry><uicontrol>Disable Boot Animation</uicontrol></stentry>
          <stentry>Speeds up the emulator startup by disabling the boot animation sequence.</stentry>
        </strow>
        <strow>
          <stentry><uicontrol>Don't show Emulator Skin</uicontrol></stentry>
          <stentry>Hides the "skin" that makes the emulated device look more like a specific handheld. Note that the
            skin includes the device keyboard (if the emulated device has a physical keyboard); hiding the skin makes
            this keyboard, along with any other physical controls presented by the emulated device, inaccessible. Also
            note that if you change this option on a running emulator, you will need to stop and restart the emulator
            for the option to take effect.</stentry>
        </strow>
      </simpletable>
    </section>
    <section>
      <title>Disk Images tab</title>
      <simpletable>
        <strow>
          <stentry><uicontrol>Cache</uicontrol></stentry>
          <stentry>The working cache partition image.</stentry>
        </strow>
        <strow>
          <stentry><uicontrol>User Data</uicontrol></stentry>
          <stentry>The working user-data disk image.</stentry>
        </strow>
        <strow>
          <stentry><uicontrol>Init User Data</uicontrol></stentry>
          <stentry>A file containing a user-data disk image that is copied to the working user-data disk image if the
              <uicontrol>Wipe User Data</uicontrol> option is selected. </stentry>
        </strow>
        <strow>
          <stentry><uicontrol>RAM</uicontrol></stentry>
          <stentry>A file that to be used as a RAM-disk image.</stentry>
        </strow>
        <strow>
          <stentry><uicontrol>SD Card</uicontrol></stentry>
          <stentry>An SD card image that will be used by the new AVD instance.</stentry>
        </strow>
        <strow>
          <stentry><uicontrol>Disable Cache Partition</uicontrol></stentry>
          <stentry>Controls whether or not the AVD uses a cache partition.</stentry>
        </strow>
        <strow>
          <stentry><uicontrol>Wipe User Data</uicontrol></stentry>
          <stentry>Select this option to reset the user-data disk image when the AVD starts up. If a disk image is
            provided in the <uicontrol>Init User Data</uicontrol> field, the contents of that file are copied to the
            working user-data disk image, rather than the emulator's default image.</stentry>
        </strow>
      </simpletable>
    </section>
    <section>
      <title>Network tab</title>
      <p>The fields on this tab control how the AVD accesses the Internet.</p>
      <simpletable>
        <strow>
          <stentry><uicontrol>DNS Server</uicontrol></stentry>
          <stentry>A comma-separated list of up to four DNS server names or IP addresses to be used by the
          AVD.</stentry>
        </strow>
        <strow>
          <stentry><uicontrol>Network Latency</uicontrol></stentry>
          <stentry>Emulates the network latency of various cellular network types, such as GPRS, EDGE, or UMTS.
          </stentry>
        </strow>
        <strow>
          <stentry><uicontrol>Network Speed</uicontrol></stentry>
          <stentry>Throttles the networking speed to simulate that of a cellular network. Use this field to specify the
            desired network type.</stentry>
        </strow>
        <strow>
          <stentry><uicontrol>Port Number</uicontrol></stentry>
          <stentry>The console port number for this emulator instance. This should be an even integer value that ranges
            from 5554 to 5584.</stentry>
        </strow>
        <strow>
          <stentry><uicontrol>Max Network Speed/Min Network Latency</uicontrol></stentry>
          <stentry>Indicates that network operations should proceed at full speed, with no latency.</stentry>
        </strow>
      </simpletable>
    </section>
    <section>
      <title>System tab</title>
      <simpletable>
        <strow>
          <stentry><uicontrol>CPU Delay</uicontrol></stentry>
          <stentry>Allows you to emulate a slow CPU. Supply a value from 0 (no delay) to 1000 (maximum delay). Note that
            these integer values simply indicate a relative degree of delay and do not represent any actual amount of
            time. </stentry>
        </strow>
        <strow>
          <stentry><uicontrol>Redirect GPS</uicontrol></stentry>
          <stentry>Emulates an NMEA-compatible GPS device that is connected to an external character device or socket.
            For information on the format of this field, see the description of the -serial option in the QEMU user
            documentation, which can be found at <xref href="http://www.nongnu.org/qemu/qemu-doc.html" format="html"
              scope="external">http://www.nongnu.org/qemu/qemu-doc.html</xref>.</stentry>
        </strow>
        <strow>
          <stentry><uicontrol>Disable JNI checks</uicontrol></stentry>
          <stentry>Disables JNI checks in the Dalvik runtime.</stentry>
        </strow>
      </simpletable>
    </section>
    <section>
      <title>Others tab</title>
      <simpletable>
        <strow>
          <stentry><uicontrol>Other Startup Options</uicontrol></stentry>
          <stentry>Use this field to enter any other startup options not available from the other tabs. Enter the
            startup options as documented in the Android developer documentation at <xref
              href="http://d.android.com/guide/developing/tools/emulator.html#startup-options" format="html"
              scope="external"
          >http://d.android.com/guide/developing/tools/emulator.html#startup-options</xref>.</stentry>
        </strow>
      </simpletable>
    </section>
  </refbody>
</reference>