The Danger SDK
--------------

The Danger SDK enables you to build Java applications for the entire family of Danger-powered devices.  This README contains pointers to topics of interest for new users.

The Danger SDK runs and is supported under the Windows, Linux and MacOSX operating systems.  External dependencies are limited to Apache Ant 1.6+ and Java SE 1.3+.  Setting up the SDK for your platform is described in detail on the Danger Developer Zone website, here:

http://developer.danger.com/docs/quickstart

The device simulator is the cornerstone of the SDK, allowing you to rapidly develop applications on your desktop.  The simulator can be connected to Danger's backend, working in almost every way like a real, connected device.  Getting the simulator connected is described in detail on the Danger Developer Zone website, here:

http://developer.danger.com/docs/quicksim

There are a bunch of example projects included in the SDK to provide a diverse perspective on hiptop development.  Rather than attempting to set up a new project from scratch, try duplicating one of the existing projects and using it as a base for your code.  Especially when new to the platform, this can be a great way to come up to speed quickly.

Once you're up and running with the SDK, you may want to dig a little deeper, and learn more about how the SDK works and how you can use it effectively.  A document to help you understnad the SDK can be found here:

http://developer.danger.com/docs/sdkbasics

Developing for the hiptop wouldn't be much fun if you couldn't install your creation on your device.  This is accomplished through the hiptop's USB port, using a program called "htconsole" which is included with the SDK.  htconsole allows you to perform a small amount of on-device debugging, but is mostly used for uploading your application .bndl files (created by the SDK) to the device for testing.  More information about htconsole can be found here:

http://developer.danger.com/forum/index.php?t=msg&th=536

NOTE: On Windows, the hiptop USB driver will need to be installed before htconsole communication will work.  The driver is included in the tools/win32 directory of the SDK.  Start the "Add Hardware" control panel, tell it that you have the driver disk, then point it at the driver directory.

In order to actually upload .bndl files, you'll need a developer key.  This is a device-specific file that you upload to your hiptop which will let the OS know you are allowed to upload application bundles.  For people writing applications for the hiptop (as a hobby or not), being approved for developer keys is easy.  Read more about it here:

http://developer.danger.com/devkey

If you're interested in publishing your applications for the hiptop user base, you'll want to know more about Danger's PDM.  Read up on that here:

http://developer.danger.com/pdm

The hiptop enjoys a strong developer community, full of people willing to help you get up to speed quickly, so for all other questions check out the site search and developer forums, here:

http://developer.danger.com/search
http://developer.danger.com/forum

Good luck with your projects!
Danger Engineering
