How To Contribute

[wimjongman]

Here is a video that explains the full cycle of contributing to BIRT.

https://youtu.be/FqfrG2I0AIw

00:00 Intro
00:40 Fork the main BIRT repository
02:00 Download the Eclipse Installer
03:10 Start Installation
05:20 Start Eclipse
05:50 Automatically configure the development environment
09:00 Running BIRT with your changes
12:00 Running Unit Tests
14:00 Making and pushing a change
16:00 Creating a Pull Request

[colinsutton]

I got as far as the 2 minute point. When I run the eclipse installer it pops up that java 1.8 is not compatible. After much searching I found java 11.0.12, installed it, disabled java 1.8 and set JAVA_HOME=C:\Program Files\Java\jdk-11.0.12. Found that the BIRT 4.4 report generator works fine with this setting:

java -version
java version "11.0.12" 2021-07-20 LTS
Java(TM) SE Runtime Environment 18.9 (build 11.0.12+8-LTS-237)
Java HotSpot(TM) 64-Bit Server VM 18.9 (build 11.0.12+8-LTS-237, mixed mode)
However, the eclipse installer is somehow still complaining:

[colinsutton]

Getting further now. After the eclipse installer ran, I made the position permanent. Selecting auto launch gives a blank screen. Chrome developer shows "DevTools failed to load source map: Could not load content for https://code.jquery.com/jquery.min.map: HTTP error: status code 404, net::ERR_HTTP_RESPONSE_CODE_FAILURE"

[wimjongman]

What do you mean by "selecting auto launch"?

[colinsutton]

[wimjongman]

Did you register the weblink? I tried chrome and it installs fine. Can you try with firefox or edge?

[colinsutton]

I followed the eclipse installer 'Install using drag and drop' instructions and have successfully built eclipse birt on windows 10 following the video up to the 9:51 point. Not so lucky on Mac OS 11.6.1, where the build failed (I'll report in a separate issue).

[merks]

The installer has a built-in JRE so that it runs even if no JRE is installed. But the instructions don't link to those, so I fixed that in the instructions.

https://git.eclipse.org/c/oomph/org.eclipse.oomph.git/commit/?id=000984a1f6265d83f1e5da6fcf7449b79c659bfc

If the clicking the launch button doesn't work with some particular browser, read the other instructions to use copy and apply or drag and drop.

[colinsutton]

The eclipse installer dialog came up with a blank box for entry of the JRE, so I browsed to my 11.0.12 JDK from Oracle and that was accepted. Do I need to download and install the JRE from oomph instead?

[merks]

No, it's fine to use a JRE or JDK installed on your computer. They keep changing the registry keys where they store the things so that yet again we don't find it automatically....