Building Opencms 9.5.x from the sources
m (Correct pull links) |
(How to match artifact versions) |
||
| Line 11: | Line 11: | ||
<source lang="bash">gradle bindist</source> | <source lang="bash">gradle bindist</source> | ||
| − | 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 jars<sup>2</sup>: | + | 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 jars<sup>2, 3</sup>: |
<source lang="bash">gradle install</source> | <source lang="bash">gradle install</source> | ||
| Line 21: | Line 21: | ||
<source lang="bash">git clone https://github.com/alkacon/alkacon-oamp.git -b branch_9_0_x</source> | <source lang="bash">git clone https://github.com/alkacon/alkacon-oamp.git -b branch_9_0_x</source> | ||
| − | 2. Execute the gradle <tt>bindist</tt> task<sup> | + | 2. Execute the gradle <tt>bindist</tt> task<sup>4</sup>: |
<source lang="bash">gradle bindist</source> | <source lang="bash">gradle bindist</source> | ||
| Line 47: | Line 47: | ||
I have written a pull-request to work around this issue: https://github.com/alkacon/opencms-core/pull/278 | I have written a pull-request to work around this issue: https://github.com/alkacon/opencms-core/pull/278 | ||
| − | 3. Currently, gradle fails with the following message: | + | 3. You need to match the version of the generated opencms-core artifacts to the version of the alkacon-oamp dependencies. The property <tt>version.number</tt> in the file <tt>opencms-core/src/org/opencms/main/version.properties</tt> defines the versions of the opencms-core artifacts. The property <tt>opencms_version</tt> of the file <tt>alkacon-oamp/gradle.properties</tt> declares the version of the dependencies: |
| + | |||
| + | {| class="wikitable" | ||
| + | |- | ||
| + | ! scope="col"|opencms-core/src/org/opencms/main/version.properties | ||
| + | ! scope="col"|alkacon-oamp/gradle.properties | ||
| + | |- | ||
| + | | | ||
| + | # Static version information file | ||
| + | # | ||
| + | # You should set this to something meaningful before you build. | ||
| + | <strong>version.number=9.5.x</strong> | ||
| + | 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 | ||
| + | <strong>opencms_version=9.5.x</strong> | ||
| + | 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 "<nowiki>http://apache.org/xml/features/disallow-doctype-decl</nowiki>" set to true. | > DOCTYPE is disallowed when the feature "<nowiki>http://apache.org/xml/features/disallow-doctype-decl</nowiki>" set to true. | ||
I have written a pull-request to fix this bug: https://github.com/alkacon/alkacon-oamp/pull/30 | I have written a pull-request to fix this bug: https://github.com/alkacon/alkacon-oamp/pull/30 | ||
Revision as of 13:52, 26 September 2014
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 tagged build_9_0_1 and executing gradle fails with the following message:
> Could not find property 'distribution' on configuration ':compile'.
2. Currently, the javadocs are broken and 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. The property 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
