Skip to content

Latest commit

 

History

History
79 lines (49 loc) · 2.69 KB

CONTRIBUTING.adoc

File metadata and controls

79 lines (49 loc) · 2.69 KB

Contributing to flutter-maven-plugin

Installing the correct versions of Java, Maven and necessary dependencies

flutter-maven-plugin is currently built on top of JDK 11.

Contributors, and CI/CD agents are bot expected to use Zulu JDK

Dependency management is handled by Maven v3.8.x

To check if you are using the correct version of Java, you may run java -version, which should display something similar:

openjdk version "11.0.14" 2022-01-18 LTS
OpenJDK Runtime Environment Zulu11.54+23-CA (build 11.0.14+9-LTS)
OpenJDK 64-Bit Server VM Zulu11.54+23-CA (build 11.0.14+9-LTS, mixed mode)

Checking Maven version is done via running mvn -version, which should display something similar to:

Apache Maven 3.8.4 (9b656c72d54e5bacbed989b64718c159fe39b537)
Maven home: /opt/homebrew/Cellar/maven/3.8.4/libexec

Code Structure

This project follows a standard Java project structure, governed by Maven.

TODO: JNG-3832 improve section explaining sub-module functionality

Submission Guidelines

Submitting an Issue

Before you submit an issue, please search the issue tracker. An issue for your problem may already exist and has been resolved, or the discussion might inform you of workarounds readily available.

We want to fix all the issues as soon as possible, but before fixing a bug we need to reproduce and confirm it. Having a reproducible scenario gives us wealth of important information without going back and forth with you requiring additional information, such as:

  • the output of java -version, mvn -version

  • pom.xml or .flattened-pom.xml (when applicable)

  • and most importantly - a use-case that fails

A minimal reproduction allows us to quickly confirm a bug (or point out a coding problem) as well as confirm that we are fixing the right problem.

We will be insisting on a minimal reproduction in order to save maintainers' time and ultimately be able to fix more bugs. We understand that sometimes it might be hard to extract essentials bits of code from a larger codebase, but we really need to isolate the problem before we can fix it.

You can file new issues by filling out our issue form.

Submitting a PR

This project follows GitHub’s standard forking model. Please fork the project to submit pull requests.

About the working Continous Integration pipeline, please read the corresponding CI Flow documentation!

Commands

Run Tests

$ mvn clean test

Run Full build

$ mvn clean install