<liclass="toctree-l3"><aclass="reference internal"href="#unable-to-make-the-module-related-gradle-configuration-was-not-found-please-re-import-the-gradle-project-and-try-again">“Unable to make the module: related gradle configuration was not found. Please, re-import the Gradle project and try again”</a></li>
<p>When you clone the corda or cordapp-template repos, they will default to the master branch. The master branch is being continuously developed upon, and its features may not align with the state of Corda as described in the docs. Additionally, the master branch of the CorDapp template may break in response to changes in the main corda repo.</p>
<p>When developing on Corda, you should always check out the latest milestone (i.e. stable) branch instead. For example, to check out milestone 0, you’d run <codeclass="docutils literal"><spanclass="pre">git</span><spanclass="pre">checkout</span><spanclass="pre">release-M0</span></code>.</p>
<h2>Java issues<aclass="headerlink"href="#java-issues"title="Permalink to this headline">¶</a></h2>
<divclass="section"id="outdated-non-oracle-jdks">
<h3>Outdated/non-Oracle JDKs<aclass="headerlink"href="#outdated-non-oracle-jdks"title="Permalink to this headline">¶</a></h3>
<p>Many users have faced issues when running versions of Java that are either outdated, or are produced by organisations other than Oracle (e.g. OpenJDK). The errors generated by these issues will not always clearly point to the JDK as the cause. If in doubt, check your JDK version by following the instructions <aclass="reference external"href="https://java.com/en/download/help/version_manual.xml">here</a>. You can download the latest version of Oracle’s JDK <aclass="reference external"href="http://www.oracle.com/technetwork/java/javase/downloads/index.html">here</a>.</p>
<p>JavaFX is not bundled with OpenJDK. If you are using OpenJDK and get an ‘Unresolved reference: javafx’ error, this means that you need to install OpenJFX.</p>
<p>If you have APT installed and OpenJFX is part of your Unix distribution’s package list, you can do this by running <codeclass="docutils literal"><spanclass="pre">sudo</span><spanclass="pre">apt</span><spanclass="pre">install</span><spanclass="pre">openjfx</span></code>, and possibly <codeclass="docutils literal"><spanclass="pre">sudo</span><spanclass="pre">apt</span><spanclass="pre">install</span><spanclass="pre">libopenjfx-jav</span></code>. Other users will want to refer to the guide <aclass="reference external"href="https://wiki.openjdk.java.net/display/OpenJFX/Building+OpenJFX">here</a>, or to the list of Community Builds <aclass="reference external"href="https://wiki.openjdk.java.net/display/OpenJFX/Community+Builds">here</a>.</p>
<h3>No source files are present<aclass="headerlink"href="#no-source-files-are-present"title="Permalink to this headline">¶</a></h3>
<p>When opening a project in IDEA for the first time, you will need to build the project. You should see “Unlinked Gradle project?”
in a pop-up window in the top-right corner or in a popup alert window. It will also appear in the “Event Log” window which can be
opened by clicking on “Event Log” at the bottom right of the IDEA window. Find one of these links and click on “Import Gradle Project”.</p>
<p>Wait for it to download the dependencies. You may then see another popup titled “Unindexed remote maven repositories found.” This won’t affect Corda,
so you can choose to leave them unindexed.</p>
<p>If still have problems, the JetBrains website has more information on <aclass="reference external"href="https://www.jetbrains.com/help/idea/2016.2/working-with-gradle-projects.html">here</a>.</p>
<p>If you opened the Corda project by clicking “Import Project” on the IDEA splash screen rather than clicking “Open”, a bug
in IDEA will cause it to wipe and recreate the <codeclass="docutils literal"><spanclass="pre">.idea</span></code> directory where the run configurations are stored. The fix is
simple and doesn’t require you to re-import the project: just undelete the files! You can do that by either:</p>
<li>Running <codeclass="docutils literal"><spanclass="pre">git</span><spanclass="pre">checkout</span><spanclass="pre">.idea/runConfigurations</span></code> to redownload the files.</li>
<li>Using the “Version Control” pane in IDEA to undelete the files via the GUI.</li>
<h3>IDEA complains about lack of an SDK<aclass="headerlink"href="#idea-complains-about-lack-of-an-sdk"title="Permalink to this headline">¶</a></h3>
<p>If IDEA refuses to open a project because an SDK has not been selected, you may need to fix the project structure. Do this by following <aclass="reference external"href="https://www.jetbrains.com/help/idea/2016.2/configuring-global-project-and-module-sdks.html">these instructions</a>. The correct JDK is often found on a path such as <codeclass="docutils literal"><spanclass="pre">jdk1.8.0_xx…/Contents/Home</span></code>. Ensure that you have the Project language level set at 8.</p>
<p>If you are having trouble selecting the correct JDK, the JetBrains website provides the <aclass="reference external"href="https://intellij-support.jetbrains.com/hc/en-us/articles/206544879-Selecting-the-JDK-version-the-IDE-will-run-under">following guidelines</a>.</p>
<h3>Kotlin plugin<aclass="headerlink"href="#kotlin-plugin"title="Permalink to this headline">¶</a></h3>
<p>There are two ways to configure Kotlin in IDEA:</p>
<olclass="arabic simple">
<li>Via the initial project opening screen, by using the <codeclass="docutils literal"><spanclass="pre">Configure</span><spanclass="pre">></span><spanclass="pre">Plugins</span></code> tab.</li>
<li>From an open IDEA project, by clicking <codeclass="docutils literal"><spanclass="pre">IDEA</span><spanclass="pre">-></span><spanclass="pre">Preferences</span><spanclass="pre">...</span></code> (on OS X) or <codeclass="docutils literal"><spanclass="pre">File</span><spanclass="pre">-></span><spanclass="pre">Settings</span></code> (on Windows). Select the Plugins bar to confirm that Kotlin is installed and up-to-date.</li>
</ol>
<p>If you are still having trouble installing Kotlin, first try upgrading the Kotlin plugin. At the time of writing, you can
identify the latest version of the Kotlin plugin on <aclass="reference external"href="https://plugins.jetbrains.com/plugin/6954">this page</a>.</p>
<h3>“Unable to make the module: related gradle configuration was not found. Please, re-import the Gradle project and try again”<aclass="headerlink"href="#unable-to-make-the-module-related-gradle-configuration-was-not-found-please-re-import-the-gradle-project-and-try-again"title="Permalink to this headline">¶</a></h3>
<p>This can usually be solved by updating IDEA. Check that you have the latest version <aclass="reference external"href="https://www.jetbrains.com/idea/download/">here</a>.</p>
<h2>Other common issues<aclass="headerlink"href="#other-common-issues"title="Permalink to this headline">¶</a></h2>
<divclass="section"id="xterm-command-not-found">
<h3>“xterm: command not found”<aclass="headerlink"href="#xterm-command-not-found"title="Permalink to this headline">¶</a></h3>
<p>On some machines, running the samples requires xterm. You can download it <aclass="reference external"href="http://invisible-island.net/xterm/#download">here</a>.</p>
Built with <ahref="http://sphinx-doc.org/">Sphinx</a> using a <ahref="https://github.com/snide/sphinx_rtd_theme">theme</a> provided by <ahref="https://readthedocs.org">Read the Docs</a>.
