Setting up the development environment: Difference between revisions

From
Jump to navigation Jump to search
No edit summary
Line 4: Line 4:
* [http://www.eclipse.org/ Eclipse], version 3.1.x
* [http://www.eclipse.org/ Eclipse], version 3.1.x
* [http://www.eclipseme.org/ EclipseME]
* [http://www.eclipseme.org/ EclipseME]
* Access to the SAR private network (either direct or through OpenVPN)
* Account for the SAR SVN server


Already included in the subversion checkout will be
Already included in the subversion checkout will be
Line 12: Line 14:
I'll assume that you want to set up the Sony Ericsson kit on Windows and the SUN kit on linux.
I'll assume that you want to set up the Sony Ericsson kit on Windows and the SUN kit on linux.


=Installation for Windows=
==Installation for Windows==
You need: Windows 2000/XP, (local) administrative rights, additionally a normal user for everyday work
You need: Windows 2000/XP, (local) administrative rights, additionally a normal user for everyday work


Line 35: Line 37:
You're done. For information on how to start developing look at <code>file:///<var>C:/SonyEricsson</var>/J2ME_SDK/PC_Emulation/WTK2/docs/UserGuide-html/demonstrations.html</code>, and [http://developers.sun.com/techtopics/mobility/learn/midp/midp20/].
You're done. For information on how to start developing look at <code>file:///<var>C:/SonyEricsson</var>/J2ME_SDK/PC_Emulation/WTK2/docs/UserGuide-html/demonstrations.html</code>, and [http://developers.sun.com/techtopics/mobility/learn/midp/midp20/].


=Installation for Linux=
==Installation for Linux==
# Install the SUN Java SDK 1.4.2 or later by whatever method your distribution uses. (For example, Gentoo Linux: <code>emerge sun-jdk</code>)
# Install the SUN Java SDK 1.4.2 or later by whatever method your distribution uses. (For example, Gentoo Linux: <code>emerge sun-jdk</code>)
# Install Eclipse:
# Install Eclipse:
Line 51: Line 53:
# Install the toolkit somewhere below your home directory (for example <code>/home/<var>ploetz</var>/<var>sw/WTK2.2</var></code>)
# Install the toolkit somewhere below your home directory (for example <code>/home/<var>ploetz</var>/<var>sw/WTK2.2</var></code>)
# Start Eclipse and follow the configuration hints from [http://eclipseme.org/docs/configuring.html] (the root of the Wireless Toolkit is <code>/home/<var>ploetz</var>/<var>sw/WTK2.2</var></code>)
# Start Eclipse and follow the configuration hints from [http://eclipseme.org/docs/configuring.html] (the root of the Wireless Toolkit is <code>/home/<var>ploetz</var>/<var>sw/WTK2.2</var></code>)

==Common checkout instructions==
# Window -> Open Perspective -> SVN Repository Exploring
# Right click in the SVN Repository view and choose New -> Repository Location. The URL shall be <code>svn://merkur//</code>, and fill in your username and password.
# On merkur, in the <code>span</code> subdirectory, you'll find three directories for now:
#; Testbed : Contains the J2ME code for the mobile phone, and the common libraries
#; jsr82test : Contains the J2SE code for the PC, but is dependent on the common libraries
#; docs : Documentation and illustrations

Revision as of 09:56, 15 December 2005

The development environment for the SPAN project involves:

  • A Wireless Toolkit: Either from Sony Ericsson (windows-only) or from SUN (Linux or Windows)
  • Subversion, additionally the Subclipse Eclipse plugin
  • Eclipse, version 3.1.x
  • EclipseME
  • Access to the SAR private network (either direct or through OpenVPN)
  • Account for the SAR SVN server

Already included in the subversion checkout will be

I'll assume that you want to set up the Sony Ericsson kit on Windows and the SUN kit on linux.

Installation for Windows

You need: Windows 2000/XP, (local) administrative rights, additionally a normal user for everyday work

  1. Become (local) administrator
  2. (optional, if needed) Get J2SE SDK 1.4.x from [1]
  3. (optional, if needed) Get DirectX 8.1 or later from [2] (there is a "runtime" quick link to the right)
  4. Get Eclipse 3.1.x from [3]
  5. Unpack Eclipse to the hard drive (e.g. in c:\eclipse)
  6. optional: create a start menu item for c:\eclipse\eclipse.exe
  7. Install Subversion: http://subversion.tigris.org/servlets/ProjectDocumentList?folderID=91 (the svn-1.2.3-setup.exe)
  8. Adjust the rights on c:\eclipse to Everybody: Read, Execute (make sure these are inherited to all files and folders below)
  9. Run Eclipse and install EclipseME per these installation instructions (Note: the correct update site is http://www.eclipseme.org/updates/ and not http://eclipseme.sourceforge.net/updates/ which erroneously is shown in the screenshots.) Don't bother with the configuration instructions yet.
  10. Install Subclipse per these instructions. You can combine this step with the previous one.
  11. Exit Eclipse.
  12. Install the Sony-Ericsson J2ME SDK from [4], for example to C:\SonyEricsson
  13. Adjust the rights on C:\SonyEricsson to Everybody: Read, Execute plus Full Access for your normal user (most of the programs in the SDK want to write in that directory)
  14. (optional, if needed) Disable the "Windows Firewall", because it interferes with emulator-emulator connections and is generally not needed on a properly configured system. If your Windows is not hardened yet you might want to do that now: http://www.ntsvcfg.de/
  15. Become your normal user.
  16. Start Eclipse.
  17. Follow the configuration hints from [5] (the root of the Wireless Toolkit is C:\SonyEricsson)

You're done. For information on how to start developing look at file:///C:/SonyEricsson/J2ME_SDK/PC_Emulation/WTK2/docs/UserGuide-html/demonstrations.html, and [6].

Installation for Linux

  1. Install the SUN Java SDK 1.4.2 or later by whatever method your distribution uses. (For example, Gentoo Linux: emerge sun-jdk)
  2. Install Eclipse:
    • If your distribution already has an eclipse package use this (Gentoo: Put =dev-util/eclipse-sdk-3.1.1 into /etc/portage/package.keywords and emerge eclipse-sdk)
    • Otherwise: Download the eclipse tarball, unzip it somewhere below your home directory and set your PATH environment variable to the eclipse directory.
  3. Install subversion by whatever method your distribution uses (Gentoo Linux: emerge subversion)
  4. Start Eclipse
    1. Install EclipseME per these installation instructions (Note: the correct update site is http://www.eclipseme.org/updates/ and not http://eclipseme.sourceforge.net/updates/ which erroneously is shown in the screenshots.) Don't bother with the configuration instructions yet.
      Note: If you did not install Eclipse in your home directory you may have to use the Change Location... button to choose an installation location where you can write to.
    2. Install Subclipse per these instructions. You can combine this step with the previous one.
  5. Exit Eclipse
  6. Download the Wireless Toolkit 2.2 from http://java.sun.com/products/sjwtoolkit/download-2_2.html (the file is called j2me_wireless_toolkit-2_2-linux-i386.bin
  7. chmod a+x j2me_wireless_toolkit-2_2-linux-i386.bin
  8. ./j2me_wireless_toolkit-2_2-linux-i386.bin
  9. If it should ask you for the path to a "Java interpreter directory": Find out where the java binary lives (in another terminal do which java which will say something like /usr/bin/java, where /usr/bin/ is the 'Java interpreter directory').
  10. Install the toolkit somewhere below your home directory (for example /home/ploetz/sw/WTK2.2)
  11. Start Eclipse and follow the configuration hints from [7] (the root of the Wireless Toolkit is /home/ploetz/sw/WTK2.2)

Common checkout instructions

  1. Window -> Open Perspective -> SVN Repository Exploring
  2. Right click in the SVN Repository view and choose New -> Repository Location. The URL shall be svn://merkur//, and fill in your username and password.
  3. On merkur, in the span subdirectory, you'll find three directories for now:
    Testbed
    Contains the J2ME code for the mobile phone, and the common libraries
    jsr82test
    Contains the J2SE code for the PC, but is dependent on the common libraries
    docs
    Documentation and illustrations