corda/docs/source/quickstart-index.rst
Ed Prosser a5ad24fc00 links updates
Signed-off-by: Ed Prosser <edward.prosser@r3.com>
2019-07-12 10:51:12 +02:00

2.8 KiB

Getting started developing CorDapps

quickstart-deploy quickstart-build

Getting started with Corda will walk you through the process of setting up a development environment, deploying an example CorDapp, and building your own CorDapp based on the example.

  1. Setting up a development environment
  2. Deploying an example CorDapp
  3. Building your own CorDapp

Setting up a development environment

Prerequisites

  • Java 8 JVK - We require at least version , but do not currently support Java 9 or higher.
  • IntelliJ IDEA - IntelliJ is an IDE that offers strong support for Kotlin and Java development. We support versions 2017.x, 2018.x and 2019.x (with Kotlin plugin version )
  • Gradle - Gradle is a build automation tool that we use for dependency management. We use version 4.10 and the gradlew script in the project/samples directories will download it for you.
  • Git - We use Git to host our sample CorDapp and provide version control.

Step One: Downloading a sample project

  1. Open a command prompt or terminal.
  2. Clone the CorDapp example repo by running: git clone https://github.com/corda/cordapp-example
  3. Move into the cordapp-example folder by running: cd cordapp-example
  4. Checkout the corresponding branch by running: git checkout release-V4 in the current directory.

Step Two: Creating an IntelliJ project

  1. Open IntelliJ. From the splash screen, click Open, navigate to and select the cordapp-example folder, and click Ok. This creates an IntelliJ project to work from.
  2. Once the project is open, click File > Project Structure. Under Project SDK:, set the project SDK by clicking New..., clicking JDK, and navigating to C:\Program Files\Java\jdk1.8.0_XXX on Windows or Library/Java/JavaVirtualMachines/jdk1.8.XXX on MacOSX, where XXX is the latest minor version number. Click Ok. This instructs IntelliJ to use the version of the Java JDK downloaded in the prerequisites.
  3. Click File > Project Structure, select Modules. Click +, > Import Module, then select the cordapp-example folder and click Open. Select Import module from external model > Gradle > Next > Finish > Ok. Gradle will now download all the project dependencies and perform some indexing.

Your CorDapp development environment is now complete.

Next steps

Now that you've successfully set up your CorDapp development environment, we'll cover deploying an example CorDapp locally, before writing a CorDapp from scratch.