Hummingbird Eclipse Java Instructions

Creating a Hummingbird Eclipse Project

1.  Download the Eclipse software package and unzip it to a convenient directory.

2.  Open Eclipse.

LINUX USERS:

  • You must open Eclipse using sudo to run Hummingbird programs, or run this script to allow access by regular users. 
  • You will need to install libusb-1.0 before compiling a program. To do so, run sudo apt-get install libusb-1.0-0-dev in any terminal window.

3.  In Eclipse, go to File->Import->General->Existing Projects into Workspace

4.  In the import Java Project dialog window, make sure the 'Select root directory' option is selected and then click 'Browse' to navigate to and select the HummingEclipse directory

5.  Hit Finish - the project should now be visible in the left hand pane.

Running an Example File

1.  Expand src in the package explorer on the left hand pane.

2.  Expand a package of your choice and double click on a file. 

3.  Windows/Mac: Run the file by either clicking on the green run button, by going to Run->Run, or by hitting Ctrl-F11.

Linux users, your life is more complicated:

  • Run the program, it will hang on "Connecting...". Kill it manually.
  • Go to Run->Run Configurations
  • In the left side bar, select the name of the application you want to run.
  • In the right pane, select Arguments.
  • In VM Arguments, add the following text: -Djava.library.path=.  (including the .)
  • Hit "Run".

Creating a File from Scratch

1.  Right click on a package name, select New->Class and name the class in the resulting dialog window.