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'.