1 |
|
---|
2 | # Prerequisites to using the Release Kit code base
|
---|
3 |
|
---|
4 |
|
---|
5 | * Java JDK (min v1.6, typically v1.8 used, known to work with v1.11)
|
---|
6 | * Apache ant (min 1.8.2)
|
---|
7 | * C/C++ compiler (e.g., g++ for Linux, Microsoft Visual Studio for Windows, XCode for Mac)
|
---|
8 | * Subversion (min v1.8)
|
---|
9 |
|
---|
10 | Under Linux (to be confirmed why it is needed)
|
---|
11 |
|
---|
12 | * Set the LANG environment variable to use UTF-8, e.g., export LANG=en_NZ.UTF-8
|
---|
13 |
|
---|
14 |
|
---|
15 | One quick way to get going with these prerequisites is to checkout the 'local' folder
|
---|
16 | that corresponds to the OS and version Greenstone you are looking to use the
|
---|
17 | Release Kit on. For example:
|
---|
18 |
|
---|
19 | svn co https://svn.greenstone.org/local/greenstone3/windows-64bit gs3-local-windows64
|
---|
20 |
|
---|
21 | Then refer to the README.txt in the checked-out directory for further details.
|
---|
22 |
|
---|
23 |
|
---|
24 | # Getting Ready to use the Release Kit
|
---|
25 |
|
---|
26 | To use the Release Kit scripts, some source code needs to be compile first:
|
---|
27 |
|
---|
28 | ant compile
|
---|
29 |
|
---|
30 | And the Release Kits 'bin' directory added to your PATH.
|
---|
31 | For Linux, for example:
|
---|
32 |
|
---|
33 | export PATH=$PWD/bin:$PATH
|
---|
34 |
|
---|
35 | Or for Windows:
|
---|
36 |
|
---|
37 | set PATH=%CD%\bin;%PATH%
|
---|
38 |
|
---|
39 | Finally, for compilation compilation of JNI code in Greenstone3 to be able to
|
---|
40 | locate the necessary header files (e.g., jni.h), JAVA_HOME needs to be set,
|
---|
41 |
|
---|
42 | For example (on Ubuntu-16 32-bit):
|
---|
43 |
|
---|
44 | export JAVA_HOME=/usr/lib/jvm/java-8-openjdk-i386
|
---|
45 |
|
---|
46 | or (on Ubuntu-20 64-bit):
|
---|
47 |
|
---|
48 | export JAVA_HOME=/usr/lib/jvm/java-11-openjdk-amd64
|
---|
49 |
|
---|
50 |
|
---|
51 | To create a release, for example Greenstone 3 v3.11rc:
|
---|
52 |
|
---|
53 | mkdir releases
|
---|
54 | cd releases
|
---|
55 |
|
---|
56 | # In the following the redirect character (>) is hard up against the version number
|
---|
57 | # to avoid a space occuring at end of echo of the line output to the property file
|
---|
58 | echo version:3.11rc> rk3-build.properties
|
---|
59 |
|
---|
60 | rk3
|
---|
61 |
|
---|
62 |
|
---|
63 | More detailed notes at:
|
---|
64 |
|
---|
65 | http://wiki.greenstone.org/doku.php?id=en:developer:release_kits
|
---|
66 |
|
---|
67 | and
|
---|
68 |
|
---|
69 | http://wiki.greenstone.org/doku.php?id=internal:release_kits
|
---|