View source for Building a Virtual Machine for Maemo development

== Preferred operating system for Scratchbox/Maemo development ==

Debian GNU/Linux 6.0.x "Squeeze" is suggested as the optimal platform on which to develop with Scratchbox. If you do not run Linux as your primary operating system, or prefer an alternative distribution/release, it is recommended to create a virtual machine for this purpose.

== Virtualisation software ==

There are a variety of freely-available virtualisation platforms, including [https://www.virtualbox.org/ VirtualBox], [https://www.vmware.com/products/player/ VMware Player], [http://wiki.qemu.org/Download QEmu] and others. VirtualBox seems to be easy to use and performs well. If your PC runs Linux, you may prefer to install virtualisation software through your package manager, for better integration with your OS.

== Debian Squeeze basic installation ==

*Download the latest Debian Squeeze i386 netinstall version from [http://cdimage.debian.org/cdimage/archive/6.0.9/i386/iso-cd/debian-6.0.9-i386-netinst.iso here]
*Create a new guest (virtual machine) using your virtualisation software and enable network connectivity for it
*Mount the ISO file as a 'virtual' CD-ROM on the guest machine using your virtualisation software
*Boot the guest from the virtual CD-ROM
*Follow the Debian installer prompts to complete the installation of Debian into the guest.
*N.B. Disk space: It is recommended that 10 GB of storage be allocated to the ''root'' filesystem, as Scratchbox will install there and will consume 6-8 GB of disk space alone.
*When prompted, set the root password and create a non-root user, noting both passwords.

== Preparing Squeeze for Development ==

*Boot the installed Squeeze guest and log in with the root account and password (set during the installation process)
*Install ''sudo'' <pre># apt-get install sudo</pre>
*Add your non-root user to the ''sudo'' group<pre># adduser <username> sudo</pre>
*Log out and log back in as your non-root user
*Create the file ''/etc/apt/sources.list.d/scratchbox.list'', add the Scratchbox repository as follows and save the file: <pre>deb http://scratchbox.org/debian/ hathor main</pre>
*Update your package database <pre>$ sudo apt-get update</pre>
*Install Scratchbox <pre>$ sudo apt-get install scratchbox-core scratchbox-devkit-apt-https scratchbox-devkit-autotools-legacy scratchbox-devkit-debian-squeeze scratchbox-devkit-doctools scratchbox-devkit-git scratchbox-devkit-perl scratchbox-devkit-python-legacy scratchbox-devkit-qemu scratchbox-devkit-svn scratchbox-libs scratchbox-toolchain-cs2007q3-glibc2.5-arm7 scratchbox-toolchain-cs2007q3-glibc2.5-i486 scratchbox-toolchain-host-gcc xserver-xephyr</pre>
*Create a Scratchbox user <pre>$ /scratchbox/sbin/sbox_adduser <username></pre>

== Installing the Maemo SDK ==

*Download the Maemo SDK installer: <pre>$ wget http://repository.maemo.org/stable/5.0/maemo-sdk-install_5.0.sh</pre>
*Replace all occurrences of 'etch' with 'squeeze': <pre>$ sed -i -e 's/etch/squeeze/g' maemo-sdk-install_5.0.sh</pre>
*Launch the installer: <pre>$ sudo sh ./maemo-sdk-install_5.0.sh</pre>

== Log in to Scratchbox ==

#Log in to Scratchbox <pre>$ /scratchbox/login</pre>
#Proceed further to accept the EULA in order to obtain the Nokia proprietary binary packages. These Nokia binaries are essential for the complete functionality of the Maemo SDK:
#Add this source to the Scratchbox repositories for both ARM and x86 architectures using the instructions in the next step: <pre>deb http://skeiron.org/repo/repository.maemo.org/ fremantle/4bc37c7c77ebe90177c050b805a8dc79 nokia-binaries</pre>
#Execute the commands below on the FREMANTLE_ARMEL and FREMANTLE_X86 targets.
  [sbox-FREMANTLE_X86: ~] > sb-conf select FREMANTLE_ARMEL
  [sbox-FREMANTLE_ARMEL: ~] > nano /etc/apt/sources.list  # add deb line 
  [sbox-FREMANTLE_ARMEL: ~] > apt-get update
  [sbox-FREMANTLE_ARMEL: ~] > fakeroot apt-get install nokia-binaries nokia-apps
  [sbox-FREMANTLE_ARMEL: ~] > sb-conf select FREMANTLE_X86
  [sbox-FREMANTLE_X86: ~] > nano /etc/apt/sources.list  # add deb line 
  [sbox-FREMANTLE_X86: ~] > apt-get update
  [sbox-FREMANTLE_X86: ~] > fakeroot apt-get install nokia-binaries nokia-apps
#The above step installs all needed Nokia proprietary binary packages along with the open source binaries that have dependencies to Nokia proprietary binary packages. With this, your Maemo 5 SDK environment is set up completely and ready for development.
#If you got any DNS errors with apt-get install resolving 'repository.maemo.org', you may need to update the resolver config inside scratchbox with: <pre>$ sudo /scratchbox/sbin/sbox_sync</pre>