# Building the code

## #Using Maven

To build from source, you need the following installed and available in your `$PATH:`

- Java 8

- Apache maven 3.3.4 or greater

After cloning the project, you can build it from source with this command:

    mvn clean install

If you don't have maven installed, you may directly use the included maven wrapper, and build with the command:

    ./mvnw clean install

## #Using Docker

You can use `run-in-docker.sh` to do all development. This script maps your local repository to `/gen` in the docker container. It also maps `~/.m2/repository` to the appropriate container location.

To execute `mvn package`:

    git clone https://github.com/openapitools/openapi-generatorcd openapi-generator./run-in-docker.sh mvn package

Build artifacts are now accessible in your working directory.

Once built, `run-in-docker.sh` will act as an executable for openapi-generator-cli. To generate code, you'll need to output to a directory under `/gen` (e.g. `/gen/out`). For example:

    ./run-in-docker.sh help # Executes 'help' command for openapi-generator-cli./run-in-docker.sh list # Executes 'list' command for openapi-generator-cli./run-in-docker.sh /gen/bin/generate-samples.sh /gen/bin/configs/go-petstore.yaml  # Builds the Go client./run-in-docker.sh generate -i modules/openapi-generator/src/test/resources/2_0/petstore.yaml \    -g go -o /gen/out/go-petstore --packageName=petstore # generates go client, outputs locally to ./out/go-petstore

### #Docker in Vagrant

Prerequisite: install Vagrant and VirtualBox.

    git clone https://github.com/openapitools/openapi-generator.gitcd openapi-generatorvagrant upvagrant sshcd /vagrant./run-in-docker.sh mvn package

### #Troubleshooting

If an error like this occurs, just execute the mvn clean install -U command:

> org.apache.maven.lifecycle.LifecycleExecutionException: Failed to execute goal org.apache.maven.plugins:maven-surefire-plugin:2.19.1:test (default-test) on project openapi-generator: A type incompatibility occurred while executing org.apache.maven.plugins:maven-surefire-plugin:2.19.1:test: java.lang.ExceptionInInitializerError cannot be cast to java.io.IOException

    ./run-in-docker.sh mvn clean install -U

> Failed to execute goal org.fortasoft:gradle-maven-plugin:1.0.8:invoke (default) on project openapi-generator-gradle-plugin-mvn-wrapper: org.gradle.tooling.BuildException: Could not execute build using Gradle distribution 'https://services.gradle.org/distributions/gradle-4.7-bin.zip'

Right now: no solution for this one :|

Edit this page
Last updated on 2020-9-3 by Jim Schubert

- Using Maven
- Using Docker
  - Docker in Vagrant
  - Troubleshooting