blob: 5cb31d4601108689ceae9bf6fd951750290ad826 [file] [log] [blame]
Android Emulator changes:
=========================
Versions:
1.0 => SDK M3 release
1.1 => SDK M5 release
1.2 => Internal release (build 72264)
1.3 => Internal release (build 77780)
1.4 => Internal release (build 84853)
1.5 => SDK 0.9_r1
1.6 => SDK 1.0_r1
1.7 => SDK 1.0_r2
1.8 => SDK 1.1
1.9 => SDK 1.5_r1 (and SDK 1.5_r2)
1.10 => SDK 1.5_r3
1.11 => SDK 1.6_r1
1.12 => SDK 2.0
1.13 => SDK 2.0.1 (but wrongly tagged 1.12)
Starting from here, the emulator version number will match
the corresponding SDK Tools release level, i.e.:
5.0 => SDK Tools release 5
6.0 => SDK Tools release 6
7.0 => SDK Tools release 7
etc...
==============================================================================
Changes between 8.0 and 7.0
IMPORTANT CHANGES:
OTHER:
- The phone can now be called with additional numbers, using the 1-555-521
prefix. I.e. you can now use all of the following numbers to call/sms an
emulator that runs on console port 5554:
5554
521 5554
555 521 5554
1 555 521 5554
- Fix -http-proxy implementation to properly work with chunked encodings.
Also try to connect to the proxy on startup to see if the host/port are
valid. If no connection succeeds after 1 second, dump a warning and
ignore the proxy for the session.
- The console's "geo fix" command was modified:
- a computational bug sent the wrong latitude/longitude to the emulated
system, resulting in coordinates that could be off from 500 to 1000 meters.
- fixed another bug that didn't report the altitude correctly.
- added a fourth, optional, parameter to indicate the number of tracked
satellites to emulate. The number must be an integer between 1 and 12,
(1 is the default).
- fixed a bug in parameter handling: the implementation disagreed with the
documentation, requiring an additional dummy fourth argument. Now four or
five parameters are accepted (for backwards compatibility), but the last is
always the satellite count.
- Add a PulseAudio audio backend on Linux. It will be used by default
unless it's impossible to connect to the PA daemon.
- It is now possible to access the QEMU monitor from the console.
Just type "qemu monitor" and you will be at the monitor prompt.
Note that the monitor 'quit' command will not stop the emulator,
but will simply close the connection instead.
==============================================================================
Changes between 7.0 and 6.0
IMPORTANT CHANGES:
OTHER:
- Removed audio stack SDL dependency.
- Add a '-shared-net-id' option which allows emulators to join a shared network.
This allows testing situations where emulators need to communicate directly
with each other. See '-help-shared-net-id' for more details.
- Fix net shaping regression: -netspeed and -netdelay did not work anymore.
==============================================================================
Changes between 6.0 and 5.0
IMPORTANT CHANGES:
- Add a '-memcheck' option to instrument memory reads/writes at runtime in
order to detect buffer under/overflows. This requires a new version of the
C library that is only available in Froyo and above.
- Fix '-http-proxy' on Win32. This was actually a regression introduced
with the Donut SDK.
OTHER:
- Add a '--static' option to both android-configure.sh and android-rebuild.sh
in order to build a completely static executable. This is required to run
the emulator in restricted environments. No audio and graphics in this mode
so using '-no-window' is required.
==============================================================================
Changes between 5.0 and 1.13
IMPORTANT CHANGES:
- Starting from this release, the emulator's version number will match the
corresponding Android SDK Tools package revision number. The exact number
is extracted at build time from the Android source tree.
The minor number will now be stuck to 0 since each official emulator
release is supposed to match a corresponding SDK Tools release.
OTHER:
- Fixed a bug that crashed the emulator when the SD Card image size was exactly
8 MB. Now, the minimum supported size is 9 MB, and the emulator will complain
with a human-friendly message if this is not the case, and ignore the SD Card
file.
==============================================================================
Changes between 1.13 and 1.12
IMPORTANT BUG FIXES:
- Fix D-Pad rotation issues in the skins. The problem being that switching
the emulator window to landscape mode resulted in incorrectly rotated
D-Pad events. The fix allows for a new 'dpad-rotation' field for each
layout.
- Fixed a bug in Thumb2 emulation (not used by typical SDK images yet though)
that resulted incorrect behaviour / crashes, especially in single-stepping
mode.
==============================================================================
Changes between 1.12 and 1.11
IMPORTANT BUG FIXES:
- Fixed a nasty race condition in the Linux EsounD audio backend which resulted
in rare lockups when stopping the emulator on this platform.
- The key-bindings for the Menu button (F2 and PageUp by default) didn't work
due to a typo.
OTHER:
- Sources have been refreshed by a large integration of upstream QEMU
sources (version 0.10.50). The integration is based on the following commit,
dated 2009-06-19:
d2e9fd8f703203c2eeeed120b1ef6c3a6574e0ab
==============================================================================
Changes between 1.11 and 1.10
IMPORTANT BUG FIXES:
- Fixed ANDROID_SDK_HOME being ignored on Unix (not Windows). This environment
variable is used to locate a user's configuration files for the SDK, with a
default value of ~/.android
OTHER:
- Add "KEY_XXX" name alias for EV_KEY codes. This means that the console
command "event codes EV_KEY" will now return KEY_XXX code names (in addition
to BTN_YYY ones), and that you can use "event send EV_KEY:KEY_SOFT1:1"
instead of "event send EV_KEY:229:1" to simulate the press of the Menu
button.
The KEY_XXX values are defined by Linux. The following Android-specific
mappings apply:
KEY_HOME => Home key
KEY_BACK => Back key
KEY_SEND => Call key (e.g. Green Phone)
KEY_END => EndCall key (e.g. Red Phone)
KEY_SOFT1 => Menu key
KEY_VOLUME_UP
KEY_VOLUME_DOWN
KEY_SEARCH => Search key (if any)
KEY_POWER => Power button
KEY_CAMERA => Camera button
KEY_DOWN / UP / LEFT / RIGHT => DPad keys
KEY_CENTER => DPad / trackball click
Beware: KEY_MENU does *not* correspond to the "Menu" key of most Android
devices.
==============================================================================
Changes between 1.10 and 1.9
IMPORTANT BUG FIXES:
- Fixed sock_address_init_resolve() in sockets.c to work properly on
IPv6 capable systems, when the list returned by getaddrinfo() doesn't
necessarily reflect the simplistic heuristics that were used by the
previous implementation. On such systems, inter-emulator telephony
and SMS didn't work properly, as well as certain other network-related
tasks.
IMPORTANT CHANGES:
- Skins can now provide a button for the "SEARCH" scan-code, simply using
the "search" label for it.
- A new option '-prop <name>=<value>' can be used to set a system property
at boot time in the emulated system. This only works for system images
starting at 1.5_r3, and will be ignored for older ones.
Note that properties starting with "ro." can only be set once. Moreover,
all system properties in the system build.prop or local.prop are parsed
by init before anything else. Any "ro." property in them cannot be
changed with this option.
- Allow the HTTP proxy implementation to receive chunked encoding data.
This shall solve problems when talking to Microsoft proxies.
OTHER:
- Allow the SEARCH key-binding (F5) to work on keyboard-less hardware
configurations (AVDs).
- Fixed a typo which prevented the kernel gdbstub from working properly
- Fixed bad QADD/QDADD/QSUB/QDSUB emulation in the ARM JIT.
- Fixed one minor crash when the Linux OSS audio backend was used with the
-debug-audio option.
- Fixed emulator tracing bug (basic block address could be wrong). And add
support for recording native (JNI) calls when profiling.
- Fixed build for platforms where deprecated symbol EAI_NODATA is not
defined.
- Fix GPS emulation to allow several clients concurrently. There are still
problems that may be due to changes in the system's framework.
- Added some technical documentation in the docs/ directory.
==============================================================================
Changes between 1.9 and 1.8
IMPORTANT CHANGES:
- Many features have been integrated from upstream QEMU sources, including
the new TCG code generator used by the ARM translator. This should result
in slightly faster execution speed on all supported platforms. Another
benefit is that you no longer require a specific (and obsolete) version
of GCC to build the emulator.
- The emulator now requires that you specify a virtual device name when
starting the emulator, prefixed with the '@' sign. For example, to start
the 'foo' virtual device, type:
emulator @foo
Each AVD (Android Virtual Device) corresponds to a directory used to store
mutable disk images, an optional system image/kernel/sdcard, plus some
configuration file(s).
The command-line tool 'android' that comes with the SDK can be used to
create/list/remove virtual devices on your system.
Note that the '@<name>' form is a convenience shortcut for '-avd <name>'.
It is thus possible to place options after the AVD name on your command
line, as in:
emulator @foo -verbose -shell
Finally, when building the Android platform source tree, an AVD name is not
required and 'emulator' will start a new emulator instance exactly as
previously.
- A new option '-sysdir <dir>' has been introduced, the interpretation of
the '-system' option has changed, and '-image <file>' should now be
considered obsolete. In more details:
* you should now use '-sysdir <dir>' instead of '-system <dir>' to specify
the directory where system images will be searched by the emulator
on startup.
* you should now use '-system <file>' to indicate which system.img partition
image to use at startup.
* you should not use '-system <dir>' or '-image <path>' anymore. However,
these options are still supported but will print a warning to remind you
to change your scripts/habits.
The change was done to reduce confusion as to what these options provide.
- Options '-noaudio', '-nojni', '-noskin' and 'nocache' are deprecated.
You should use '-no-audio', '-no-jni', '-no-skin' and '-no-cache' instead.
- Option 'initdata' is deprecated, you should use '-init-data' instead.
- Hardware emulation is now limited to the corresponding Android Virtual
Device's configuration. This means it is now possible to not emulate
a touch-screen, trackball, dpad, keyboard, modem, etc...
Note that in the case of the Android build system, all hardware properties
are enabled by default, so this only affects "normal" virtual devices
created with the 'android' tool.
- The emulator now supports capturing network packets to a file.
You can either use the new -tcpdump <file> command-line option, or use
the new console 'network capture start <file>' command (then use
'network capture stop' to stop it).
This captures all ethernet packets on the virtual LAN, so this includes
ARP, UDP, TCP, etc... The file is in libpcap format and can be opened with
external tools like WireShark for analysis.
OTHER:
- The file in ~/.android/default.keyset was ignored, unless you used
'-keyset default' explicitely. It is now loaded automatically when
available.
- Environment variable ANDROID_SDK_ROOT can be used to specifiy the location
of the SDK installation path.
- Environment variable ANDROID_SDK_HOME can be used to specify the location
of the '.android' data directory (which defaults to your $HOME).
- A new console command 'avd name' can be used to query the name of the
virtual device running in the emulator. Note that it will be '<build>'
if you run from the Android build system.
Also, the emulator's window title also displays the AVD name now.
- The option '-memory <size>' has been added. <memory> must be an integer
specifying the amount of physical RAM in the emulated device in megabytes.
The default value is 96.
- The '-skindir <path>' option now requires that you specify a '-skin <name>'
option as well.
- Better handling of Audio on Linux for the EsounD and Alsa backends
- Fullscreen toggle should now work on Windows and OS X. On Linux, the
toggle will not switch the display resolution anymore (which resulted
in distorted images).
- Using '-no-audio' no longer disables sound hardware emulation. It simply
mutes the emulator program on the host.
- The window title bar changes when you toggle persistent trackball mode
(F6 by default). It will display something like the following:
"Press F6 to exit trackball mode ..."
The actual text depends on your key binding configuration. This is to help
people toggle the mode by accident.
==============================================================================
Changes between 1.7 and 1.6
IMPORTANT BUG FIXES:
- Properly create ~/.android directory when needed.
- Do not leave temporary files in Android app-specific directory on Win32
- Support for HTTP/HTTPS proxies has been considerably improved and should now
"just work" with a lot more HTTP proxies. In case of problem, use the
-debug-proxy option to dump debugging data to stderr.
OTHER:
- Trackball emulation has changed. First, the awkward "Control-T" keybinding
is gone. Instead, you can now:
- press 'Delete' to show the trackball and have it disappear as soon
as your release the key.
- press 'F6' to perform a persistent trackball mode toggle.
Also, trackball emulation is fixed in rotated/landscape mode now.
- New option '-nand-limits <limits>' allows you to send a signal to a remote
process when a read or write threshold on flash storage is reached. This is
only useful for hardcore Android system hackers.
- Fix emulator build on recent Cygwin releases (the -mno-cygwin headers do not
tolerate the _GNU_SOURCE macro definition anymore)
- Fix Win32 emulator to support SD Card images larger than 2 GiB
- The non-Android build system has been completely rewritten to allow building
the emulator on Linux x86_64. Also, there is now a single Makefile that
drives the build in both Android and non-Android modes.
- '-qemu <other-options>' works again
==============================================================================
Changes between 1.6 and 1.5
IMPORTANT CHANGES:
- Emulator now saves the user image in <android>/SDK1.0/
OTHER:
- Get rid of EsounD-related freezes on Linux (again)
- Fix the documentation in -help-audio. '-audio list' doesn't work, one
needs to call -help-audio-out and -help-audio-in to get the list of valid
audio backends
- Fix scrollwheel Dpad emulation in rotated mode. before that, using the
scroll-wheel would always generated Dpad Up/Down events, even when in
landscape mode.
- Re-enable CPU fault emulation in case of unaligned data access. this was
previously disabled because it crashed the emulated kernel in previous
releases.
- The emulator no longer prints an obscure warning when it doesn't find
the emulator.cfg configuration file in ~/.android.
'broken configuration file doesn't have a 'window' element'
- Removed a bunch of obsolete options (e.g. -console, -adb-port, etc...)
- Setting the network speed through the console or the -netspeed option will
properly modify the connectivity icon on the device.
- Setting the GSM voice registration state to 'roaming' in the console will
properly modify the voice icon on the device
==============================================================================
Changes between 1.5 and 1.4
IMPORTANT BUG FIXES:
- Fix spurious discards of SMS messages when using two emulators.
OTHER:
- Get rid of EsounD-related freezes on Linux (again)
- Fix the documentation in -help-audio. '-audio list' doesn't work; one
needs to call -help-audio-out and -help-audio-in to get the list of valid
audio backends
- Fix scrollwheel Dpad emulation in rotated mode. before that, using the
scroll-wheel would always generated Dpad Up/Down events, even when in
landscape mode.
- Re-enable CPU fault emulation in case of unaligned data access. This was
previously disabled because it crashed the emulated kernel in previous
releases.
==============================================================================
Changes between 1.4 and 1.3
IMPORTANT BUG FIXES:
- fix for audio-related Linux startup freezes when using the 'esd' and 'alsa'
backends
- the number of audio buffers in the Windows backend has been incremented.
this gets rid of audio chopiness issues on Vista (and sometimes on XP too)
NEW FEATURES:
NEW CONSOLE COMMANDS:
- new 'geo fix <lontitude> <latitude> [<altitude>]' command allows you to
send a simple GPS fix to the emulated system, without the headaches of
NMEA 1083 formatting.
OTHER BUG FIXES:
- fixed the -audio, -audio-in and -audio-out options (the <backend> values
were sometimes ignored)
REGRESSIONS:
OTHER:
- the transitional '-qemud' option introduced in 1.3 is now gone. its
behaviour is now the default.
- use the new '-old-system' option if you need to use a 1.4+ emulator binary
with older system images. if you don't use it, GSM and GPS emulation will
not work correctly (among other things).
- the obsolete '-oldradio' option is now gone
- on some Unix systems, SIGALRM is blocked by default, so unblock it when
creating the alarm timer
- the 'esd' and 'alsa' libraries dump a lot of error messages to the console
by default on Linux. these are now disabled unless you use '-debug audio'
- added the '-help-char-devices' help topic that describe the specification
of the <device> parameter of options like -serial, -gps, -shell-serial,
etc...
KNOWN ISSUES:
- no support for video input
- no support for mutable SIM Card emulation yet
- no support for bluetooth
- no support for WiFi
- on some Linux machines, the emulator might get stuck at startup. this
seems to be related to audio input support. try starting with
'-audio-in none' or even '-noaudio' to disable sound, or choose a
different audio backend by defining QEMU_AUDIO_DRV to an appropriate
value (read below).
you can also select different audio backends for both output and input
by defining QEMU_AUDIO_OUT_DRV and QEMU_AUDIO_IN_DRV independently.
- on Windows, the emulator takes about 10-15% of the CPU even when the
emulated system is idle. this is a known issue related to QEMU's internal
event loop and Winsock. this should be fixed in a future emulator release.
- GPS emulation only if you use the '-qemud' option. this is an experimental
option that is soon going to be the default. without this option, the
emulated system will start but GPS emulation will not work.
for the record, 'qemud' is a serial port multiplexer that is used to
multiplex several communication channels between the emulator and the
emulated system, though a single serial port.
==============================================================================
Changes between 1.3 and 1.2
IMPORTANT BUG FIXES:
NEW FEATURES:
- '-audio-in <backend>' allows you to select the audio input backend from the
command line. this is equivalent to defining QEMU_AUDIO_IN_DRV=<backend>
'-audio-out <backend>' works for the audio output, and '-audio <backend>'
will select both input and output at the same time
- '-debug <tags>' has replaced the old '-verbose-<tag1> -verbose-<tag2> ...'
debugging option. <tags> is a comma-separated list of debug tags
(see -help-debug-tags for a complete list). you can also use the special
value 'all' to indicate all debug tags, or prefix a '-' before a tag
name to disable it. for example:
-debug all,-audio
enables all debugging except audio. '-debug-<tag>' still works though.
note that while '-verbose-<tag>' is deprecated, '-verbose' is still supported
as an alias to '-debug-init'
- '-keyset <file>' allows you to specific the keyset file to use. the default
is still ~/.android/default.keyset on Unix. for Windows, use -help-keyset
to get its default location (which differs between XP and Vista)
NEW CONSOLE COMMANDS:
- the 'geo nmea <sentence>' can be used to send a NMEA 1083 sentence as if
it came from an emulated GPS unit. NOTE: this doesn't work unless you
also use the '-qemud' option (see KNOWN ISSUES below)
OTHER BUG FIXES:
- severe color artefact issues when scaling the emulator window < 1.0 were
fixed.
- fix rare random emulator freezes on Linux by disabling the 'dynticks' timer.
REGRESSIONS:
OTHER:
- the ambiguous '-console' option is now obsolete. use '-shell' instead
- the new '-shell-serial <device>' allows you to specify a device to
connect a root shell session to the emulated system.
- the '-debug-kernel' option is now known as '-show-kernel' (the -debug-
prefix is reserved for strict emulator debugging features)
- '-adb-port' has been removed from the list of options. similarly
'-port <port>' will accept an odd port number, but will print a warning
that it is using <port>-1 instead.
- MMX is used on x86 to speed up window rescaling.
- a new '-qemud' option is required to have GPS support work in this
SDK (either through '-gps <device>' or the 'geo nmea <sentence>'
console command)
this option is purely experimental and will soon become the default.
KNOWN ISSUES:
- no support for video input
- no support for mutable SIM Card emulation yet
- no support for bluetooth
- no support for WiFi
- on some Linux machines, the emulator might get stuck at startup. this
seems to be related to audio input support. try starting with
'-audio-in none' or even '-noaudio' to disable sound, or choose a
different audio backend by defining QEMU_AUDIO_DRV to an appropriate
value (read below).
you can also select different audio backends for both output and input
by defining QEMU_AUDIO_OUT_DRV and QEMU_AUDIO_IN_DRV independently.
- on Windows, the emulator takes about 10-15% of the CPU even when the
emulated system is idle. this is a known issue related to QEMU's internal
event loop and Winsock. this should be fixed in a future emulator release.
- GPS emulation only if you use the '-qemud' option. this is an experimental
option that is soon going to be the default. without this option, the
emulated system will start but GPS emulation will not work.
for the record, 'qemud' is a serial port multiplexer that is used to
multiplex several communication channels between the emulator and the
emulated system, though a single serial port.
==============================================================================
Changes between 1.2 and 1.1
IMPORTANT BUG FIXES:
- fixed a typo that prevented the F9/F10 keyboard shortcuts from working
properly, making non-programatically tracing unusable.
- halve the emulator's memory requirements, saving around 130 megabytes
of memory by changing the way flash images are accessed (we now use
temporary files instead)
- this emulator binary should be 10% to 20% faster than previous ones on
the Windows and OS X platforms. for faster boots, you may also want to
use the -no-boot-anim option described below to speed up the initial
boot sequence as well on slow machines.
- proper rotation support when using Keypad 7/9 to switch between layouts
in the default HVGA skin. no need to use Ctrl-PageDown anymore
- the -http-proxy <proxy> option didn't work correctly on Windows (unless
you were very lucky).
- general socket handling code on Windows has been significantly improved.
NEW FEATURES:
- the console port number of a given emulator instance is now displayed in
its window's title bar.
- voice/sms are automatically forwarded to other emulator instances running
on the same machine, as long as you use their console port number as the
destination phone number.
for example, if you have two emulator running, the first one will usually
use console port 5554, and the second one will use port 5556
then dialing 5556 on the 1st emulator will generate an incoming call on
the 2nd emulator. you can also hold/unhold calls as well.
this also works when sending SMS messages from one emulator to the other
- the help system has been totally revamped:
* -help prints a summary of all options and help topics
* -help-<option> prints option-specific help
* -help-<topic> prints various topical help text
* -help-all prints *all* help content at once
- the emulator now tries to automatically detect the host time zone and sends
it to the emulated system at startup (through the GSM modem). there is also
a new '-timezone <timezone>' option to be able to specify a different one.
IMPORTANT: the <timezone> name must be in zoneinfo format, i.e.
Area/Location, human-friendly abbreviations like "PST" or "CET"
will not work. examples are:
America/Los_Angeles
Europe/Paris
- the emulator can now use up to 4 distinct DNS servers (instead of only one).
by default, they are taken from your system's list, which is obtained by
calling GetNetworkParams() on Win32, and parsing /etc/resolv.conf on
Unix.
- a new '-dns-server <server>' option can be used to specify a comma-separated
list of alternative DNS servers to be used by the emulated system, instead of
the system's default.
- a new '-scale <fraction>' option allows you to scale the emulator
window. <fraction> can be a number between 0.1 and 3.0.
you can also use '-scale <value>dpi', (e.g. '-scale 110dpi') to indicate the
resolution of your host monitor screen. it will be divided by the emulated
device's resolution to get an absolute scale.
- a new '-dpi-device <dpi>' option allows you to specific the resolution of
the emulated device's screen. Note that this is not required: the default
used is 165, which is the average of several prototypes we've been working
with.
- add a new '-port <port>' option to specify which port the emulator should
bind to for the console, instead of letting it guess. <port> must be an
*even* integer between 5554 and 5584 included. the corresponding ADB port
will be <port>+1
- [DEPRECATED] add a new '-adb-port <port>' option to specify which port the
emulator should bind to, instead of letting it guess. <port> must be an odd
integer between 5555 and 5585 included. the corresponding control console
will be on <port>-1
NOTE: -adb-port is deprecated, don't use it, it will probably disappear
NOTE2: you cannot use both -port and -adb-port at the same time.
- a new '-no-boot-anim' options tells the emulated system to disable the boot
animation. on slow systems, this can *significantly* reduce the time to
boot the system in the emulator.
- you can now redefine the emulator's keybinding by writing a 'keyset' file
and use '-keyset <filename>' to use it when starting the emulator. use
-help-keyset and -help-keyset-file for all details.
this allows you to use the emulator effectively on keyboards which don't
have a keypad, by using different keys..
- you can now toggle between windowed and fullscreen mode at runtime by
pressing Alt-Enter (only works on Linux at the moment !!)
- use '-audio-out <backend>' and '-audio-in <backend>' to change the output
and input audio backends used by the emulator. see -help-audio-out and
-help-audio-in for a list of valid values.
this is equivalent to setting the QEMU_AUDIO_OUT_DRV and QEMU_AUDIO_IN_DRV
environment variables.
use '-audio <backend>' to set both the input and output backends at the
same time. this is equivalent to setting the QEMU_AUDIO_DRV environment
variable.
NEW CONSOLE COMMANDS:
- the new 'power' command can be used to control the power/battery state of
the emulated device.
- the new 'event send' command can be used to send simulated hardware events
to the Android Linux kernel. each event must be in the form
<type>:<code>:<value> where:
<type> is either an integer or a corresponding string alias
(use "event types" to see a list of aliases)
<code> is either an integer or a corresponding string alias
that depends on the value of <type> (use "event codes <type>"
to see a list of these aliases)
<value> is an integer
NOTE: Be warned that it is very easy to confuse the kernel about the state
of emulated hardware by sending the wrong event. An *excellent*
knowledge of the Linux kernel internals is encouraged before playing
with "event send".
- the new 'event text <textMessage>' command can be used to simulate
keypresses of small text messages, where <textMessage> is an utf-8 string.
- the new 'avd stop' and 'avd start' command can be used to stop/start the
emulation. you can also use 'avd status' to query the current state.
- the new 'window scale <scale>' command allows you to change the scale of
the emulator window dynamically. <scale> is either an integer followed by
the 'dpi' suffix (e.g. '120dpi') or a real number between 0.1 and 3.0.
in the first case, <scale> specifies your monitor dpi; in the second one,
the new window scale itself.
OTHER BUG FIXES:
- in case of SDL_Init() failure, print the SDL error message.
- disable networking code's logging to /tmp/slirp.log
- the emulator now works with 2GB SD Card files
- the emulator doesn't prevent the screensaver to kick in on OS X anymore
- the -onion and -onion-alpha options now work properly
- a second emulator instance trying to use the same SD Card instance than a
first one will no longer crash
- it's now possible to properly start the emulator in the background on all
Unix shells (e.g. "emulator &") without being interrupted/stopped by a
SIGTTIN or SIGTTOU signal.
- fixed a bug in the SMS emulation that happened when using GSM 7-bit escaped
characters, i.e. anything in the following: [|]~\{}^
- fixed a small regression where -data <foo> would fail if the file <foo>
did not exist.
REGRESSIONS:
- the -flash-keys options doesn't work anymore
KNOWN ISSUES:
- no support for video input
- no support for mutable SIM Card emulation yet
- no support for bluetooth
- no support for WiFi
- on some Linux machines, the emulator might get stuck at startup. this
seems to be related to audio input support. try starting with
'-audio-in none' or even '-noaudio' to disable sound, or choose a different
audio backend by defining QEMU_AUDIO_DRV to an appropriate value
(read below).
you can also select different audio backends for both output and input
by defining QEMU_AUDIO_OUT_DRV and QEMU_AUDIO_IN_DRV independently.
- on Windows, the emulator takes about 10-15% of the CPU even when the
emulated system is idle. this is a known issue related to QEMU's internal
event loop and Winsock. this should be fixed in a future emulator release.
OTHER:
- you can now use -debug-<component> and/or -debug-no-<component> to
enable or disable the debug messages of a given emulator component. this
can be very useful for troubleshooting. for all details, use -help-debug
and -help-debug-tags
- you can also use '-debug <tags>' where <tags> is a comma-separated list
of component names, optionally prefixed by a single '-'. see -help-debug
and -help-debug-tags for all details
- you can now define the ANDROID_VERBOSE environment variable as a list
of "debug" items (each <item> corresponds to a -debug-<item> option).
for example, defining:
ANDROID_VERBOSE=socket,keys
is equivalent to using "-debug socket,keys" when invoking the emulator
- as a special case, -debug-slirp enables logging of the router/firewall
operations to a temporary file (e.g. /tmp/android/slirp.log). you can
also specify a logging bitmask with the ANDROID_SLIRP_LOGMASK environment
variable (the default is a mask of 7).
- removed many obsolete / unused source files from the repository. also
performed a rather heavy cleanup of the sources to make them somewhat
more manageable.
- integrate dynticks support from upstream QEMU depot. this only allows one
to provide more precise timing accuracy in the guest under Linux.
(NOTE: disabled in the source code, since it seems that it freezes
the emulator sometimes)
- audio input is now working on OS X, Windows and Linux. on Linux, there
are four different backends supported: EsounD, ALSA, OSS and SDL. they
are accessed through dlopen/dlsym, which means that the emulator binary
will run on any system.
you can specify a given backend by defining the QEMU_AUDIO_DRV environment
variable to one of these values:
alsa
esd
sdl
oss
none
note that the "sdl" audio backend is the most compatible, but doesn't
support audio input at all !!
- a new option '-cpu-delay <delay>' can be used to slow down the CPU
emulation. the <delay> is an integer between 0 and 1000. note that it
doesn't necessarily scale linearly with effective performance.
the delay process is not exactly deterministic. this is just a hack that
may disappear or be completely re-implemented in the future
- some new "gsm" and "sms" subcommands were added to the control console.
they are used internally by the voice/sms auto-forwarder and are probably
not very useful to typical developers
- some code has been added to support save/restore of the AVD state to/from
a file. however this is not properly tested yet, and requires that you
use exactly the same options and disk images when reloading the AVD state.
- added a new -cache <file> option to specify the cache partition image
file. the default is to use a temporary file instead
- added a new -report-console <socket> option to be able to report the
automatically assigned console port to a remote third-party (e.g. a
script) before starting the emulation. see the output of -help for all
the details
- (only useful to Android engineers)
the audio sub-system is now compiled in its own static library (called
libqemu-audio.a), which gets copied to the Android "prebuilt/Linux/qemu"
directory. this is done to avoid forcing all developers to install various
development packages on Linux, as well as all build servers. there is also
now a script named "distrib/update-audio.sh" which will update the depot
file automatically for you: call it whenever you change the audio sources.