This document describes the hiptop Software Development Kit.
You can use this SDK to view the entire Danger class library, build applications
with the Danger tools, and run applications on the hiptop Simulator, a Java
application that implements the hiptop platform on personal computers. Future
versions of the SDK will include the ability to connect to the Danger service
and run your applications on hiptop devices.
Important Notice
"Java" is a registered trademark of Sun Microsystems ("Sun"). Danger, Inc. is not a
licensee of Sun and makes no claim, warranty or representation that its products,
software or documentation comply with Sun's specifications for Java.
How it works
You create hiptop applications using the Danger tools and libraries provided in
this SDK and a Java development system running on a personal computer. The SDK
includes tools and documentation for various platforms: Windows 2000 or XP,
Mac OS X 10.2.4, and Red Hat Linux 7.x and 8.0. Although the tools are designed to
work with any standard environment, we recommend Windows 2000 or XP because the SDK
has been most thoroughly with those operating systems.
Fast Start
If you're anxious to get started right away, this section is for you.
The steps below provide enough information to install the hiptop SDK,
build and run Hello World, and create your first application by modifying
Hello World. If something doesn't work or you need more detail, see the
sections that follow.
- Download the hiptop SDK zipfile from the download section of this site.
- Install a Java 2 JDK 1.3 (or later).
Note: you may be required to agree to certain terms and conditions of the
licensor in order to use some tools.
- Download Apache Ant from http://ant.apache.org/.
The hiptop SDK uses Ant to simplify building tools and applications.
- Set the path environment variable to include the locations of the Java compiler
and ant, and set the environment variable JAVA_HOME to the location of the Java
compiler. In Mac OS X and Linux, you can use tcsh commands as in the following
examples, using the locations of the tools on your disk if they're different from
the examples:
setenv PATH "${PATH}:/usr/local/ant/bin"
setenv PATH "${PATH}:/Library/Java/bin"
setenv JAVA_HOME /Library/Java/Home - Set your current directory to the Hello World folder in the Examples folder.
- From your IDE or command line, type ant to build and run Hello World in the
hiptop Simulator. In the Simulator, use the arrow keys to scroll all the way down
to the last slot. You'll see Hello World installed there. Press return to run it.
Creating your own application
The easiest way to create your own application is by modifying Hello World.
This quick example simply changes the message displayed by Hello World.
- Make a backup copy of the Hello World folder in the Examples folder.
You can use the backup copy if you ever need a copy of the original Hello World.
- In the original Hello World folder, open the file helloworld.rsrc with any
text editor and look for the line string kStrHelloWorld "Hello World...". Change
the text "Hello World..." to something even more clever.
- From your IDE or command line, type ant to build and run your modified
version of Hello World in the hiptop Simulator.