Mercurial > cgi-bin > hgweb.cgi > ImagePrep
comparison Building.rst @ 27:404eb7e57fe6
Standardize things for Linux packaging.
| author | David Barts <n5jrn@me.com> |
|---|---|
| date | Fri, 25 Dec 2020 18:58:45 -0800 |
| parents | |
| children |
comparison
equal
deleted
inserted
replaced
| 26:9bf3d8de6904 | 27:404eb7e57fe6 |
|---|---|
| 1 [This file automatically generated by pandoc from 'Building.html'.] | |
| 2 | |
| 3 Building ImagePrep | |
| 4 ================== | |
| 5 | |
| 6 ImagePrep is a pure Java application. As such it is easy to build: | |
| 7 | |
| 8 Install prerequisites: | |
| 9 | |
| 10 a. `Apache Ant <https://ant.apache.org/>`__ | |
| 11 b. `Launch4j <http://launch4j.sourceforge.net/>`__, if you are building | |
| 12 on Windows | |
| 13 c. Java JDK 1.8 or better (see notes below). | |
| 14 d. `Kotlin <https://kotlinlang.org/>`__ | |
| 15 | |
| 16 Type ``ant clean`` to be sure you’re starting with a clean slate. | |
| 17 | |
| 18 Use one of the following commands: | |
| 19 | |
| 20 a. ``ant jar`` — to build a “fat JAR” containing the application (and | |
| 21 the Kotlin runtime) | |
| 22 b. ``ant macapp`` — to build a Macintosh application | |
| 23 c. ``ant deb`` — to build a Debian package for the Gnome desktop | |
| 24 d. ``ant winapp`` — to build a Windows application (requires | |
| 25 `Launch4j <http://launch4j.sourceforge.net/>`__) | |
| 26 | |
| 27 Which Version of Java to Use? | |
| 28 ----------------------------- | |
| 29 | |
| 30 In short, Java 1.8. Most systems don’t yet have OpenJDK 11 or greater | |
| 31 installed, so using a compiler newer than 1.8 is asking for trouble. All | |
| 32 code *should* build on OpenJDK 11 or greater, with the exception of the | |
| 33 OS-dependent code for the Macintosh (which will have to be recoded to | |
| 34 use the ``java.awt.Desktop`` class). The latter would be a net win, as | |
| 35 it is portable, and would spell the death of the only bit of | |
| 36 OS-dependent Kotlin code in this application. |