~i2p.packages/i2p/trunk

4236 by kytv
Allow some variables to be changed by end-users during build by use of a
1
# These properties can be set to alter the build process.
2
#
3
# This file contains default values that are used by official I2P installers.
4
#
5
# End-users *should not* edit this file. If you want to change the values, make a
6
# copy, call it override.properties, and make the desired changes to that.
7
8
################################################################################
9
10
# Javadocs
11
# Note: Include the trailing slash! Don't surround the URL in quotes!
6411 by zzz
Build: Update javadoc links to Java 7
12
javasedocs.url=http://docs.oracle.com/javase/7/docs/api/
13
javaeedocs.url=http://docs.oracle.com/javaee/7/api/
6985 by zzz
Debian: Replace glassfish-javaee with libtaglibs-standard-* (ticket #2093)
14
# The following link is for 9.4.x
15
#jettydocs.url=http://download.eclipse.org/jetty/stable-9/apidocs/
6738 by zzz
Javadoc: Update Jetty URL and package-list
16
jettydocs.url=http://download.eclipse.org/jetty/9.2.21.v20170120/apidocs/
4236 by kytv
Allow some variables to be changed by end-users during build by use of a
17
wrapperdocs.url=http://wrapper.tanukisoftware.com/jdoc/
4736 by zzz
unit test javadocs
18
# these are only for unit test javadocs
19
i2pdocs.url=http://docs.i2p-projekt.de/javadoc/
20
junitdocs.url=http://junit.org/apidocs/
4761.6.32 by zzz
* Build: Add built-by to jars; check for corrupt jars on debug page
21
# This will go in the jar manifests
5315 by kytv
remove extranous reference (that I added) to junit; fix a bit more of the
22
build.built-by=unknown
4797 by kytv
Add note about 32bit libs
23
5251 by kytv
add more excludes to 'sloccount.report' and make the report location configurable
24
# filename of the sloccount report
25
sloccount.report.file=sloccount.sc
26
5263 by kytv
* new ant targets
27
# Uncomment the next line to prevent "ant debian" from automatically
28
# updating the changelog
29
#noAutoDebchange=true
30
4878.1.10 by kytv
update comments
31
# Building EXEs in x64 Linux requires that 32bit libraries are installed. In Debian,
32
# for example, installing the libc6-i386 package will satisfy this requirement.
33
# Uncomment the next line to prevent building EXEs (changing it to false will have no impact)
7862 by zab2
revert accidental commit
34
#noExe=true
4878.1.135 by zzz
move default properties from build.xml to build.properties
35
7509.1.1 by zzz
Installer: Add support for IzPack 5 (ticket #1864)
36
# IzPack 5.1.x install dir
7938 by zzz
Build:
37
# Default is $HOME/IzPack
7509.1.1 by zzz
Installer: Add support for IzPack 5 (ticket #1864)
38
#izpack5.home=/PATH/TO/IzPack
7996.1.24 by zzz
Installer: Fix -console install for izpack 5 (ticket #2492)
39
# Default is 5.1.3
40
#izpack5.version=5.1.3
7509.1.1 by zzz
Installer: Add support for IzPack 5 (ticket #1864)
41
5346 by kytv
don't run gettext if 'require.gettext' is set to false
42
# Change this to false if you don't have gettext or you want to prevent it from running during the build
7862 by zab2
revert accidental commit
43
require.gettext=true
4878.1.135 by zzz
move default properties from build.xml to build.properties
44
5918 by zzz
target build property
45
# Compile for this version of Java
8675 by zzz
Build: Force Java 7 for mavencentral jars used by Android
46
#javac.version=1.8
8820 by zzz
Build: Set javac release property (ticket #2775)
47
#javac.release=8
5918 by zzz
target build property
48
4878.1.135 by zzz
move default properties from build.xml to build.properties
49
# Additional classpath if required
5012.1.5 by zzz
typo
50
#javac.classpath=/PATH/TO/pack200.jar
4878.1.135 by zzz
move default properties from build.xml to build.properties
51
52
# Optional compiler args
53
# This one keeps gcj a lot quieter
54
#javac.compilerargs=-warn:-unchecked,raw,unused,serial
5234 by str4d
Documented required and optional test-related properties in build.properties
55
6142.1.99 by zzz
Notes and logging re: compiling with Java 8
56
#
57
# Note to packagers, embedders, distributors:
58
#
59
# Strictly speaking, you must either use the compiler for the minimum Java version you are
8672 by zzz
Build: Remove javac.compilerargs7 build property (ticket #2511)
60
# targeting (default 1.8, see above), or specify a bootclasspath, which means you need
6142.1.99 by zzz
Notes and logging re: compiling with Java 8
61
# the JRE for the target version installed as well.
62
#
8672 by zzz
Build: Remove javac.compilerargs7 build property (ticket #2511)
63
# You cannot compile with 1.8 and target 1.6 or 1.7 without bootclasspath,
6142.1.99 by zzz
Notes and logging re: compiling with Java 8
64
# or your users will get runtime errors.
65
# Below is an example of a bootclasspath that works on Ubuntu.
66
#
67
# For more info:
68
#    http://zzz.i2p/topics/1668
69
#    https://gist.github.com/AlainODea/1375759b8720a3f9f094
70
#
8820 by zzz
Build: Set javac release property (ticket #2775)
71
# Do NOT set bootclasspath when compiling with Java 9 or higher.
72
#
6560 by zzz
Build: Set Java 7 build target for all jars;
73
# For embedded use only, and for a limited time,
74
# the following subsystems ONLY may be built with Java 6 by setting javac.version=1.6 in override.properties,
75
# and setting javac.compilerargs to use java 6 jars:
76
# core, router, ministreaming, streaming, addressbook, i2ptunnel, BOB
77
# Use the buildX ant targets to build these (see build.xml).
78
# We may start using Java 7 features in these subsystems at any time and without notice.
6142.1.99 by zzz
Notes and logging re: compiling with Java 8
79
#javac.compilerargs=-bootclasspath /usr/lib/jvm/java-6-openjdk-amd64/jre/lib/rt.jar:/usr/lib/jvm/java-6-openjdk-amd64/jre/lib/jce.jar
6560 by zzz
Build: Set Java 7 build target for all jars;
80
#
8672 by zzz
Build: Remove javac.compilerargs7 build property (ticket #2511)
81
# For standard builds, set the following in override.properties:
6560 by zzz
Build: Set Java 7 build target for all jars;
82
#
8672 by zzz
Build: Remove javac.compilerargs7 build property (ticket #2511)
83
#javac.compilerargs=-bootclasspath /usr/lib/jvm/java-8-openjdk-amd64/jre/lib/rt.jar:/usr/lib/jvm/java-8-openjdk-amd64/jre/lib/jce.jar
6142.1.99 by zzz
Notes and logging re: compiling with Java 8
84
85
5310 by kytv
allow setting hamcrest and junit locations with properties
86
### UnitTests ##
6308.1.370 by str4d
Separate out streaming integration tests, make them optional
87
# Uncomment the next line to enable integration tests.
88
# These require a running router with I2CP available on 127.0.0.1:7654.
89
#runIntegrationTests=true
90
5234 by str4d
Documented required and optional test-related properties in build.properties
91
# Location of the libraries required for the ScalaTest tests.
92
# Define this in override.properties or pass in on the command line.
93
# The directory must contain the following library names:
94
# scala-compiler.jar
95
# scala-library.jar
6642 by str4d
Update tests to use ScalaTest 3.0.1
96
# scala-reflect.jar
97
# scala-xml.jar
98
# scalactic.jar
5234 by str4d
Documented required and optional test-related properties in build.properties
99
# scalatest.jar
6642 by str4d
Update tests to use ScalaTest 3.0.1
100
# Tested using Scala 2.12.1, scala-xml 1.0.6, and ScalaTest 3.0.1
5234 by str4d
Documented required and optional test-related properties in build.properties
101
#scalatest.libs=/PATH/TO/SCALATEST/lib
102
5310 by kytv
allow setting hamcrest and junit locations with properties
103
# Location of the junit libraries
104
# Defaults to the ant library path if not set.
5315 by kytv
remove extranous reference (that I added) to junit; fix a bit more of the
105
# If set, this must point to a directory that contains the file junit4.jar
6807 by zzz
show suggested paths
106
# Debian/Ubuntu: sudo apt-get install junit4
107
#junit.home=/usr/share/java
5310 by kytv
allow setting hamcrest and junit locations with properties
108
109
# Location of the hamcrest libraries
110
# Defaults to the ant library path if not set
111
# If set, this must point to a directory containing the files
112
#       hamcrest-core.jar, hamcrest-library.jar, and hamcrest-integration.jar
6642 by str4d
Update tests to use ScalaTest 3.0.1
113
# Tested using Hamcrest 1.3
6807 by zzz
show suggested paths
114
# Debian/Ubuntu: sudo apt-get install libhamcrest-java
115
#hamcrest.home=/usr/share/java
5310 by kytv
allow setting hamcrest and junit locations with properties
116
6308.1.366 by str4d
Add Mockito library hooks
117
# Location of the mockito libraries
118
# Defaults to the ant library path if not set
119
# If set, this must point to a directory containing the files
120
#       mockito-core.jar, byte-buddy.jar, objenesis.jar
6642 by str4d
Update tests to use ScalaTest 3.0.1
121
# Tested using Mockito 2.5.0 which requires byte-buddy 1.5.12 and objenesis 2.4
6308.1.366 by str4d
Add Mockito library hooks
122
#mockito.home=
123
5234 by str4d
Documented required and optional test-related properties in build.properties
124
# Optional properties used in tests to enable additional tools.
125
#with.cobertura=/PATH/TO/cobertura.jar
126
#with.clover=/PATH/TO/clover.jar
6185 by zzz
* Build: Add support for bundling router infos in the package
127
6902 by str4d
Add a benchmarks subproject
128
129
### Benchmarks ##
130
# Location of the JMH libraries
131
# Defaults to the ant library path if not set
132
# If set, this must point to a directory containing the files
133
#       jmh-core.jar, jmh-generator-annprocess.jar, jopt-simple.jar, commons-math3.jar
134
# Tested using JMH 1.19 which requires jopt-simple 4.6 and commons-math3 3.2
135
#jmh.home=
136
137
6185 by zzz
* Build: Add support for bundling router infos in the package
138
### Bundle router infos ###
139
# Set to bundle router infos from your local I2P install in the package
140
#bundle.routerInfos=true
141
#bundle.routerInfos.count=200
142
#bundle.routerInfos.i2pConfigDir=/PATH/TO/.i2p
6308.32.2 by zzz
Debian:
143
144
### Debian/Ubuntu packages ###
7490 by zzz
Debian: Add build option for reproducible builds;
145
# uncomment to try to make the build reproducible; work in progress
146
#build.reproducible=true
6308.32.2 by zzz
Debian:
147
# Don't include geoip files, we will use geoip-database package
148
#with-geoip-database=true
6308.34.13 by zzz
Move setting of InstanceManager to WebAppConfiguration to avoid race
149
# Don't include jetty files, we will use libjetty9-java package. Requires with-libtomcat8-java=true.
6308.34.10 by zzz
Debian builds:
150
#with-libjetty9-java=true
6582 by zzz
Build: Add support for using libtomcat8-java package, untested
151
# Don't include tomcat files, we will use libtomcat8-java package
152
#with-libtomcat8-java=true
7729.1.142 by zzz
Debian: Add build option for libtomcat9 (ticket #2364)
153
# Don't include tomcat files, we will use libtomcat9-java package
154
#with-libtomcat9-java=true
6985 by zzz
Debian: Replace glassfish-javaee with libtaglibs-standard-* (ticket #2093)
155
# Don't include jstl.jar and standard.jar, we will use libtaglibs-standard-* packages
156
#with-libtaglibs-standard=true
6308.1.547 by zzz
Debian: Add dependency on glassfish-javaee for jstl.jar and standard.jar version 1.2
157
# Don't include jstl.jar and standard.jar, we will use glassfish-javaee package
158
#with-glassfish-javaee=true
6308.1.548 by zzz
Debian:
159
# Don't include standard.jar, we will use libjakarta-taglibs-standard-java package
160
#with-libjakarta-taglibs-standard-java=true
161
# Don't include jstl.jar, we will use libjstl1.1-java package
162
#with-libjstl1.1-java=true
6376 by zzz
Debian: Add runtime dependency on gettext-base,
163
# Don't compile GettextResource.java, we will use libintl.jar from the gettext-base package
164
#with-gettext-base=true
6390 by zzz
Debian: Add runtime dependency on libhttpclient-java,
165
# Don't compile gnu.getopt classes, we will use libgetopt-java package
6377 by zzz
Debian: Add runtime dependency on libgetopt-java,
166
#with-libgetopt-java=true
7489 by zzz
Debian: Add dependency for famfamfam-flag-png (ticket #2270)
167
# Don't bundle flags, we will use famfamfam-flag-png package
168
#with-famfamfam-flag-png=true
7719 by zzz
Debian: Add libjson-simple-java dependency
169
# Don't include json-simple library, we will use libjson-simple-java package
170
#with-libjson-simple-java=true
6390 by zzz
Debian: Add runtime dependency on libhttpclient-java,
171
# Don't compile org.apache.http classes, we will use libhttpclient-java and libhttpcore-java packages
6393 by zzz
Debian: Back out libhttpclient-java dependency,
172
# 2 MB of dependencies vs. 20 KB of copied source
173
# Requires 4.4 or higher.
174
# Debian: Not in wheezy/jessie
175
# Ubuntu: Only in wily and later
6390 by zzz
Debian: Add runtime dependency on libhttpclient-java,
176
#with-libhttpclient-java=true
7655 by zzz
Build: Provide option to prevent Class-Path in manifests (ticket #2317)
177
178
### Redhat packages ###
179
# uncomment to prevent classpaths in jar manifests
180
# https://fedoraproject.org/wiki/Packaging:Java
181
# without-manifest-classpath=true