Building Opencms 9.5.x from the sources
Note: this is work in progress
Building opencms-core
1. Checkout the sources of the 9_0_x branch1:
git clone https://github.com/alkacon/opencms-core.git -b branch_9_0_x
2. Execute the gradle bindist task:
gradle bindist
3. If you want to also build the opencms oamp, v8 or v7 modules, you also need to install in your local maven repository the corresponding jars2, 3:
gradle install
Building alkacom-oamp
1. Checkout the sources of the 9_0_x branch
git clone https://github.com/alkacon/alkacon-oamp.git -b branch_9_0_x
2. Execute the gradle bindist task4:
gradle bindist
Notes
1. Checking out the build tagged build_9_0_1 and executing gradle fails with the following message:
> Could not find property 'distribution' on configuration ':compile'.
2. The current javadocs are broken and when using Java 8+, gradle fails with the following message:
[...] 100 errors 100 warnings :javadoc FAILED FAILURE: Build failed with an exception. * What went wrong: Execution failed for task ':javadoc'. [...]
I have written a pull-request to work around this issue: https://github.com/alkacon/opencms-core/pull/278
3. You need to match the version of the generated opencms-core artifacts to the version of the alkacon-oamp dependencies. Since commit 89e10779f43cd8bcc31f7db9d60193a89994c948<tt> (from 2014-04.02, already in 9_5_x), the property <tt>version.number in the file opencms-core/src/org/opencms/main/version.properties defines the versions of the opencms-core artifacts. The property opencms_version of the file alkacon-oamp/gradle.properties declares the version of the dependencies:
opencms-core/src/org/opencms/main/version.properties | alkacon-oamp/gradle.properties |
---|---|
# Static version information file # # You should set this to something meaningful before you build. version.number=9.5.x version.id=Manual build build.number=(not set) build.date=(not set) nicename.build.number=Build Number nicename.build.date=Build Date # This has no nice name on purpose (for test cases) build.info=Static version file |
build_directory=../../BuildOAMP opencms_version=9.5.x java_target_version=1.6 max_heap_size=1024m # all available modules modules_oamp_all=\ com.alkacon.opencms.commons,\ com.alkacon.opencms.calendar,\ com.alkacon.opencms.documentcenter,\ [...] |
4. Currently, gradle fails with the following message:
> DOCTYPE is disallowed when the feature "http://apache.org/xml/features/disallow-doctype-decl" set to true.
I have written a pull-request to fix this bug: https://github.com/alkacon/alkacon-oamp/pull/30