A RetroSearch Logo

Home - News ( United States | United Kingdom | Italy | Germany ) - Football scores

Search Query:

Showing content from https://docs.pmd-code.org/latest/pmd_devdocs_building_general.html below:

Building PMD General Info | PMD Source Code Analyzer

Table of Contents Before Development
  1. Ensure that Git and Java JDK >= 11 are installed.
    You can get a OpenJDK distribution from e.g. Adoptium.
    Note: While Java 11 is required for building, running PMD only requires Java 8.
  2. Fork the PMD repository on GitHub as explained in Fork a repository.
  3. Clone your forked repository to your computer:
    git clone git@github.com:your_user_name/pmd.git --depth=10 --no-tags
    
  4. Clone additionally the build-tools repository. It contains some settings, we’ll later use for configuring IDE:
    git clone git@github.com:pmd/build-tools.git
    
  5. To make sure your Maven environment is correctly setup, we’ll build pmd once:

    cd pmd
    ./mvnw clean verify -DskipTests
    

    This will help with Maven IDE integration. It may take some time, because it will download all dependencies, so go brew some coffee to get ready for the steps to come.

Note:

This only clones the last ten commits and not the whole PMD repository. This makes it faster, as much less data needs to be downloaded. However, the history is incomplete. If you want to browse/annotate the source with the complete commit history locally, either clone the repo without the “depth” option or convert it to a “full” clone using git fetch --unshallow.

Reproducible Builds

Since PMD 6.24.0, we are creating Reproducible Builds. As we use Maven for building, the following limitations apply:

You can check the reproducible build status here: https://github.com/jvm-repo-rebuild/reproducible-central/blob/master/content/net/sourceforge/pmd/README.md

How to build the documentation?
cd docs
bundle install # once
bundle exec jekyll build

You’ll find the built site in the directory _site/.

For more info, see README in docs directory.

How to test SNAPSHOT builds?

Every push to our main branch creates a new SNAPSHOT build. You can download the binary distribution from https://sourceforge.net/projects/pmd/files/pmd/. The binary distribution ZIP file behaves exactly the same as the real release: Just unzip it and execute PMD.

If you integrate PMD as a dependency in your own project, you can also reference the latest SNAPSHOT version. However, you also need to configure an additional Maven Repository, as the SNAPSHOTS are not published in Maven Central.

Use the Central Portal Snapshot repository url: https://central.sonatype.com/repository/maven-snapshots/. For Maven projects, this can be configured like:

<repositories>
    <repository>
        <name>Central Portal Snapshots</name>
        <id>central-portal-snapshots</id>
        <url>https://central.sonatype.com/repository/maven-snapshots/</url>
        <releases>
            <enabled>false</enabled>
        </releases>
        <snapshots>
            <enabled>true</enabled>
        </snapshots>
    </repository>
</repositories>

Have a look at https://central.sonatype.com/service/rest/repository/browse/maven-snapshots/net/sourceforge/pmd/pmd/ to see which SNAPSHOT versions are available. Note that old SNAPSHOT versions might be removed without prior notice.

See also https://central.sonatype.org/publish/publish-portal-snapshots/.

General Development Tips

RetroSearch is an open source project built by @garambo | Open a GitHub Issue

Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo

HTML: 3.2 | Encoding: UTF-8 | Version: 0.7.4