CONTRIBUTING.md

Azure Toolkit for Rider

The main project is located in the PluginsAndFeatures/azure-toolkit-for-rider. All changes to the Utils and PluginsAndFeatures/azure-toolkit-for-intellij folders must be implemented in the base repository.

Prerequisites

• Install Corretto JDK 8
• Install Corretto JDK 17

Windows

• If you receive errors related to exit code -1073741515 during the Utils project installation, make sure to install Visual Studio 2010 C++ Redistributable.

Building

• Using JDK 8, Clone and Build azure-maven-plugins/azure-toolkit-libs first. Azure Toolkit for Intellij doesn't depend on our maven plugins, but they share some code together.

  $ git clone https://github.com/microsoft/azure-maven-plugins.git
  $ cd azure-maven-plugins
  $ ./mvnw clean install -f azure-toolkit-libs/pom.xml
  

• Clone the repository with HTTPS or SSH:

  $ git clone https://github.com/JetBrains/azure-tools-for-intellij.git
  $ cd azure-tools-for-intellij
  

• Using JDK 17, run the following command under the project base path (If you have problems, make sure JAVA_HOME environment variable points to <JDK17>/bin):

  $ ./mvnw clean install -DskipTests -f Utils/pom.xml
  

• Using JDK 17, run Build Plugin run configuration or use Gradle to build the plugin

  $ ./gradlew -b PluginsAndFeatures/azure-toolkit-for-rider/build.gradle buildPlugin
  

  You can find the outputs under PluginsAndFeatures/azure-toolkit-for-rider/build/distributions

Run/Debug

• Open IntelliJ, open PluginsAndFeatures/azure-toolkit-for-rider.
• Run/Debug the plugin by using Run Plugin run configuration.