Read Me

JavaVCL - VCL Style Library for FreePascal JVM
==============================================

JavaVCL is a FCL/VCL/LCL style library for FreePascal JVM. Due to limits with FPC-JVM, 
it isn't possible to port FCL/LCL, so a complete rewrite is needed.

Most of the low level classes are done. I have decided to commit to the JVM, so, this 
library will improve as I develop new software.

NOTE: FPCJVM v3.0.2rc is now in the JavaVCL repo. The official releases will not work due to a bug.

Installation Requirements
=========================

1) Java 
-> https://java.com/en/download/

2) Lazarus 
-> https://sourceforge.net/projects/lazarus/

3) FreePascal JVM 
-> http://wiki.freepascal.org/FPC_JVM

4) JavaVCL 
-> https://sourceforge.net/p/javavcl/code/HEAD/tree/

How to Install JavaVCL
======================

The following guide is for Windows, but it should be the same for Linux/Mac.

STEP 1) Download & Install Java

https://java.com/en/download/

STEP 2) Download the latest snapshot of JavaVCL

https://sourceforge.net/p/javavcl/code/HEAD/tree/

Copy the snapshot to your work area. Note, FPC_JVM has problems
with paths which contain spaces.

STEP 3) Open Lazarus and change compiler options.

Change FPC compiler to the JavaVCL FPC compiler via  Menu->Tools->Options
eg: "C:\dev\javavcl\fpc\bin\i386-win32\ppcjvm.exe" 

Switch off the debugger.
Tip: "Menu->Tools->Options->Debugger"

!! 
You will need to close and restart Lazarus for the new settings to be detected 
!!

STEP 7) Load one of the JavaVCL example projects into Lazarus.

If all went well, you should be able to compile and run JavaVCL projects.

NOTE: The following steps were successfully tested on Windows XP & Windows Vista. 
If you have problems, please:

1) Check and repeat the above steps.
2) Ask for help at the Lazarus forum.
3) Read the online FPC-JVM documentation.

If you still have problems, send me an email, but Im often a little busy.

Help Required
=============

Are you interested in helping with this project? Feel free to send any
well written custom components/libraries to myself.

cheers
Derek