Skip to content

TeclaDesktop (Developers guide)

jorgesilva edited this page Jul 12, 2012 · 15 revisions

#TeclaDesktop v0.9

This is the developer's guide for setting up TeclaDesktop project.

Requirements:

  1. A bluetooth enabled computer.
  2. The Java Development Kit (JDK)
  3. Netbeans. You can download netbeans from here. If you are using Linux, avoid the .deb or .rpm packages from the repositories as some files are missing in these packages.
  4. TeclaSocket library (available from this repository).

Windows

In addition to the requirements above, please note the following:

  1. The bluetooth libraries require you to have few .dll files in the folder:
    C:/Program Files/Java/jre<version>/bin/
    The dll files can be downloaded from here.
  2. Also, you should install the default bluetooth drivers for your chip, NOT the bluesoleil driver as they are known to give problems.

Getting started:

  1. Fork the TeclaShield repo into your github repository.If you don't have a github repository, register for one here : Github
  2. Clone the repository into your machine using git clone:
    $ git clone git://github.com/jorgesilva/TeclaShield.git
    Make sure you use github clone address for your repository as this will be default remote repository for you.
  3. TeclaDesktop resides in the desktop branch so checkout to desktop branch using git checkout.
    $ git checkout desktop
  4. Now that sources have been acquired,development can begin.Start Netbeans.
  5. Go to File -> Open Project ->Go to TeclaShield directory i.e. the directory where you cloned.
  6. Select TeclaDesktop and TeclaSocket projects.Make sure you have nbproject folder is present in the respective directories otherwise NetBeans won't recognize it.A cup like symbol will appear for a project in NetBeans.
  7. The NetBeans may ask you to install JUnit.Install it.
  8. In the Project Browser,Right click on your project (TeclaSocket) and select Clean and Build.Note ,for any changes in TeclaSocket to take effect you will have to clean and build TeclaSocket again.This builds the jar file which is used as a reference in TeclaDesktop.
  9. Once done, you are ready to code..

Clone this wiki locally