ExternalVendorCode/corda
1
0
Fork 0
mirror of https://github.com/corda/corda.git synced 2024-12-19 13:08:04 +00:00
Code Issues Actions 2 Packages Projects Releases Wiki Activity
382d65fbb1
corda/docs/source/getting-set-up.rst
Joel Dudley 98117392db
Stray full-stop
2018-07-12 17:52:16 +01:00

5.0 KiB
Raw Blame History

Getting set up

Software requirements

Corda uses industry-standard tools:

  • Oracle JDK 8 JVM - minimum supported version 8u171
  • IntelliJ IDEA - supported versions 2017.x and 2018.x (with Kotlin plugin version )
  • Git

We also use Gradle and Kotlin, but you do not need to install them. A standalone Gradle wrapper is provided, and it will download the correct version of Kotlin.

Please note:

  • Corda runs in a JVM. JVM implementations other than Oracle JDK 8 are not actively supported. However, if you do choose to use OpenJDK, you will also need to install OpenJFX
  • Applications on Corda (CorDapps) can be written in any language targeting the JVM. However, Corda itself and most of the samples are written in Kotlin. Kotlin is an official Android language, and you can read more about why Kotlin is a strong successor to Java here. If you're unfamiliar with Kotlin, there is an official getting started guide, and a series of Kotlin Koans
  • IntelliJ IDEA is recommended due to the strength of its Kotlin integration

Following these software recommendations will minimize the number of errors you encounter, and make it easier for others to provide support. However, if you do use other tools, we'd be interested to hear about any issues that arise.

Set-up instructions

The instructions below will allow you to set up your development environment for running Corda and writing CorDapps. If you have any issues, please reach out on Stack Overflow or via our Slack channels.

The set-up instructions are available for the following platforms:

Windows

Warning

If you are using a Mac machine, please follow the mac-label instructions instead.

Java

  1. Visit http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html
  2. Scroll down to "Java SE Development Kit 8uXXX" (where "XXX" is the latest minor version number)
  3. Toggle "Accept License Agreement"
  4. Click the download link for jdk-8uXXX-windows-x64.exe (where "XXX" is the latest minor version number)
  5. Download and run the executable to install Java (use the default settings)
  6. Add Java to the PATH environment variable by following the instructions at https://docs.oracle.com/javase/7/docs/webnotes/install/windows/jdk-installation-windows.html#path
  7. Open a new command prompt and run java -version to test that Java is installed correctly

Git

  1. Visit https://git-scm.com/download/win
  2. Click the "64-bit Git for Windows Setup" download link.
  3. Download and run the executable to install Git (use the default settings)
  4. Open a new command prompt and type git --version to test that git is installed correctly

IntelliJ

  1. Visit https://www.jetbrains.com/idea/download/download-thanks.html?code=IIC
  2. Download and run the executable to install IntelliJ Community Edition (use the default settings)
  3. Ensure the Kotlin plugin in Intellij is updated to version

Mac

Warning

If you are using a Windows machine, please follow the windows-label instructions instead.

Java

  1. Visit http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html
  2. Scroll down to "Java SE Development Kit 8uXXX" (where "XXX" is the latest minor version number)
  3. Toggle "Accept License Agreement"
  4. Click the download link for jdk-8uXXX-macosx-x64.dmg (where "XXX" is the latest minor version number)
  5. Download and run the executable to install Java (use the default settings)
  6. Open a new terminal window and run java -version to test that Java is installed correctly

IntelliJ

  1. Visit https://www.jetbrains.com/idea/download/download-thanks.html?platform=mac&code=IIC
  2. Download and run the executable to install IntelliJ Community Edition (use the default settings)
  3. Ensure the Kotlin plugin in Intellij is updated to version

Next steps

First, run the example CorDapp <tutorial-cordapp>.

Next, read through the Corda Key Concepts <key-concepts> to understand how Corda works.

By then, you'll be ready to start writing your own CorDapps. Learn how to do this in the Hello, World tutorial <hello-world-introduction>. You may want to refer to the API documentation <corda-api>, the flow cookbook <flow-cookbook> and the samples along the way.

If you encounter any issues, please ask on Stack Overflow or via our Slack channels.