diff options
author | The Android Open Source Project <initial-contribution@android.com> | 2009-03-03 18:28:35 -0800 |
---|---|---|
committer | The Android Open Source Project <initial-contribution@android.com> | 2009-03-03 18:28:35 -0800 |
commit | f721e3ac031f892af46f255a47d7f54a91317b30 (patch) | |
tree | 4b825dc642cb6eb9a060e54bf8d69288fbee4904 /INSTALL | |
parent | bae1bc39312d5019bd9a5b8d840a529213a69a17 (diff) | |
download | external_qemu-f721e3ac031f892af46f255a47d7f54a91317b30.zip external_qemu-f721e3ac031f892af46f255a47d7f54a91317b30.tar.gz external_qemu-f721e3ac031f892af46f255a47d7f54a91317b30.tar.bz2 |
auto import from //depot/cupcake/@135843
Diffstat (limited to 'INSTALL')
-rw-r--r-- | INSTALL | 119 |
1 files changed, 0 insertions, 119 deletions
diff --git a/INSTALL b/INSTALL deleted file mode 100644 index 95b64e1..0000000 --- a/INSTALL +++ /dev/null @@ -1,119 +0,0 @@ -This package contains the sources to the Android emulator program. - -Supported Development Platforms: --------------------------------- - -The Android emulator can be built on the following platforms: - - - Linux 32-bits - - Linux 64-bits (*only* generates 32-bit emulator binary) - - Darwin x86 - - Darwin ppc (experimental only) - - Windows x86 (through Cygwin only) - -Note that development on 64-bit versions of Darwin and Windows is -not supported. The 32-bit emulator binary should run normally on -these platforms though. - -The Windows emulator binary is built using the -no-cygwin option -and thus doesn't depend on CYGWIN.DLL being installed on your system. - -It is possible to hack the android-configure.sh script to build -a 64-bit emulator binary on Linux. Unfortunately the resulting -program will crash pretty soon during emulation. This problem is -due to the way the emulator works and cannot be easily fixed at -the moment. - -Supported Compilers: --------------------- - -The Android emulator is a heavy fork of QEMU 0.8.2, and as such, -can only be built properly with a small number of compilers. Moreover, -which compiler can be used depends on your platform. - -The following table sums up the compilers that are *known* to produce -correct output: - - Linux x86: gcc-3.4.6 - Linux x86 and x86_64: gcc-4.2.3 - Darwin x86: gcc-4.0.1 (build 5341) - Darwin ppc: gcc-3.3 (build 1819) - -Use any other compiler at your own risks ! A 'bad binary' usually -results in the VM crashing either immediately or after a few seconds. - -Note that on Darwin, the *build* number of your compiler *is* important. -Some builds of gcc-4.0.1 are known to generate bad binaries on Darwin x86, -so your own fails to build an executable that works correctly. -You can find the sources to the required gcc here: - - -We distribute a file named distrib/build_gcc_qemu_darwin.sh which can be -used as a replacement for the Apple-provided build_gcc.sh that comes with -their gcc distribution. - - -Building the emulator with the Android build system: ----------------------------------------------------- - -Ensure that you have properly configured your build by running the -envsetup.sh script and using the appropriate 'lunch' command. - -Then type: - - m emulator - -This will rebuild the emulator and place it in an adequate location. -Simply type 'emulator' to start it with the currently built system -image. - - -Building the emulator without the Android build system: -------------------------------------------------------- - -You can also build the emulator as a stand-alone program, by following -these simple steps: - - 1/ First, build Android's patched libSDL as a static library, - this can be done as: - - cd $TOP/extlibs/libsdl-1.2.12 - ./android-configure --prefix=<PATH> - make - make install - - Where $TOP is the path of your open-source Android source tree, and - where <PATH> is any path of your chosing where the library will - be copied to by the 'make install' command. For example, you - can use $HOME/android-sdl - - 2/ Configure the emulator with android-configure.sh, as in: - - cd $TOP/tools/qemu - ./android-configure.sh --sdl-config=<PATH> - make - - Where <PATH> is the same path you used with the --prefix option - when building the SDL library - -The emulator binary is located into objs/emulator, you can strip it and -copy it to any location of your choosing. - - -Creating an emulator source distribution package: -------------------------------------------------- - -We provide a script to build a tar.gz package file that contains all the -sources required to rebuild the emulator (i.e. it includes the patched SDL -sources as well) plus a handy script to automate the rebuild. - -Simply invoke: - - cd $TOP/tools/qemu - distrib/make-distrib.sh - -This script will create a tar.gz file under /tmp/android-package and will -print its location when it completes. - -To rebuild the corresponding emulator, un-tar-gz the package, and run -the 'rebuild.sh' script. |