]> git.argeo.org Git - cc0/argeo-build.git/blob - README
Close directory stream
[cc0/argeo-build.git] / README
1 Argeo Build is a minimalistic Java build system based on GNU make, which is meant to be used as a git submodule of a software layer following Argeo's conventions. It is using Java files directly as scripts, without prior compilation.
2
3 It is NOT meant as a generic Java build system.
4
5 ## Components
6 Argeo Build depends on the Eclipse ECJ Java compiler, and on the BND Tools library for OSGi metadata generation (and therefore on SLF4j).
7
8 - osgi.mk is included in the root Makefile of the layer being built
9 - configure configures a build environment
10 - Make.java compiles Java code, creates OSGi bundles based on the bnd.bnd file in each project
11 - Repackage.java downloads and repackages as OSGi bundles Maven artifacts or Eclipse releases (cf. Argeo TP)
12
13 ## Usage
14 For example usage, look at one of the core Argeo layers (typically Argeo Commons) on http://git.argeo.org :
15
16 git clone http://git.argeo.org/lgpl/argeo-commons.git --recursive
17 export JAVA_HOME=/usr/lib/jvm/java-17-openjdk-amd64/
18 ./argeo-commons/configure
19 cd argeo-commons
20 make clean all
21
22 Argeo Build is installed as a git submodule under
23 ./sdk/argeo-build/
24
25 In order to configure a new project, copy the file
26 configure.template
27 from this directory as
28 configure
29 at the root of the project, and make it executable:
30 chmod +x configure
31 git --chmod +x configure
32
33 ## Licensing
34 This code is in the public domain under the CC0 v1.0 license,
35 so that it can be used in any licensing context by Argeo or anyone else.