OpenbravoPOS Developer guide/nl
Languages: |
English | Français | Italiano | Nederlands | zh cn | Translate this article... |
Contents |
Introductie
Deze handleiding is bestemd voor Openbravo POS 2.30 en latere versies. Dit document is gericht op ontwikkelaars en geadvanceerde gebruikers van Openbravo POS die beschikken over enige ontwikkelings vaardigheden en de source code willen inspecteren of modificeren.
Verkrijgen van de source
Sinds 2.30 hebben we onze software van het controle systeem veranderd van Subversion naar Mercurial. Het is niet meer mogelijk om de laatste source code van de Openbravo servers te halen met Subversion. Je zult een Mercurial client moeten installeren om dat te bereiken. Echter worden onze servers ten alle tijde gesynchroniseerd met de SourceForge servers wat betekent dat je de source kan verkrijgen vanaf SourceForge op de oude manier.
Sources van SourceForge met Subversion
Om toegang te krijgen tot de opslag van Subversion zul je een Subversion client moeten installeren. De huidige ontwikkelingen in de source van Openbravo POS kunnen bekeken worden via Subversion met het volgende commando:
svn co https://openbravopos.svn.sourceforge.net/svnroot/openbravopos/trunk openbravopos
Als je de source van Openbravo POS al bekeken hebt kun je je source updaten door het volgende commando in te voeren in de map waarin je kijkt:
svn up
Voor meer informatie over de Subversion opslag van Openbravo POS beschikbaar vanaf SourceForge ga naar http://sourceforge.net/svn/?group_id=127939.
Sources from Openbravo using Mercurial
To obtain the sources a Mercurial client is required. You can read the Mercurial manual prepared for Openbravo's developers. You only need to read the section to obtain the latest sources and updating.
To obtain(checkout in svn) a clone of the repository you should type the following commands:
hg clone https://code.openbravo.com/pos/devel/main/
To check if there are any updates type the following:
hg incoming
If there are any changes you can update your clone typing:
hg pull
One of advantages using Mercurial than Subversion is availability to review locally the logs of any changes:
hg log
Obtaining the sources of the stable version
To download the sources of the latest stable version or a previous version go to the download page and get the sources http://sourceforge.net/project/showfiles.php?group_id=127939. Once downloaded uncompress it to the desired folder.
Build from the sources
To build the Openbravo POS sources you need ant. Ant is a build tool used by Openbravo POS to compile and package the distribution files from the sources.
The binary and source packages can both be obtained executing the following instruction from the folder you downloaded or checked out the sources:
ant dist
There are other ant targets if you only need one specific package:
To obtain the package openbravopos.jar execute the following instruction:
ant jar
To obtain the binary distribution package execute:
ant dist.bin
To obtain the sources distribution package execute:
ant dist.src
Notes: All the packages created by the build process are located in the subfolder build/dist.
Build installers from sources
To build installers of Openbravo POS follow the tutorial.
Edit the sources using the Netbeans IDE
Netbeans is the preferred java IDE to develop Openbravo POS because the Swing components of Openbravo POS has been developed with the visual editor of Netbeans and this edition is stored in *.form files that only Netbeans is able to interpret.
You can download Netbeans from http://www.netbeans.org. And there is a quick guide to develop with Netbeans here http://www.netbeans.org/kb/60/java/quickstart.html.
To create a new Netbeans project with the Openbravo sources, open Netbeans and select New project... to open the new project wizard, select Java Project with Existing Sources and press Next.
In the following step select the project name and the folder where the Netbeans project files will be stored and press Next. Do not select the same folder you downloaded or checked out the sources.
In the following step select the source folders. Add the folders locales, reports, src-beans, src-data, src-erp, and src-pos. In this step you can press Finish.
The next step is to add the libraries needed to build and execute Openbravo POS. Open the Properties... dialog of the project and in the libraries section add all the *.jar files of the folder lib.
Now you have ready a Netbeans project configured than you can edit, build and test. To execute and debug Openbravo POS you need also to select the main class of the project. Open the Properties... dialog and in the run section Openbravo select com.openbravo.pos.forms.StartPOS as the Main Class and press OK.
Edit the sources using the Eclipse IDE
If your favorite java IDE is Eclipse you can use it to develop Openbravo POS. You will only miss the visual edition of the swing components created with Netbeans. In this case you must take into account that if you modify the java code generated by Netbeans, then the Netbeans user will not have in sync your modifications and may overwrite it the next time.
You can download Eclipse from http://www.eclipse.org/. And there is a guide to develop with Eclipse here: http://www.eclipse.org/documentation/.
The Eclipse project files are included in the source packages. To create new Eclipse project is very easy, open Eclipse and select Import... to open the import project wizard, select Existing projects into workspace and press Next.
In the following step select the root folder of the Openbravo POS sources and press Finish.
Now you have ready your Eclipse project. To execute it, select the project run it as a Java application and select the com.openbravo.pos.forms.StartPOS as the main class.
Edit the PDA module sources using the Netbeans IDE
You can download Netbeans from http://www.netbeans.org. To work with PDA module Netbeans must be fitted with JEE.
To create a new Netbeans project with the Openbravo sources, open Netbeans and select New project... to open the new project wizard, select Web Application with Existing Sources and press Next.
In the following step select the src-pda folder that has been downloaded within the trunk. Then set a name and the folder where the Netbeans project files will be stored and press Next. Do not select the same folder you downloaded or checked out the sources.
In the following step select server that will manage our application. Select Java EE 5 and choose a context path i.e.pda that will be used to call the application within an url. Then you can press Next.
The next step is about sources. Web Pages Folder is a folder where all web pages are stored it can be find with the rest of the sources in the trunk. WEB-INF Content contains files to make the pda module working on the server. In Libraries Folder are all needed libraries to build and execute Openbravo POS PDA module. At the end the source package must be added as it is shown on a picture. Then Finish button should be pressed to finish building a new project with existing sources.
The last thing needed to run the project is a database driver library. The same connector as in Openbravo POS must be added to the PDA module. In this case this is mysql-connector-java-5.1.5.jar
To add the connector go into Properties of the pda project and then to Libraries and add the jar file. After finding the connector Ok can be pressed and the project is ready to edit, build and test.