Developer Guide

Introduction

The uniCenta oPOS Developer Guide is relevant to all versions and it’s aimed at developers and advanced users with Java development skills who want to “tweak” uniCenta oPOS.

You can download uniCenta oPOS Source Code here but you will need to Register first if you haven’t already.

Stuff you need

The preferred devlopment IDE for uniCenta oPOS is Netbeans as the Swing forms and components used are particular to Netbeans.logo_netbeans_red.png
First of all you will need to download and install the Java 7 JDK from Oracle - you can also grab the JDK + Netbeans here too.java_logo.png
Using the Eclipse IDE is also OK, but it will present some challenges when sychronizing development between these two IDE’s.eclipse_logo.png
Another great IDE I’ve used is JetBrains IntelliJ for when I’m developing code as opposed to the UI side of things.Proud user of
Finally you will need an Installer to package and deploy your work. I use Bitrock InstallBuilder for uniCenta oPOS distributions as it’s powerful, flexible and cross-platform.bitrock-logo.gif

Using Netbeans

The Swing components in uniCenta oPOS are particular to Netbeans and use the .form extension which only Netbeans is able to read.
If you peek under the hood you will see they are in XML format.

Having downloaded the uniCenta oPOS Source Code and set up Netbeans you are now ready to create a new Netbeans project .

First of all you will need to unzip the uniCenta oPOS Source Code Download into a new folder.

Netbeans has a New Project Wizard which will help you get up and running quickly.

Step 1: Start a new project

In Netbeans choose Java Project with Existing Sources > Next

netbeans_project_screen_1.png


Step 2: Project Name and Folder
 
Project Name: This doesn’t have to be uniCenta oPOS. I find it better if you don’t use spaces in the name.
Project Folder: The Netbeans Wizard automatically completes this based on the Project Name. Edit to suit where you want to store the project.
All done on this screen. Click Next
netbeans_project_screen_2.png


Step 3: Add uniCenta oPOS Sources

Initially in this screen you will see that the Wizard has only imported src-beanssrc-data and src-pos
Click the Add Folder button and add the reports and locales folders
Once you’ve added these. Click Next - you could click Finish at this point which skips the screen after this one.

netbeans_project_screen_3.png


Step 4: Amend Include/Exclude files (optional)

Make any final adjustments to the Include/Exclude files to be in the project. I recommend you leave as is and Click Finish

netbeans_project_screen_4.png
The Wizard has done its job and you’ll see it creating the necessary files and folders it needs for your project.

When it’s done the Projects tab will be populated with the uniCenta oPOS project’s files.
You’re nearly there, but wait you’ll notice there are Warnings! and you need to clear these first as the Netbeans Wizard doesn’t add the
Libraries you need to the project for you automatically.


Step 5: Adding Libraries I

Right Click on the Project Name at the top of the tree and choose Properties from the menu that appears.

netbeans_project_screen_5.png


Step 6: Adding Libraries II – Set Java Platform & Add .jars
On this screen you need to do two things:
1. Make sure the Java Platform is set to JDK 1.7 (uniCenta oPOS v3 uses features available in JDK 1.7)
2. Add the Libraries. Make sure the Compile tab is selected and Click Add JAR/Folder
netbeans_project_screen_7.png


Step 7: Adding Libraries III – Select .jars

In the Add JAR/Folder pop-up select all of the .jar files – exclude the Linux, Mac_OS_X, Solaris and Windows folders – and make sure
the Relative Path: option is selected.
Click Open and the selected files will show in the Compile-time Libraries list.
Click OK

netbeans_project_screen_6.png
Netbeans will now save and update the project – be patient whilst it updates – and you will begin to see the Warnings! disappear.
The screen below shows that all references to the Libraries have been resolved and your new uniCenta oPOS project is good to go!
netbeans_project_screen_8.png


Step 8: Set Main Class
Final check for you is to make sure the projects Main Class is set to com.openbravo.pos.forms.StartPOS
 
 
Enjoy!

Leave a Comment