Mobile Application Design - User contributions [en]

Python Setup Notes

2006-11-15T04:15:13Z

72.245.43.91:

== Python for S60 ==

=== Installation ===
[http://sourceforge.net/projects/pys60/ Project Home page] |
[http://sourceforge.net/project/showfiles.php?group_id=154155&package_id=171153&release_id=462564 Download page]

Since we are using the lovely N80 phones provided by Nokia - we'll need to download the following files:

*[http://downloads.sourceforge.net/pys60/PythonForS60_1_3_13_SDK_3rdEd_selfsigned.zip?modtime=1163177758&big_mirror=0 PythonForS60_1_3_13_SDK_3rdEd for Series60 3rd Edition] phones like N80, N91, N93.
*[http://downloads.sourceforge.net/pys60/pythonscriptshell_1_3_13_3rded_selfsigned.SIS?modtime=1163177763&big_mirror=0 PythonScriptShell_1_3_13_3rdEd]
*[http://downloads.sourceforge.net/pys60/PythonForS60_doc_1_3_13.pdf?modtime=1163177758&big_mirror=0 API Documentation]

Bluetooth these to your N80 and install them ahead of time.

=== Reference ===
[http://www.mobilenin.com/pys60/menu.htm Jurgen Scheible's Tutorial Site]

[http://www.python.org/doc/2.2.3/lib/lib.html Python Library Reference]

[http://docs.python.org/tut/ Guido Van Rossum's Python Tutorial]

=== Editors ===
[http://pydev.sourceforge.net/ PyDev (for Eclipse]

=== Useful Tools ===
[http://pdis.hiit.fi/pdis/download/miso/ Miso - a utility library]
[http://people.csail.mit.edu/kapu/symbian/python.html Kari Pulli's Python page]

Python Setup Notes

2006-11-15T04:08:35Z

72.245.43.91:

Python Setup Notes

2006-11-15T02:13:21Z

72.245.43.91:

== Python for S60 ==

=== Installation ===
[http://sourceforge.net/projects/pys60/ Project Home page] |
[http://sourceforge.net/project/showfiles.php?group_id=154155&package_id=171153&release_id=462564 Download page]

Since we are using the lovely N80 phones provided by Nokia - we'll need the following files:

*[http://downloads.sourceforge.net/pys60/PythonForS60_1_3_13_SDK_3rdEd_selfsigned.zip?modtime=1163177758&big_mirror=0 PythonForS60_1_3_13_SDK_3rdEd for Series60 3rd Edition] phones like N80, N91, N93.
*[http://downloads.sourceforge.net/pys60/pythonscriptshell_1_3_13_3rded_selfsigned.SIS?modtime=1163177763&big_mirror=0 PythonScriptShell_1_3_13_3rdEd]
*[http://downloads.sourceforge.net/pys60/PythonForS60_doc_1_3_13.pdf?modtime=1163177758&big_mirror=0 API Documentation]

=== Reference ===
[http://www.mobilenin.com/pys60/menu.htm Jurgen Scheible's Tutorial Site]

[http://www.python.org/doc/2.2.3/lib/lib.html Python Library Reference]

[http://docs.python.org/tut/ Guido Van Rossum's Python Tutorial]

Welcome

2006-11-15T01:04:40Z

72.245.43.91: /* Resources */

[http://uberthings.com/teaching/mobile_application_design Mobile Application Design 2006] class wiki

== Resources ==

[[Java Setup Notes]]

[[Python Setup Notes]]

[[Deploying]]

[[ClassNotes]]

[[Links]]

== Class ==

[[Themes for Homework]]

[[Final Projects]]

[[PresentationSignup]]

[[HomeworkLinks]]

[[OfficeHours]]

Java Setup Notes

2006-11-15T01:02:48Z

72.245.43.91:

== Setting up your environment ==

Having a good environment setup is essential for everything you will be doing with Java ME - writing, compiling, packaging, debugging, obfuscating, tearing your hair out etc etc. Use the instructions here to setup your environment on Windows or OS X (currently experimental).

<h2>Java + Wireless Toolkit</h2>
#Java Standard Edition Development Kit (JDK) - you need to have some version of Java installed on your machine. Try to get version 1.4.2 (or later). This is essential for development. NOTE: You MUST have the JDK installed before you install the Java Wireless Toolkit as you will need the tools it contains (such as javac) to compile and run your MIDlets.
#Download it here: http://java.sun.com/j2se/downloads/index.html. Get the version without any other bundled software. It should be called something like JDK 5.0 Update 8.
#Java ME, Wireless Toolkit (WTK). This contains the essential tools that we need to build, package and install mobile applications. Download it here: http://java.sun.com/products/j2mewtoolkit/. Get the [J2ME Wireless Toolkit 2.2 http://java.sun.com/products/sjwtoolkit/download-2_2.html], or if you feel living on the bleeding edge - grab the Sun [Java Wireless Toolkit 2.5 for CLDC, Beta http://java.sun.com/products/sjwtoolkit/download-2_5.html](the toolkit formerly known as J2ME Wireless Toolkit). Careful, you may cut yourself.
#I'm going to assume that you will install this into the <pre>C:\WTK\</pre> directory - if you install it somewhere else, just modify the paths accordingly.

<h2>Paths</h2>
To play nicely with the grown-ups, Java needs to know where all your files are, so we need to add the location of the Java binaries to the system path.

<h3>Windows 95/98</h3>
Go to Start->Run. Type in <em>command</em>. Then type

<pre>SET PATH=%PATH%;C:\WTK\bin</pre>

You should also edit your C:\autoexec.bat file to include this line, so you don't have to enter it every single time you restart your computer. After you've done this, you should be able to run the tools included in the Java Wireless Toolkit from any directory on your system.

<h3>Windows 2000/XP</h3>
#Go to Control Panel -> System.
#Click on the Advanced Tab
#Click on the Environment Variables button
#Double-click the PATH variable in the System variables box
#At the end of the <em>Variable value</em> field, add the path to your J2ME WTK installation - for me this is something like <em>;C:\WTK</em>
#If you had to install the J2SE SDK too, it's a good idea to add the paths for that as well - for me this was <em>C:\j2sdk1.4.2_03;C:\j2sdk1.4.2_03\bin</em>.

<p>A good way to test if this worked is to type the preverify command without any arguments in the command line. You should see something like this on your screen. </p>
<pre>
C:\> preverify<br />
Usage: PREVERIFY.EXE [options] classnames|dirnames ...<br />
<br />
where options include:<br />
-classpath <directories separated by ';'><br />
Directories in which to look for classes<br />
-d <directory> Directory in which output is written <br />
@<filename> Read command line arguments from a text file.<br />
</pre>

<h2>Emulators</h2>

<h3>Windows</h3>
Depending on your target device, you should download and install the SDK for that particular handset or family of handsets from the manufacturer's site. Since this course is based around the Nokia Series 60 handsets, we're going to grab the Nokia Series 60 2nd Edition SDK, Feature Pack 2 and 3 as well as the Nokia Series 60 3rd Edition SDK (for the N80). You'll also need to get serial numbers for these SDKs, so don't forget to request those as well.
Download them from here:

[http://www.forum.nokia.com/info/sw.nokia.com/id/6e772b17-604b-4081-999c-31f1f0dc2dbb/S60_Platform_SDKs_for_Symbian_OS_for_Java.html Series 60 SDKs]

<h3>Mac OS X</h3>
None of the manufacturers have bothered to port their SDKs for the Mac, and neither has Sun, but there is a way to develop MIDP 1.0 and 2.0 applications using Apache Ant, MPowerplayer MIDP 2.0 SDK and J2ME Polish. Get 'em while they're hot:

<h5>Apache Ant</h5>
# Download Apache Ant from http://download.nextag.com/apache/ant/binaries/apache-ant-1.6.5-bin.tar.gz
# Save it somewhere easy and memorable - on my machine I save all my downloaded source files to <pre>/Users/michael/src</pre>
# Here is the process. To try keep things clean, we're going to be installing into /usr/local.
<pre>
tar -zxvf apache-ant-1.6.5-src.tar.gz
cd /usr/local
sudo mkdir ant
cd ant
sudo cp -R ~/src/apache-ant-1.6.5/bin .
sudo cp -R ~/src/apache-ant-1.6.5/lib .
</pre>
# Set up the paths in your environment
<pre>
pico ~/.bash_login
</pre>
Add these lines somewhere
<pre>
export ANT_HOME=/usr/local/ant
export JAVA_HOME=/Library/Java/Home
export PATH=${PATH}:${ANT_HOME}/bin
</pre>
Shut down your shell, open it up again and type
<pre>
ant

You should see something like this

Buildfile: build.xml does not exist!
Build failed
</pre>
This means that Ant is installed and we're ready to roll.

<h5>MPowerplayer MIDP 2.0 SDK</h5>
# Download this from http://www.mpowerplayer.com/products-sdk.php
# Save the file somewhere in your src folder and unzip it. On my machine this looked like this:
<pre>
/Users/michael/src/mobile/mpp-sdk
</pre>
# [Optional] I like making shortcuts so that it's easy for me to run the application. Fire up your favourite editor and type this
<pre>java -jar /Users/michael/src/mobile/mpp/player.jar $1 &</pre>
and then save that somewhere in your path as '''mpp''' Type the following:
<pre>chmod 755 mpp</pre>
Now, all you need to do to run JAD/JAR files in the emulator is type <pre>mpp [filename.jad/filename.jar]</pre>

<h5>J2ME Polish</h5>
# Download [http://j2mepolish.org/downloads/j2mepolish-2.0-beta1.html J2ME Polish]. I got the latest 2.0 beta version. It seems to work well.
# Run the downloaded JAR file
# Choose the GPL or Evaluation license
# Select the directory where you installed the MPP-SDK as the path to your wireless toolkit.
# Test if everything installed correctly by running one of the J2ME Polish sample applications
<pre>
cd /Applications/J2ME-Polish/samples/menu
ant
</pre>
# You should see a few messages from Ant letting you know that it's building the application. The build is configured to store all the JAD and JAR files inside the dist folder.
# Once it's done, if you created a shortcut to the MPowerplayer SDK like I suggested above, you should be able to run it by typing something like
<pre>
mpp dist/Sony-Ericsson-P900-en_US-example.jad
</pre>
# I included a modified build.xml with extensive comments file in the [http://uberthings.com/teaching/mobile_application_design/1/code.zip HelloMidlet] code samples. Open it up in a text editor and read through to learn how it works.

<h5>Building</h5>
To build applications with J2ME Polish, Mpowerplayer and Ant, you need to do the following:

# Copy the build.xml file into your MIDlet's directory.
# Check the paths inside the build.xml file to ensure that they're pointing to the right folders for your source folders, Mpowerplayer and J2ME Polish
# Type ant. Watch the magic unfold.

<h2>IDE's</h2>
<h3>Eclipse</h3>

[http://eclipse.org Eclipse] is a fantastic open source Java Integrated Development Environment (IDE) which has a few sweet J2ME plugins. The one I use the most is called [http://eclipseme.org EclipseME]. <s>Although Eclipse is cross-platform, EclipseME doesn't work very well on OS X.</s> OS X works nicely with EclipseME and the MPowerplayer SDK.

'''Windows'''

# Download Eclipse from http://www.eclipse.org/downloads/. Install it somewhere easy - like C:\eclipse
# Configuring and install EclipseME using the excellent installation and configuration instructions [http://eclipseme.org/docs/installEclipseME.html here] to guide you through this process.
# Once you're done - we're ready to start coding! Yeah!

'''OS X'''

# Install EclipseME from the download site.
# Go to Window->Preferences. Select J2ME.
# When it asks you for the WTK Root - select the folder where you installed the Mpowerplayer SDK - for me it was /Users/michael/src/mobile/mpp-sdk.
# Go to Device Manager. Hit Import. Select the Mpowerplayer directory again. It will only find one emulator. Select it.
# Hit Apply. Then ok.

'''Initial Directory structures'''
# For my projects, I like to set up my source files in the /src folders of my projects and all external files to be in /res - this is how you do it in Eclipse.
[http://uberthings.com/teaching/mobile_application_design/i/j2me_setup.jpg J2ME Setup]

[http://uberthings.com/teaching/mobile_application_design/i/java_build_path.jpg Java Build Path]

<h3>Netbeans</h3>
Download Netbeans from Sun here - http://www.netbeans.org/. I don't use it much, but I've heard good things. Let me know how it treats you.

<h3>Mobile.Processing</h3>

[http://mobile.processing.org/ Mobile.Processing] is an open source programming environment for people who want to design and prototype software for mobile phones. It is based on and shares the same design goals as the open source [http://processing.org Processing ] project. Sketches programmed using Mobile Processing run on Java Powered mobile devices. Mobile.Processing is extremely easy to get up and running with, but has some drawbacks which will prevent us from using it.

Mobile.Processing is available for both Windows and Mac OS X. Download it [http://mobile.processing.org/download/index.php here].

Welcome

2006-11-15T01:01:26Z

72.245.43.91: /* Resources */

[http://uberthings.com/teaching/mobile_application_design Mobile Application Design 2006] class wiki

== Resources ==

[[Setup]]

[[Java Setup Notes]]

[[Python Setup Notes]]

[[Deploying]]

[[ClassNotes]]

[[Links]]

== Class ==

[[Themes for Homework]]

[[Final Projects]]

[[PresentationSignup]]

[[HomeworkLinks]]

[[OfficeHours]]

Welcome

2006-11-13T04:02:53Z

72.245.43.91:

[http://uberthings.com/teaching/mobile_application_design Mobile Application Design 2006] class wiki

== Resources ==

[[Setup]]

[[Deploying]]

[[ClassNotes]]

[[Links]]

== Class ==

[[Themes for Homework]]

[[Final Projects]]

[[PresentationSignup]]

[[HomeworkLinks]]

[[OfficeHours]]

Final Projects

2006-11-13T03:58:15Z

72.245.43.91:

== Final Projects for Mobile Application Design Fall 2006 ==

Welcome

2006-11-13T03:56:13Z

72.245.43.91: /* Class */

== Resources ==

[[Setup]]

[[Deploying]]

[[ClassNotes]]

[[Links]]

== Class ==

[[Themes for Homework]]

[[Final Projects]]

[[PresentationSignup]]

[[HomeworkLinks]]

[[OfficeHours]]

Deploying

2006-10-11T15:02:43Z

72.245.43.91:

=== Introduction ===

You have a few options to get your MIDlets onto your phone - either send them through a cable or Bluetooth - or download them directly from a web site (OTA).

==== Over The Air (OTA) Provisioning ====

OTA provisioning allows users to download your application wirelessly using the WAP browsers built into their phones. To begin, we need to take a look at the Java Application Descriptor (JAD) file that is created when you package a MIDlet using the J2ME Wireless Toolkit. The JAD file stores information about your application and lets you modify various parameters of the MIDlet suite such as where the icon resource can be found, which MIDlets are included and where you can download the full version of the application. To edit a JAD file using the Wireless Toolkit, open your project, then click on Settings. This will open up a new window with a number of tabs - API Selection, Required, Optional, User Defined, MIDlets, Push Registry and Permissions.

Please note that the example is based on the one here: http://uberthings.com/mobile/

1. API Selection
This is where you choose which version of MIDP your application will use and which optional packages (JSRs) are included. The default is set to JTWI (Java Technology for the Wireless Industry) which allows you to use MIDP 2.0 as well as MMAPI and other exciting things. If you're having any problems with your application on your device try changing this to MIDP 1.0.

2. Required
This tab includes various options which are essential for packaging a MIDlet suite. The MIDlet-Jar-URL attribute is where we will define the location of the packaged JAR file to be downloaded to the device.

3. Optional

This tab includes optional parameters for your MIDlet - such as the path to the icon for the entire suite, a description and a MIDlet-Info-URL parameter.
4. User Defined

This tab includes user defined variables that your MIDlet can use - such as a common URL that you don't want to hard wire into the source code.
5. MIDlets

This tab manages all the settings for the MIDlets within your suite. At the very least you need to have one file here. This is also where you set the path to the MIDlet's icon resource.
6. Push Registry

This lets you configure the Push Registry which allows your MIDlet to listen and act on information received from a remote source. MIDP 2.0 Only.
7. Permissions

Under MIDP 1.0, applications could only access libraries packaged inside the suite - this was called the sandbox model. MIDP 2.0 introduces the concept of trusted applications which allow access beyond the sandbox. This section allows you to specify which APIs are accessible.

For our purposes - the most important property is the MIDlet-Jar-URL within the Required tab. Here are the steps you need to take:

1. Create a folder on your web server

Hopefully you have an account with a web provider - login to that account and create a directory for your MIDlets to live and be served from. I created the directory http://uberthings.com/mobile/midlets. Once you've got that, you need to make a few changes to allow your server (assumed to be Apache) to serve JAD and JAR files correctly. Go to the root of your account and edit or create your .htaccess file. Add these lines:

AddType text/vnd.sun.j2me.app-descriptor jad
AddType application/java-archive jar

Save this file. If you're not using Apache, ensure that your MIME types include the above two settings.
2. Specify the MIDlet-Jar-URL

Click on Settings then go to the Required Tab. In the MIDlet-Jar-URL field, fill in the absolute URL of your JAR file. This will normally be something like http://mydomain/mydir/HelloProject.jar. For my server, this was http://www.uberthings.com/mobile/midlets/HelloProject.jar.
3. Package your MIDlet

Click on Project->Package->Create Package. This will create a .jar and a .jad file in your applications bin folder. For my application - this was c:\j2mewtk\apps\HelloProject\bin\HelloProject.jar and c:\j2mewtk\apps\HelloProject\bin\HelloProject.jad.
4. Upload the packaged MIDlet suite

Upload the JAR and JAD files that the packaging operation created to the folder you created earlier.
5. Test with your device

Open the WAP browser on your phone and point it to the URL of the JAD file. Using my example, this would be http://uberthings.com/mobile/midlets/HelloProject.jad. Your device should then prompt you to download and install the MIDlet. Carry it around and show it off to all your friends!

==== Cable / Bluetooth ====

If you've got a Bluetooth adaptor or a USB cable which connects directly to your phone, you can use this to quickly test your packaged midlet.

Windows XP/2000: Browse to the bin folder of your project, right click on the .jar file and select Send To->Bluetooth->YOURDEVICE.
MacOS X: Click on the Bluetooth icon in the menu bar, choose Send File. Select your JAR file and send it to your device.
This should send a message to your phone which will install the MIDlet once opened. This should work on most Nokia Series 60 phones (3650, 6600, N-Gage etc).