FPC JVM: what changed

Revision 1 to 2. Removed lines have a minus sign; added lines have a plus sign.

Old	New		Line
1	1		## Overview
2	2
3	3		The FPC backend for the Java Virtual Machine (JVM) generates Java byte code that conforms to the specifications of the JDK 1.5 (and later), and also to the Dalvik VM from the Android platform. While not all FPC language features work when targeting the JVM, most do (or will in the future) and we have done our best to introduce as few differences as possible.
4	4
5	5		## Detailed information
6	6
7	7		- [[FPC JVM/Usage\|Basic usage information]]
8	8		- [[FPC JVM/Language\|Supported language constructs and other programming information]]
9	9		- [[FPC JVM/Debugging\|Help with debugging the Java class files]]
10	10		- [[FPC JVM/Building\|Building the compiler and Java utilities from source]]
11	11		- [[FPC JVM/Internals\|Information about internal changes to the compiler and RTL]] (mainly interesting to compiler/RTL developers)
12	12
13	13		## Download
14	14
15	15		Please check the official [download page](http://www.freepascal.org/download.var) for your platform to see whether a pre-built release of the JVM cross-compiler is available.
16	16
17	17		If your platform is not listed above, or if you are only interested in building the compiler/RTL from source, a separate archive that only contains the compiled Java components (Jasmin, javapp, BCEL) is also available. Building instructions for the compiler and are available via the "Building" link above.
18	18
19	19		- [FPC JVM utilities](ftp://ftp.freepascal.org/pub/fpc/contrib/jvm/fpcjvmutilities.zip) (you do not need this if you already downloaded an official release)
20	20
21	21		## Quick start
22	22
23	23		### Java or Android
24	24
25	25		By default, the compiler will generate code suitable for running on a Java Virtual Machine. If you wish to create Java class files that can be translated using the Android SDK into Dalvik code, add the -Tandroid compiler command line parameter.
26	26
27	27		For more detailed information about the development of apps for Android see [[FPC JVM Android Development\|here]].
28	28
29	29		### Compile a test program
30	30
31	31		The used example is <https://gitlab.com/freepascal.org/fpc/source/-/blob/main/tests/test/jvm/trange1.pp>
32	32
33		-	~~` ppcjvm -O2 -g trange1`~~
	33	+	```text
	34	+	ppcjvm -O2 -g trange1
	35	+	```
34	36
35	37		### Run it on Windows
36	38
37	39		Note: the path to the units has changed since the previous snapshots!
38	40
39		-	~~` java -cp C:\full\path\to\fpcjvm\units\jvm-java\rtl;. trange1`~~
	41	+	```text
	42	+	java -cp C:\full\path\to\fpcjvm\units\jvm-java\rtl;. trange1
	43	+	```
40	44
41	45		Replace C:\full\path\to\fpcjvm\units\jvm-java\rtl with the full path to the units\jvm-java\rtl directory from the snapshot archive.
42	46
43	47		### Run it on Unix-like platforms
44	48
45	49		Note: the path to the units has changed since the previous snapshots!
46	50
47		-	~~` java -cp /full/path/to/fpcjvm/units/jvm-java/rtl:. trange1`~~
	51	+	```text
	52	+	java -cp /full/path/to/fpcjvm/units/jvm-java/rtl:. trange1
	53	+	```
48	54
49	55		Replace /full/path/to/fpcjvm/units/jvm-java/rtl with the full path to the units/jvm-java/rtl directory from the snapshot archive.
50	56
51	57		### More details
52	58
53	59		See the [[FPC JVM/Usage\|usage information]] page for more details.
54	60
55	61		## See also
56	62
57	63		- [[Lazarus JVM]] Using Lazarus to build Java applications.
58	64
59	65		---
60	66		From the Free Pascal wiki, page "FPC JVM", as it stood on 2023-01-21 after a change by Peter.Dell, out of the wiki's dump of 2024-05-26. Copyright stays with the author who wrote it, according to the old wiki's [[Licensing]] page. If you have concerns about this material, [message the admin](/wiki-contact).
61	67		Category: FPC
62	68		Category: JVM

Back to history