Revision as of 04:16, 17 November 2010

Project Space

• Heng Sin implementation of OSGI is done in another project space under Kenai.
• His version is based on 3.6.0LTS
• It is considered alpha stage as certain issues such as Java Client Webstart and refactoring is pending testing.
• It is due for better use in 2011.

Improvements

• One of the improvements there is the Workflow Editor where boxes look more UML-like.

Backyard Info

• There is something newbie setup experience documented here.

OSGI Roadmap - November 2010

• Hengsin is doing more refactoring to the source in his Kenai repository.
  • Callout package is now a separate bundle but Hengsin wants to rewrite it when he can find time later.
  • Buckminster, a Maven-like plugin in Eclipse is used to manage the import of plugins and builds.
  • The source is launchable from Eclipse for ZKAjax UI and SwingClient.
  • Hengsin is trying to release a beta candidate in a month or so.
  • Meanwhile Redhuan D. Oon is writing up his own guide and experience as led by Hengsin in his new OSGI update.
  • More feedback on tests will be organised and reported in the Kenai project forum.

Note to MacBook users

• Apple Mac OSX has an issue with launching X on 2nd thread and this is solved by removing the -ws ${target.ws} argument in the launch script. (Hengsin)
• When debugging from Eclipse, you may need to hack the Tomcat.server.xml to point to your port 8088, and https to 4443

Preparing Your Eclipse IDE

• You should use the latest Helios version with Equinox and Buckminster plugins udpated.

Getting the Kenai Project into your Eclipse

• Firstly you should have got a HG Clone into your PC from the Mercurial repository.
• In a fresh workspace of Eclipse, you create a new empty EquinoxTarget.platform (via Preferences>Plugin)
• Then Import Projects > Select an import source from Buckminster > Materialize from Buckminster.
  • Browse for the URL under the plugin org.adempiere.sdk.feature selecting the adempiere.cquery.
  • Eclipse will import from the web all the needed plugins into the new target platform folder you created.

Launching from Eclipse

• Under the Run As Configurations you will see some launch items.
• Select install.app (CLI) or install.console.app (GUI) to set the properties file. This is similar to RUN_setup in ADempiere speak.

• Launch server.product (RUN_Server2.sh in ADempiere speak) to get the Web UI working.
  • You now need to access the Web UI using, http://<localhost>:<port>/ without the /admin suffix.
• Launch swingclient.product to get the JavaClient up and running.

Build and deploying binary

• Go to the plugin (at your Eclipse Package Explorer) right click at org.adempiere.server-feature
• Select Buckminster > Invoke Action
• Select create.product
• In the Properties file line, select workspace again the same i.e. org.adempiere.server-feature drill down to buckminster.properties (or any other depending on your OS) and you should end up with something like: /Users/red1/Documents/workspace/hengsin~development/org.adempiere.server-feature/buckminster.properties in the field. Give it an OK.
• Press OK to the Buckminster action dialog box and this will take some minutes to compile
• Find under your desktop a buckminster.output folder
  • Look for a particular folder that contains adempiere-server folder. (hint:org.adempiere.server_1.0.0-eclipse.feature).
  • Put that to your Applications-Home location and continue in ADempiere speak.