Building CorDapps against a non-release branch

It is advisable to develop CorDapps against the most recent Corda stable release. However, you may need to build a CorDapp against an unstable non-release branch if your CorDapp uses a very recent feature, or you are using the CorDapp to test a PR on the main codebase.

To work against a non-release branch, proceed as follows:

  • Clone the Corda repository

  • Check out the branch or commit of the Corda repository you want to work against

  • Make a note of the gradlePluginsVersion in the root constants.properties file of the Corda repository

  • Clone the Corda Gradle Plugins repository

  • Check out the tag of the Corda Gradle Plugins repository corresponding to the gradlePluginsVersion

  • Follow the instructions in the readme of the Corda Gradle Plugins repository to install this version of the Corda Gradle plugins locally

  • Open a terminal window in the folder where you cloned the Corda repository

  • Publish Corda to your local Maven repository using the following commands:

  • Unix/macOS: ./gradlew install

  • Windows: gradlew.bat install

  • Make a note of the corda_release_version in the root build.gradle file of the Corda repository.
  • In your CorDapp’s root build.gradle file:
    • Update ext.corda_release_version to the corda_release_version noted down earlier.
    • Update corda_gradle_plugins_version to the gradlePluginsVersion noted down earlier - for Corda Enterprise Edition 4.12 this must be ext.corda_gradle_plugins_version = '5.1.1'.

Was this page helpful?

Thanks for your feedback!

Chat with us

Chat with us on our #docs channel on slack. You can also join a lot of other slack channels there and have access to 1-on-1 communication with members of the R3 team and the online community.

Propose documentation improvements directly

Help us to improve the docs by contributing directly. It's simple - just fork this repository and raise a PR of your own - R3's Technical Writers will review it and apply the relevant suggestions.

We're sorry this page wasn't helpful. Let us know how we can make it better!

Chat with us

Chat with us on our #docs channel on slack. You can also join a lot of other slack channels there and have access to 1-on-1 communication with members of the R3 team and the online community.

Create an issue

Create a new GitHub issue in this repository - submit technical feedback, draw attention to a potential documentation bug, or share ideas for improvement and general feedback.

Propose documentation improvements directly

Help us to improve the docs by contributing directly. It's simple - just fork this repository and raise a PR of your own - R3's Technical Writers will review it and apply the relevant suggestions.