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.|
|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.|
|Using the Eclipse IDE is also OK, but it will present some challenges when sychronizing development between these two IDE’s.|
|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.|
|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
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
|Step 3: Add uniCenta oPOS Sources|
Initially in this screen you will see that the Wizard has only imported src-beans, src-data and src-pos
|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
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.
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.
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
|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
|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!
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